DataView.InsertActionMenuSeparator

Prototypes

void InsertActionMenuSeparator( String sExistingItem <, String sItem> )

Parameters

String sExistingItem
An existing menu item. The new item will be inserted after the existing item.

String sItem
An optional string that specifies the name and position of the new menu separator.

Remarks

This method inserts a new menu separator (a horizontal line) after an existing item on the action menu.

The items specified by sExistingItem and sItem must be on the same menu.

This method is equivalent to calling InsertActionMenuItem( sExistingItem, sItem, "" ). See the documentation for InsertActionMenuItem for a general discussion of inserting items in the action menu.

Example

declare ScatterPlot plot;
plot = ScatterPlot.Create( "Action Menu", 1:10, 1:10 );

plot.AppendActionMenuItem( "Item 1",
    "print 'Item 1';" );
plot.AppendActionMenuItem( "Cascade\nItem 2"J,
    "print 'Item 2';" );
plot.AppendActionMenuItem( "Cascade\nItem 3"J,
    "print 'Item 3';" );
plot.AppendActionMenuItem( "Item 4",
    "print 'Item 4';" );
plot.InsertActionMenuSeparator( "Cascade\nItem 2"J,
    "Cascade\nSep1"J );
plot.InsertActionMenuSeparator( "Cascade",
    "Sep1" );
/* Press F11 in the plot window to see the menu. */

See Also

DataView.AppendActionMenuSeparator
DataView.AppendActionMenuSeparatorToGroup
DataView.InsertActionMenuItem