Examples of menu entries

Example:

<MenuItem Header="_File">

   <l:ShellMenuItem Header="New Article..." CommandParameter="ArticleNewDlg">

</MenuItem>

Explanation:

The only three variable parts are the drop-down menu name ("_File"), the option name ("New") and the system function ("ArticleNewDlg") that gets called when you click the menu command. It is expected that the system function is defined in the appropriate add-in (system or custom). If the specified name is not found in any add-in, or the  current context is not the one where the option is to be enabled, the menu command will be dimmed.

Example:

<l:ShellMenuItem Header="_File">

  <l:ShellMenuItem Header="New Article..." CommandParameter="ArticleNewDlg">

    <l:ShellMenuItem.ToolTip>Create a new article</l:ShellMenuItem.ToolTip>

  </l:ShellMenuItem>

Explanation:

The only three variable parts are the drop-down menu name ("_File"), the option name ("New") and the system function ("ArticleNewDlg") that gets called when you click the menu command. It is expected that the system function is defined in the appropriate add-in (system or custom). If the specified name is not found in any add-in, or the  current context is not the one where the option is to be enabled, the menu command will be dimmed. The tooltip appears when you hover your mouse over menu command.

Example:

<l:ShellMenuItem Header="_File">

 <l:ShellMenuItem Header="New Article..." CommandParameter="ArticleNewDlg">

   <l:ShellMenuItem.ToolTip>Create a new article</l:ShellMenuItem.ToolTip>

  </l:ShellMenuItem>

  <l:ShellMenuItem Header="Article by Template..." CommandParameter="ArticleNewTemplateDlg"/>

  <Separator/>

  <l:ShellMenuItem Header="New Assignment..." CommandParameter="ArticleNewAssignmentDlg"/>

...

Explanation:

The separator is to be added in its own line, as <Separator/>.

Example:

<l:ShellMenuItem Header="More...">

  <l:ShellMenuItem Header="Selection to article..." CommandParameter="NotImplemented"/>

  <l:ShellMenuItem Header="Selection to new article..." CommandParameter="NotImplemented"/>

  <Separator/>

  <l:ShellMenuItem Header="As Auto-text" CommandParameter="NotImplemented"/>

 </l:ShellMenuItem>

Explanation:

A nested menu is simply added as a <MenuItem Header="AAAA"> that has no commands, and where AAAA is the name of the option.

Example:

<l:ShellMenuItem Header="Open Recent Articles">

  <l:ShellDynamicMenuSeparator 

   ItemsSource="{Binding Path=(l:ShellUI.Instance).MostRecentlyUsed.FilteredItems, 

   RelativeSource={RelativeSource AncestorType={x:Type l:ShellWindow}}}"/>

</l:ShellMenuItem>

Note

The higlighted line is broken in two parts for better readability. Should you want to paste it in your xxx_TabItems.xml, make sure to join it!

Explanation:

A recent items list is added through the syntax above.

Example:

<l:ShellMenuItem Header="Get 1" CommandParameter="GetSaveGet" Parameters="1"/>

Note

Here qualify only scripts with only one string type parameter - script with more than one parameter, or script with non-string parameters cannot be called in this way.

Example:

<menu name="Planning">

  <menuItem 

    text="New Task" 

    iconUrl="do.ashx?Cmd=Icon&amp;Name=t_task&amp;Size=16&amp;Default=t" navigateUrl="javascript:this.menuWebPart.showDialog('WFForm.aspx?wf=newTask&amp;autoCloseMode\=2' ,null,870,650);" />

</menuItem>

Explanation:

The only three variable parts are the drop-down menu name ("Planning"), the option name ("New Task") and the argument of iconURL.

Example:

<menu name="Planning">

  <menuItem text="New" iconUrl="do.ashx?Cmd=Icon&amp;Name=tlb_NewForm&amp;Size=16&amp;Default=t">

    <menuItem text="Task" iconUrl="do.ashx?Cmd=Icon&amp;Name=t_task&amp;Size=16&amp;Default=t" navigateUrl="javascript:this.menuWebPart.showDialog('WFForm.aspx?wf=newTask&amp;autoCloseMode\=2' ,null,870,650);" />

    <menuItem text="Task copy" iconUrl="do.ashx?Cmd=Icon&amp;Name=t_task&amp;Size=16&amp;Default=t" navigateUrl="javascript:this.menuWebPart.showDialog('WFForm.aspx?wf=newTask&amp;autoCloseMode\=2&amp;Ids='+this.menuWebPart.selectedIdList() ,null,820,650);" enable="One" />

    <menuItem text="Upload iCalendar files" iconUrl="do.ashx?Cmd=Icon&amp;Name=tlb_upload&amp;Size=16" navigateUrl="javascript:this.menuWebPart.showDialog('WFForm.aspx?wf=uploadICal&amp;pars=type:task',null,600,400);"/>

  </menuItem>

Explanation:

A nested menu is simply added as a <MenuItem text="AAAA"> that has no navigateUrl property, and where AAAA is the name of the option.