blob: bd83de5923ed3cdf6271e2878c0e5cfaaa3ad964 [file] [log] [blame]
<html xmlns:v="urn:schemas-microsoft-com:vml"
xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:w="urn:schemas-microsoft-com:office:word"
xmlns:st1="urn:schemas-microsoft-com:office:smarttags"
xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
<!--[if !mso]>
<style>
v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style>
<![endif]-->
<title>Developer’s Guide to Command Framework</title>
<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
name="place"/>
<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
name="City"/>
<!--[if gte mso 9]><xml>
<o:DocumentProperties>
<o:Author>RX</o:Author>
<o:LastAuthor>etworkow</o:LastAuthor>
<o:Revision>2</o:Revision>
<o:TotalTime>23</o:TotalTime>
<o:Created>2005-05-11T15:30:00Z</o:Created>
<o:LastSaved>2005-05-11T15:30:00Z</o:LastSaved>
<o:Pages>1</o:Pages>
<o:Words>465</o:Words>
<o:Characters>2651</o:Characters>
<o:Lines>22</o:Lines>
<o:Paragraphs>6</o:Paragraphs>
<o:CharactersWithSpaces>3110</o:CharactersWithSpaces>
<o:Version>10.4219</o:Version>
</o:DocumentProperties>
</xml><![endif]--><!--[if gte mso 9]><xml>
<w:WordDocument>
<w:SpellingState>Clean</w:SpellingState>
<w:GrammarState>Clean</w:GrammarState>
<w:Compatibility>
<w:BreakWrappedTables/>
<w:SnapToGridInCell/>
<w:WrapTextWithPunct/>
<w:UseAsianBreakRules/>
</w:Compatibility>
<w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
</w:WordDocument>
</xml><![endif]--><!--[if !mso]><object
classid="clsid:38481807-CA0E-42D2-BF39-B33AF135CC4D" id=ieooui></object>
<style>
st1\:*{behavior:url(#ieooui) }
</style>
<![endif]-->
<style>
<!--
/* Font Definitions */
@font-face
{font-family:Wingdings;
panose-1:5 0 0 0 0 0 0 0 0 0;
mso-font-charset:2;
mso-generic-font-family:auto;
mso-font-pitch:variable;
mso-font-signature:0 268435456 0 0 -2147483648 0;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{mso-style-parent:"";
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
a:link, span.MsoHyperlink
{color:blue;
text-decoration:underline;
text-underline:single;}
a:visited, span.MsoHyperlinkFollowed
{color:purple;
text-decoration:underline;
text-underline:single;}
span.SpellE
{mso-style-name:"";
mso-spl-e:yes;}
span.GramE
{mso-style-name:"";
mso-gram-e:yes;}
@page Section1
{size:8.5in 11.0in;
margin:1.5in .5in 1.5in .5in;
mso-header-margin:.5in;
mso-footer-margin:.5in;
mso-paper-source:0;}
div.Section1
{page:Section1;}
/* List Definitions */
@list l0
{mso-list-id:60370936;
mso-list-type:hybrid;
mso-list-template-ids:-1429182842 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l0:level1
{mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1
{mso-list-id:625896194;
mso-list-type:hybrid;
mso-list-template-ids:-1039738000 1181095032 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l1:level1
{mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level2
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2
{mso-list-id:987131563;
mso-list-template-ids:-978054330;}
@list l2:level1
{mso-level-start-at:6;
mso-level-text:%1;
mso-level-tab-stop:.25in;
mso-level-number-position:left;
margin-left:.25in;
text-indent:-.25in;
mso-ansi-font-weight:normal;}
@list l2:level2
{mso-level-text:"%1\.%2";
mso-level-tab-stop:.75in;
mso-level-number-position:left;
margin-left:.75in;
text-indent:-.25in;
mso-ansi-font-weight:normal;}
@list l2:level3
{mso-level-text:"%1\.%2\.%3";
mso-level-tab-stop:1.5in;
mso-level-number-position:left;
text-indent:-.5in;
mso-ansi-font-weight:normal;}
@list l2:level4
{mso-level-text:"%1\.%2\.%3\.%4";
mso-level-tab-stop:2.0in;
mso-level-number-position:left;
text-indent:-.5in;
mso-ansi-font-weight:normal;}
@list l2:level5
{mso-level-text:"%1\.%2\.%3\.%4\.%5";
mso-level-tab-stop:2.75in;
mso-level-number-position:left;
margin-left:2.75in;
text-indent:-.75in;
mso-ansi-font-weight:normal;}
@list l2:level6
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6";
mso-level-tab-stop:3.25in;
mso-level-number-position:left;
margin-left:3.25in;
text-indent:-.75in;
mso-ansi-font-weight:normal;}
@list l2:level7
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7";
mso-level-tab-stop:4.0in;
mso-level-number-position:left;
margin-left:4.0in;
text-indent:-1.0in;
mso-ansi-font-weight:normal;}
@list l2:level8
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8";
mso-level-tab-stop:4.5in;
mso-level-number-position:left;
margin-left:4.5in;
text-indent:-1.0in;
mso-ansi-font-weight:normal;}
@list l2:level9
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9";
mso-level-tab-stop:5.25in;
mso-level-number-position:left;
margin-left:5.25in;
text-indent:-1.25in;
mso-ansi-font-weight:normal;}
@list l3
{mso-list-id:994991983;
mso-list-template-ids:-18448758;}
@list l3:level1
{mso-level-start-at:6;
mso-level-text:%1;
mso-level-tab-stop:.25in;
mso-level-number-position:left;
margin-left:.25in;
text-indent:-.25in;}
@list l3:level2
{mso-level-text:"%1\.%2";
mso-level-tab-stop:.5in;
mso-level-number-position:left;
margin-left:.5in;
text-indent:-.25in;}
@list l3:level3
{mso-level-text:"%1\.%2\.%3";
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
margin-left:1.0in;
text-indent:-.5in;}
@list l3:level4
{mso-level-text:"%1\.%2\.%3\.%4";
mso-level-tab-stop:1.25in;
mso-level-number-position:left;
margin-left:1.25in;
text-indent:-.5in;}
@list l3:level5
{mso-level-text:"%1\.%2\.%3\.%4\.%5";
mso-level-tab-stop:1.5in;
mso-level-number-position:left;
margin-left:1.5in;
text-indent:-.5in;}
@list l3:level6
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6";
mso-level-tab-stop:2.0in;
mso-level-number-position:left;
margin-left:2.0in;
text-indent:-.75in;}
@list l3:level7
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7";
mso-level-tab-stop:2.25in;
mso-level-number-position:left;
margin-left:2.25in;
text-indent:-.75in;}
@list l3:level8
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8";
mso-level-tab-stop:2.75in;
mso-level-number-position:left;
margin-left:2.75in;
text-indent:-1.0in;}
@list l3:level9
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9";
mso-level-tab-stop:3.0in;
mso-level-number-position:left;
margin-left:3.0in;
text-indent:-1.0in;}
@list l4
{mso-list-id:1033578378;
mso-list-template-ids:1270907530;}
@list l4:level1
{mso-level-start-at:3;
mso-level-text:%1;
mso-level-tab-stop:.25in;
mso-level-number-position:left;
margin-left:.25in;
text-indent:-.25in;}
@list l4:level2
{mso-level-text:"%1\.%2";
mso-level-tab-stop:.5in;
mso-level-number-position:left;
margin-left:.5in;
text-indent:-.25in;}
@list l4:level3
{mso-level-text:"%1\.%2\.%3";
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
margin-left:1.0in;
text-indent:-.5in;}
@list l4:level4
{mso-level-text:"%1\.%2\.%3\.%4";
mso-level-tab-stop:1.25in;
mso-level-number-position:left;
margin-left:1.25in;
text-indent:-.5in;}
@list l4:level5
{mso-level-text:"%1\.%2\.%3\.%4\.%5";
mso-level-tab-stop:1.5in;
mso-level-number-position:left;
margin-left:1.5in;
text-indent:-.5in;}
@list l4:level6
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6";
mso-level-tab-stop:2.0in;
mso-level-number-position:left;
margin-left:2.0in;
text-indent:-.75in;}
@list l4:level7
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7";
mso-level-tab-stop:2.25in;
mso-level-number-position:left;
margin-left:2.25in;
text-indent:-.75in;}
@list l4:level8
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8";
mso-level-tab-stop:2.75in;
mso-level-number-position:left;
margin-left:2.75in;
text-indent:-1.0in;}
@list l4:level9
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9";
mso-level-tab-stop:3.0in;
mso-level-number-position:left;
margin-left:3.0in;
text-indent:-1.0in;}
@list l5
{mso-list-id:1041171908;
mso-list-template-ids:-1382923156;}
@list l5:level1
{mso-level-start-at:6;
mso-level-text:%1;
mso-level-tab-stop:.25in;
mso-level-number-position:left;
margin-left:.25in;
text-indent:-.25in;}
@list l5:level2
{mso-level-text:"%1\.%2";
mso-level-tab-stop:.25in;
mso-level-number-position:left;
margin-left:.25in;
text-indent:-.25in;}
@list l5:level3
{mso-level-text:"%1\.%2\.%3";
mso-level-tab-stop:.5in;
mso-level-number-position:left;
margin-left:.5in;
text-indent:-.5in;}
@list l5:level4
{mso-level-text:"%1\.%2\.%3\.%4";
mso-level-tab-stop:.5in;
mso-level-number-position:left;
margin-left:.5in;
text-indent:-.5in;}
@list l5:level5
{mso-level-text:"%1\.%2\.%3\.%4\.%5";
mso-level-tab-stop:.75in;
mso-level-number-position:left;
margin-left:.75in;
text-indent:-.75in;}
@list l5:level6
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6";
mso-level-tab-stop:.75in;
mso-level-number-position:left;
margin-left:.75in;
text-indent:-.75in;}
@list l5:level7
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7";
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
margin-left:1.0in;
text-indent:-1.0in;}
@list l5:level8
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8";
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
margin-left:1.0in;
text-indent:-1.0in;}
@list l5:level9
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9";
mso-level-tab-stop:1.25in;
mso-level-number-position:left;
margin-left:1.25in;
text-indent:-1.25in;}
@list l6
{mso-list-id:1050835654;
mso-list-type:hybrid;
mso-list-template-ids:768272942 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l6:level1
{mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l7
{mso-list-id:1245341706;
mso-list-template-ids:689196332;}
@list l7:level1
{mso-level-start-at:5;
mso-level-text:%1;
mso-level-tab-stop:.25in;
mso-level-number-position:left;
margin-left:.25in;
text-indent:-.25in;}
@list l7:level2
{mso-level-text:"%1\.%2";
mso-level-tab-stop:.25in;
mso-level-number-position:left;
margin-left:.25in;
text-indent:-.25in;}
@list l7:level3
{mso-level-text:"%1\.%2\.%3";
mso-level-tab-stop:.5in;
mso-level-number-position:left;
margin-left:.5in;
text-indent:-.5in;}
@list l7:level4
{mso-level-text:"%1\.%2\.%3\.%4";
mso-level-tab-stop:.5in;
mso-level-number-position:left;
margin-left:.5in;
text-indent:-.5in;}
@list l7:level5
{mso-level-text:"%1\.%2\.%3\.%4\.%5";
mso-level-tab-stop:.75in;
mso-level-number-position:left;
margin-left:.75in;
text-indent:-.75in;}
@list l7:level6
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6";
mso-level-tab-stop:.75in;
mso-level-number-position:left;
margin-left:.75in;
text-indent:-.75in;}
@list l7:level7
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7";
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
margin-left:1.0in;
text-indent:-1.0in;}
@list l7:level8
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8";
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
margin-left:1.0in;
text-indent:-1.0in;}
@list l7:level9
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9";
mso-level-tab-stop:1.25in;
mso-level-number-position:left;
margin-left:1.25in;
text-indent:-1.25in;}
@list l8
{mso-list-id:1289237850;
mso-list-type:hybrid;
mso-list-template-ids:550820946 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l8:level1
{mso-level-start-at:3;
mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
font-family:Symbol;
mso-fareast-font-family:"Times New Roman";
mso-bidi-font-family:"Times New Roman";}
@list l9
{mso-list-id:1323046004;
mso-list-type:hybrid;
mso-list-template-ids:-1159296794 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l9:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
font-family:Symbol;
mso-fareast-font-family:"Times New Roman";
mso-bidi-font-family:"Times New Roman";}
@list l9:level2
{mso-level-number-format:bullet;
mso-level-text:o;
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;
font-family:"Courier New";}
@list l10
{mso-list-id:1602879840;
mso-list-template-ids:-810679102;}
@list l10:level1
{mso-level-start-at:9;
mso-level-text:%1;
mso-level-tab-stop:.25in;
mso-level-number-position:left;
margin-left:.25in;
text-indent:-.25in;}
@list l10:level2
{mso-level-text:"%1\.%2";
mso-level-tab-stop:.5in;
mso-level-number-position:left;
margin-left:.5in;
text-indent:-.25in;}
@list l10:level3
{mso-level-text:"%1\.%2\.%3";
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
margin-left:1.0in;
text-indent:-.5in;}
@list l10:level4
{mso-level-text:"%1\.%2\.%3\.%4";
mso-level-tab-stop:1.25in;
mso-level-number-position:left;
margin-left:1.25in;
text-indent:-.5in;}
@list l10:level5
{mso-level-text:"%1\.%2\.%3\.%4\.%5";
mso-level-tab-stop:1.75in;
mso-level-number-position:left;
margin-left:1.75in;
text-indent:-.75in;}
@list l10:level6
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6";
mso-level-tab-stop:2.0in;
mso-level-number-position:left;
margin-left:2.0in;
text-indent:-.75in;}
@list l10:level7
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7";
mso-level-tab-stop:2.5in;
mso-level-number-position:left;
margin-left:2.5in;
text-indent:-1.0in;}
@list l10:level8
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8";
mso-level-tab-stop:2.75in;
mso-level-number-position:left;
margin-left:2.75in;
text-indent:-1.0in;}
@list l10:level9
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9";
mso-level-tab-stop:3.25in;
mso-level-number-position:left;
margin-left:3.25in;
text-indent:-1.25in;}
@list l11
{mso-list-id:1880581603;
mso-list-template-ids:-1162060388;}
@list l11:level1
{mso-level-start-at:6;
mso-level-text:%1;
mso-level-tab-stop:.25in;
mso-level-number-position:left;
margin-left:.25in;
text-indent:-.25in;}
@list l11:level2
{mso-level-start-at:9;
mso-level-text:"%1\.%2";
mso-level-tab-stop:.5in;
mso-level-number-position:left;
margin-left:.5in;
text-indent:-.25in;}
@list l11:level3
{mso-level-text:"%1\.%2\.%3";
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
margin-left:1.0in;
text-indent:-.5in;}
@list l11:level4
{mso-level-text:"%1\.%2\.%3\.%4";
mso-level-tab-stop:1.25in;
mso-level-number-position:left;
margin-left:1.25in;
text-indent:-.5in;}
@list l11:level5
{mso-level-text:"%1\.%2\.%3\.%4\.%5";
mso-level-tab-stop:1.5in;
mso-level-number-position:left;
margin-left:1.5in;
text-indent:-.5in;}
@list l11:level6
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6";
mso-level-tab-stop:2.0in;
mso-level-number-position:left;
margin-left:2.0in;
text-indent:-.75in;}
@list l11:level7
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7";
mso-level-tab-stop:2.25in;
mso-level-number-position:left;
margin-left:2.25in;
text-indent:-.75in;}
@list l11:level8
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8";
mso-level-tab-stop:2.75in;
mso-level-number-position:left;
margin-left:2.75in;
text-indent:-1.0in;}
@list l11:level9
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9";
mso-level-tab-stop:3.0in;
mso-level-number-position:left;
margin-left:3.0in;
text-indent:-1.0in;}
@list l12
{mso-list-id:1889950547;
mso-list-template-ids:-1819390410;}
@list l12:level1
{mso-level-start-at:5;
mso-level-text:%1;
mso-level-tab-stop:.25in;
mso-level-number-position:left;
margin-left:.25in;
text-indent:-.25in;}
@list l12:level2
{mso-level-text:"%1\.%2";
mso-level-tab-stop:.5in;
mso-level-number-position:left;
margin-left:.5in;
text-indent:-.25in;}
@list l12:level3
{mso-level-text:"%1\.%2\.%3";
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
margin-left:1.0in;
text-indent:-.5in;}
@list l12:level4
{mso-level-text:"%1\.%2\.%3\.%4";
mso-level-tab-stop:1.25in;
mso-level-number-position:left;
margin-left:1.25in;
text-indent:-.5in;}
@list l12:level5
{mso-level-text:"%1\.%2\.%3\.%4\.%5";
mso-level-tab-stop:1.75in;
mso-level-number-position:left;
margin-left:1.75in;
text-indent:-.75in;}
@list l12:level6
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6";
mso-level-tab-stop:2.0in;
mso-level-number-position:left;
margin-left:2.0in;
text-indent:-.75in;}
@list l12:level7
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7";
mso-level-tab-stop:2.5in;
mso-level-number-position:left;
margin-left:2.5in;
text-indent:-1.0in;}
@list l12:level8
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8";
mso-level-tab-stop:2.75in;
mso-level-number-position:left;
margin-left:2.75in;
text-indent:-1.0in;}
@list l12:level9
{mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9";
mso-level-tab-stop:3.25in;
mso-level-number-position:left;
margin-left:3.25in;
text-indent:-1.25in;}
@list l13
{mso-list-id:1970627370;
mso-list-type:hybrid;
mso-list-template-ids:-1434965460 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l13:level1
{mso-level-start-at:2;
mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
font-family:Symbol;
mso-fareast-font-family:"Times New Roman";
mso-bidi-font-family:"Times New Roman";}
@list l13:level2
{mso-level-number-format:bullet;
mso-level-text:o;
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;
font-family:"Courier New";}
@list l14
{mso-list-id:2073507227;
mso-list-type:hybrid;
mso-list-template-ids:130218376 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l14:level1
{mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;}
ol
{margin-bottom:0in;}
ul
{margin-bottom:0in;}
-->
</style>
<!--[if gte mso 10]>
<style>
/* Style Definitions */
table.MsoNormalTable
{mso-style-name:"Table Normal";
mso-tstyle-rowband-size:0;
mso-tstyle-colband-size:0;
mso-style-noshow:yes;
mso-style-parent:"";
mso-padding-alt:0in 5.4pt 0in 5.4pt;
mso-para-margin:0in;
mso-para-margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";}
</style>
<![endif]-->
</head>
<body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'>
<div class=Section1>
<p class=MsoNormal style='margin-left:.25in'><b style='mso-bidi-font-weight:
normal'><span style='font-size:14.0pt'><!--[if gte vml 1]><v:shapetype id="_x0000_t75"
coordsize="21600,21600" o:spt="75" o:preferrelative="t" path="m@4@5l@4@11@9@11@9@5xe"
filled="f" stroked="f">
<v:stroke joinstyle="miter"/>
<v:formulas>
<v:f eqn="if lineDrawn pixelLineWidth 0"/>
<v:f eqn="sum @0 1 0"/>
<v:f eqn="sum 0 0 @1"/>
<v:f eqn="prod @2 1 2"/>
<v:f eqn="prod @3 21600 pixelWidth"/>
<v:f eqn="prod @3 21600 pixelHeight"/>
<v:f eqn="sum @0 0 1"/>
<v:f eqn="prod @6 1 2"/>
<v:f eqn="prod @7 21600 pixelWidth"/>
<v:f eqn="sum @8 21600 0"/>
<v:f eqn="prod @7 21600 pixelHeight"/>
<v:f eqn="sum @10 21600 0"/>
</v:formulas>
<img
src="../../logo.gif" v:shapes="_x0000_i1025"><![endif]><o:p></o:p></span></b></p>
<p class=MsoNormal style='margin-left:.25in'><b style='mso-bidi-font-weight:
normal'><span style='font-size:14.0pt'><o:p>&nbsp;</o:p></span></b></p>
<p class=MsoNormal style='margin-left:.25in'><a name=top><b style='mso-bidi-font-weight:
normal'><span style='font-size:16.0pt'>Developer Guide to Contribution Item Service<o:p></o:p></span></b></a></p>
<span style='mso-bookmark:top'></span>
<p class=MsoNormal style='margin-left:.25in'><o:p>&nbsp;</o:p></p>
<p class=MsoNormal style='margin-left:.25in'><b style='mso-bidi-font-weight:
normal'><span style='font-size:14.0pt'>Contents<o:p></o:p></span></b></p>
<p class=MsoNormal><b style='mso-bidi-font-weight:normal'><span
style='font-size:16.0pt'><o:p>&nbsp;</o:p></span></b></p>
<ol style='margin-top:0in' start=1 type=1>
<li class=MsoNormal style='mso-list:l1 level1 lfo2;tab-stops:list .5in'><a
href="#introduction">Introduction</a></li>
<li class=MsoNormal style='mso-list:l1 level1 lfo2;tab-stops:list .5in'><a
href="#prerequisites">Pre-requisites</a></li>
<li class=MsoNormal style='mso-list:l1 level1 lfo2;tab-stops:list .5in'><a
href="#concepts">Concepts</a></li>
<li class=MsoNormal style='mso-list:l1 level1 lfo2;tab-stops:list .5in'><a
href="#extension_points">Extension points</a><o:p></o:p></li>
<li class=MsoNormal style='mso-list:l1 level1 lfo2;tab-stops:list .5in'><a
href="#set_up">Set-up</a></li>
<li class=MsoNormal style='mso-list:l1 level1 lfo2;tab-stops:list .5in'><a
href="#use_cases">Use Cases</a></li>
</ol>
<p class=MsoNormal style='margin-left:.75in;text-indent:-.25in;mso-list:l2 level2 lfo15;
tab-stops:list .75in'><![if !supportLists]><span style='mso-list:Ignore'>6.1<span
style='font:7.0pt "Times New Roman"'>&nbsp; </span></span><![endif]><a
href="#contribute_new_context_menu">Contribute new context menu to Diagram
Editor using Contribution Item Service</a><o:p></o:p></p>
<ol style='margin-top:0in' start=7 type=1>
<li class=MsoNormal style='mso-list:l1 level1 lfo2;tab-stops:list .5in'><a
href="#conclusion">Summary</a><o:p></o:p></li>
</ol>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<ol style='margin-top:0in' start=1 type=1>
<li class=MsoNormal style='mso-list:l0 level1 lfo13;tab-stops:list .5in'><a
name=introduction><b style='mso-bidi-font-weight:normal'>Introduction<o:p></o:p></b></a></li>
</ol>
<span style='mso-bookmark:introduction'></span>
<p class=MsoNormal style='margin-left:.25in'><b style='mso-bidi-font-weight:
normal'><o:p>&nbsp;</o:p></b></p>
<p class=MsoNormal style='margin-left:.25in'>This document describes how to contribute
items to UI components using Contribution Item Service.</p>
<p class=MsoNormal style='margin-left:.25in'><st1:City><st1:place>GMF</st1:place></st1:City>
commands can be divided into two types:</p>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<p class=MsoNormal style='text-indent:.25in'>[<a href="#top"><span class=GramE>back</span>
to top</a>]</p>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<ol style='margin-top:0in' start=2 type=1>
<li class=MsoNormal style='mso-list:l0 level1 lfo13;tab-stops:list .5in'><a
name=prerequisites><b style='mso-bidi-font-weight:normal'>Pre-requisites<o:p></o:p></b></a></li>
</ol>
<span style='mso-bookmark:prerequisites'></span>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<ul style='margin-top:0in' type=disc>
<li class=MsoNormal style='mso-list:l9 level1 lfo1;tab-stops:list .5in'>Eclipse<o:p></o:p></li>
<ul style='margin-top:0in' type=circle>
<li class=MsoNormal style='mso-list:l9 level2 lfo1;tab-stops:list 1.0in'><i
style='mso-bidi-font-style:normal'>“<a
href="http://www.eclipse.org/articles/index.html">Eclipse Platform
Technical Overview</a>”,</i> by Object Technology International Inc.<o:p></o:p></li>
<li class=MsoNormal style='mso-list:l9 level2 lfo1;tab-stops:list 1.0in'><i
style='mso-bidi-font-style:normal'>“<a
href="http://www.eclipse.org/articles/index.html">Notes on Eclipse
Plug-in Architecture</a>”</i>, by Azad Bolour, Bolour Computing<o:p></o:p></li>
<li class=MsoNormal style='mso-list:l9 level2 lfo1;tab-stops:list 1.0in'><i
style='mso-bidi-font-style:normal'>“<a
href="http://www.eclipse.org/articles/index.html">How to Use the Eclipse
API</a>”</i>, by Jin des Rivieres, OTI</li>
<li class=MsoNormal style='mso-list:l9 level2 lfo1;tab-stops:list 1.0in'><i
style='mso-bidi-font-style:normal'>“<a
href="http://www.eclipse.org/articles/index.html">Contributing Actions to</a>
Eclipse” </i><o:p></o:p></li>
</ul>
</ul>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<p class=MsoNormal style='text-indent:.25in'>[<a href="#top"><span class=GramE>back</span>
to top</a>]</p>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<ol style='margin-top:0in' start=3 type=1>
<li class=MsoNormal style='mso-list:l0 level1 lfo13;tab-stops:list .5in'><a
name=concepts><b style='mso-bidi-font-weight:normal'>Concepts</b></a><b
style='mso-bidi-font-weight:normal'><o:p></o:p></b></li>
</ol>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<p class=MsoNormal style='margin-left:.25in'><b style='mso-bidi-font-weight:
normal'><i style='mso-bidi-font-style:normal'>Contribution</i></b> – extension,
new feature.</p>
<p class=MsoNormal style='margin-left:.25in'><b style='mso-bidi-font-weight:
normal'><i style='mso-bidi-font-style:normal'>Contribution item</i></b> –
contribution to a shared UI resource such as a menu or toolbar.<span
style='mso-spacerun:yes'>  </span>All contributions are managed by some
contribution manager.<span style='mso-spacerun:yes'>  </span>For example,
button contributed to a tool bar is referred to as a ‘contribution item’.<span
style='mso-spacerun:yes'>  </span>Menu contributed to a menu bar is <span
class=SpellE>refered</span> to as a contribution item.<span
style='mso-spacerun:yes'>  </span>Menu item contributed to a menu is referred
to as a contribution item.</p>
<p class=MsoNormal style='margin-left:.25in'><b style='mso-bidi-font-weight:
normal'><i style='mso-bidi-font-style:normal'>Contribution manager</i></b> –
organizes contribution to UI components, keeps track of a list of contribution
items.<span style='mso-spacerun:yes'>  </span>You can talk to a contribution
manager using <span class=SpellE><i style='mso-bidi-font-style:normal'>IContributionManager</i></span>
interface.<span style='mso-spacerun:yes'>  </span>Through <span class=SpellE><span
style='font-family:"Courier New"'>ContributionManager</span></span> you can add
new contribution, remove a contribution, retrieve a contribution, <span
class=GramE>contribute</span> new action.</p>
<p class=MsoNormal style='margin-left:.25in'><o:p>&nbsp;</o:p></p>
<p class=MsoNormal style='margin-left:.25in'>Also, please review the following
API documentation:</p>
<ul style='margin-top:0in' type=disc>
<li class=MsoNormal style='mso-list:l9 level1 lfo1;tab-stops:list .5in'><span
class=SpellE><span style='font-family:"Courier New"'>IContributionManager</span></span><span
style='font-family:"Courier New"'><o:p></o:p></span></li>
<li class=MsoNormal style='mso-list:l9 level1 lfo1;tab-stops:list .5in'><span
class=SpellE><span style='font-family:"Courier New"'>ContributionManager</span></span><span
style='font-family:"Courier New"'><o:p></o:p></span></li>
<li class=MsoNormal style='mso-list:l9 level1 lfo1;tab-stops:list .5in'><span
class=SpellE><span style='font-family:"Courier New"'>MenuManager</span></span><span
style='font-family:"Courier New"'><o:p></o:p></span></li>
<li class=MsoNormal style='mso-list:l9 level1 lfo1;tab-stops:list .5in'><span
class=SpellE><span style='font-family:"Courier New"'>ToolBarManager</span></span><span
style='font-family:"Courier New"'><o:p></o:p></span></li>
<li class=MsoNormal style='mso-list:l9 level1 lfo1;tab-stops:list .5in'><span
class=SpellE><span style='font-family:"Courier New"'>StatusLineManager</span></span><span
style='font-family:"Courier New"'><o:p></o:p></span></li>
</ul>
<p class=MsoNormal style='margin-left:.25in'><span style='font-family:"Courier New"'><o:p>&nbsp;</o:p></span></p>
<p class=MsoNormal style='text-indent:.25in'>[<a href="#top"><span class=GramE>back</span>
to top</a>]</p>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<ol style='margin-top:0in' start=4 type=1>
<li class=MsoNormal style='mso-list:l0 level1 lfo13;tab-stops:list .5in'><a
name="extension_points"><b style='mso-bidi-font-weight:normal'>Extension
points<o:p></o:p></b></a></li>
</ol>
<span style='mso-bookmark:extension_points'></span>
<p class=MsoNormal style='margin-left:.25in'><b style='mso-bidi-font-weight:
normal'><o:p>&nbsp;</o:p></b></p>
<p class=MsoNormal style='margin-left:.25in'><i style='mso-bidi-font-style:
normal'>org.eclipse.gmf.runtime.common.ui.services.action.contributionItemsProviders<o:p></o:p></i></p>
<p class=MsoNormal style='margin-left:.25in'><i style='mso-bidi-font-style:
normal'><o:p>&nbsp;</o:p></i></p>
<p class=MsoNormal style='text-indent:.25in'>[<a href="#top"><span class=GramE>back</span>
to top</a>]</p>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<ol style='margin-top:0in' start=5 type=1>
<li class=MsoNormal style='mso-list:l0 level1 lfo13;tab-stops:list .5in'><a
name="set_up"><b style='mso-bidi-font-weight:normal'>Set-up<o:p></o:p></b></a></li>
</ol>
<span style='mso-bookmark:set_up'></span>
<p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l12 level2 lfo12;
tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>5.1<span
style='font:7.0pt "Times New Roman"'>&nbsp; </span></span><![endif]>Create new
plug-in project.<o:p></o:p></p>
<p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l12 level2 lfo12;
tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>5.2<span
style='font:7.0pt "Times New Roman"'>&nbsp; </span></span><![endif]>Add <i
style='mso-bidi-font-style:normal'>org.eclipse.gmf.runtime.common.core</i> to a list of
dependencies of your plug-in.</p>
<p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l12 level2 lfo12;
tab-stops:list .5in'><![if !supportLists]><span style='mso-list:Ignore'>5.3<span
style='font:7.0pt "Times New Roman"'>&nbsp; </span></span><![endif]>Add <span
class=SpellE><i style='mso-bidi-font-style:normal'>org.eclipse.gmf.runtime.emf.common.ui.services</i></span>
to a list of dependencies of your plug-in.</p>
<p class=MsoNormal style='margin-left:.25in'><o:p>&nbsp;</o:p></p>
<p class=MsoNormal style='text-indent:.25in'>[<a href="#top"><span class=GramE>back</span>
to top</a>]</p>
<p class=MsoNormal><b style='mso-bidi-font-weight:normal'><o:p>&nbsp;</o:p></b></p>
<ol style='margin-top:0in' start=6 type=1>
<li class=MsoNormal style='mso-list:l0 level1 lfo13;tab-stops:list .5in'><a
name="use_cases"><b style='mso-bidi-font-weight:normal'>Use Cases<o:p></o:p></b></a></li>
</ol>
<span style='mso-bookmark:use_cases'></span>
<p class=MsoNormal style='margin-left:.25in'><b style='mso-bidi-font-weight:
normal'><o:p>&nbsp;</o:p></b></p>
<p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l3 level2 lfo9;
tab-stops:list .5in'><a name="contribute_new_context_menu"><![if !supportLists]><b
style='mso-bidi-font-weight:normal'><span style='mso-list:Ignore'>6.1<span
style='font:7.0pt "Times New Roman"'>&nbsp; </span></span></b><![endif]><b
style='mso-bidi-font-weight:normal'>Contribute new context menu to Diagram
Editor using Contribution Item Service<o:p></o:p></b></a></p>
<span style='mso-bookmark:contribute_new_context_menu'></span>
<p class=MsoNormal style='margin-left:1.0in;text-indent:-.5in;mso-list:l3 level3 lfo9;
tab-stops:list 1.0in'><![if !supportLists]><b style='mso-bidi-font-weight:normal'><span
style='mso-list:Ignore'>6.1.1<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></span></b><![endif]>Declare contribution to <span class=SpellE><span
style='font-family:"Courier New"'>contributionItemProvider</span></span>
extension point on <span class=SpellE><span style='font-family:"Courier New"'>plugin.xml</span></span>
of your plugin.<b style='mso-bidi-font-weight:normal'><o:p></o:p></b></p>
<p class=MsoNormal style='margin-left:1.0in;text-indent:-.5in;mso-list:l3 level3 lfo9;
tab-stops:list 1.0in'><![if !supportLists]><b style='mso-bidi-font-weight:normal'><span
style='mso-list:Ignore'>6.1.2<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></span></b><![endif]>Implement <span class=SpellE><span
style='font-family:"Courier New"'>IContributionItemProvider</span></span><b
style='mso-bidi-font-weight:normal'><o:p></o:p></b></p>
<p class=MsoNormal style='margin-left:1.0in;text-indent:-.5in;mso-list:l3 level3 lfo9;
tab-stops:list 1.0in'><![if !supportLists]><b style='mso-bidi-font-weight:normal'><span
style='mso-list:Ignore'>6.1.3<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></span></b><![endif]>Implement Action class.<b style='mso-bidi-font-weight:
normal'><o:p></o:p></b></p>
<p class=MsoNormal style='margin-left:1.0in;text-indent:-.5in;mso-list:l3 level3 lfo9;
tab-stops:list 1.0in'><![if !supportLists]><b style='mso-bidi-font-weight:normal'><span
style='mso-list:Ignore'>6.1.4<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></span></b><![endif]>Configure visibility criteria of your action.<b
style='mso-bidi-font-weight:normal'><o:p></o:p></b></p>
<p class=MsoNormal style='margin-left:1.0in;text-indent:-.5in;mso-list:l3 level3 lfo9;
tab-stops:list 1.0in'><![if !supportLists]><b style='mso-bidi-font-weight:normal'><span
style='mso-list:Ignore'>6.1.5<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></span></b><![endif]>Configure enablement criteria of your action.<b
style='mso-bidi-font-weight:normal'><o:p></o:p></b></p>
<p class=MsoNormal style='margin-left:1.0in;text-indent:-.5in;mso-list:l3 level3 lfo9;
tab-stops:list 1.0in'><![if !supportLists]><b style='mso-bidi-font-weight:normal'><span
style='mso-list:Ignore'>6.1.6<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></span></b><![endif]>Verify: run <span class=GramE>your</span> plug-in
and verify new context menu exists.<b style='mso-bidi-font-weight:normal'><o:p></o:p></b></p>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<p class=MsoNormal style='text-indent:.25in'>[<a href="#top"><span class=GramE>back</span>
to top</a>]</p>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<ol style='margin-top:0in' start=7 type=1>
<li class=MsoNormal style='mso-list:l0 level1 lfo13;tab-stops:list .5in'><a
name=conclusion><b style='mso-bidi-font-weight:normal'>Summary<o:p></o:p></b></a></li>
</ol>
<span style='mso-bookmark:conclusion'></span>
<p class=MsoNormal><o:p>&nbsp;</o:p></p>
<p class=MsoNormal style='margin-left:.25in'>This document gave described how
to contribute new context menu to <st1:City><st1:place>GMF</st1:place></st1:City>
editor using Contribution Item Service.</p>
<p class=MsoNormal style='margin-left:.25in'><o:p>&nbsp;</o:p></p>
<p class=MsoNormal style='text-indent:.25in'>[<a href="#top"><span class=GramE>back</span>
to top</a>]</p>
<p class=MsoNormal style='text-indent:.25in'><o:p>&nbsp;</o:p></p>
<br/>
<br/>
<hr/>
<P><a href="http://www.eclipse.org/legal/epl-v10.html">
Copyright (c) 2000,2005 IBM Corporation and others. All Rights Reserved.</a></P>
<p class=MsoNormal style='margin-left:.25in'><o:p>&nbsp;</o:p></p>
</div>
</body>
</html>