In This Article

BarPopupButtonCommand Class

Represents a bar button command that causes a popup.

public class BarPopupButtonCommand : BarCommand, IImageListProvider, IBarPopupCommand, IHasDefaultCommandLinks
Inheritance:
Object Command BarCommand Object
Implements:
IImageListProvider IBarPopupCommand IHasDefaultCommandLinks

Constructors

BarPopupButtonCommand(String, String, String, Int32)

Initializes a new instance of the BarPopupButtonCommand class.

public BarPopupButtonCommand(string category, string name, string text, int imageIndex)
Parameter Type Description
category String

The category of the bar command.

name String

The name of the bar command.

text String

The text caption.

imageIndex Int32

The index of an image within an ImageList.

BarPopupButtonCommand(String, String, String, Int32, Boolean)

Initializes a new instance of the BarPopupButtonCommand class.

public BarPopupButtonCommand(string category, string name, string text, int imageIndex, bool enabled)
Parameter Type Description
category String

The category of the bar command.

name String

The name of the bar command.

text String

The text caption.

imageIndex Int32

The index of an image within an ImageList.

enabled Boolean

Whether the button is enabled.

Properties

CanTearOff

Gets or sets whether the popup menu can be torn-off onto a DockableToolBar.

public bool CanTearOff { get; set; }

Property Value

Boolean:

true if the popup menu can be torn-off onto a DockableToolBar; otherwise, false.

Gets the BarCommandLinkCollection containing the default command links for use in the button's popup.

public BarCommandLinkCollection DefaultCommandLinks { get; }

Property Value

BarCommandLinkCollection:

The BarCommandLinkCollection containing the default command links for use in the button's popup.

TearOffDockableToolBarKey

Gets or sets the key of the DockableToolBar that is created if a tear-off occurs.

public string TearOffDockableToolBarKey { get; set; }

Property Value

String:

The key of the DockableToolBar that is created if a tear-off occurs.

UseToolBarStyleForPopupMenu

Gets or sets whether to display the popup menu using a toolbar style.

public bool UseToolBarStyleForPopupMenu { get; set; }

Property Value

Boolean:

true if a toolbar style should be used; otherwise, false.

Methods

CloneToType(Type)

Creates a copy of the BarCommand.

protected override BarCommand CloneToType(Type targetType)
Parameter Type Description
targetType Type

The target Type.

Returns

BarCommand:

The copy of the BarCommand.

Creates a new BarCommandLink for the command.

public override BarCommandLink CreateCommandLink()

Returns

BarCommandLink:

The BarCommandLink that was created.

Process(BarProcessEventArgs)

Performs processing based on some sort of event.

protected override void Process(BarProcessEventArgs e)
Parameter Type Description
e BarProcessEventArgs

A BarProcessEventArgs that contains the event data.

ReadAttributesFromXml(BarLayoutXmlSerializer)

Deserializes the attribute data for the BarCommandLink from XML.

protected override void ReadAttributesFromXml(BarLayoutXmlSerializer serializer)
Parameter Type Description
serializer BarLayoutXmlSerializer

The BarLayoutXmlSerializer to use.

ReadElementFromXml(BarLayoutXmlSerializer)

Deserializes a child element for the BarCommandLink from XML.

protected override void ReadElementFromXml(BarLayoutXmlSerializer serializer)
Parameter Type Description
serializer BarLayoutXmlSerializer

The BarLayoutXmlSerializer to use.

ResetCanTearOff()

Resets the CanTearOff property to its default value.

public virtual void ResetCanTearOff()

ResetTearOffDockableToolBarKey()

Resets the TearOffDockableToolBarKey property to its default value.

public virtual void ResetTearOffDockableToolBarKey()

ResetToolTipEnabled()

Resets the ToolTipEnabled property to its default value.

public override void ResetToolTipEnabled()

ResetUseToolBarStyleForPopupMenu()

Resets the UseToolBarStyleForPopupMenu property to its default value.

public virtual void ResetUseToolBarStyleForPopupMenu()

ShouldSerializeCanTearOff()

Indicates whether the CanTearOff property should be persisted.

public virtual bool ShouldSerializeCanTearOff()

Returns

Boolean:

true if the property value has changed from its default; otherwise, false.

ShouldSerializeTearOffDockableToolBarKey()

Indicates whether the TearOffDockableToolBarKey property should be persisted.

public virtual bool ShouldSerializeTearOffDockableToolBarKey()

Returns

Boolean:

true if the property value has changed from its default; otherwise, false.

ShouldSerializeToolTipEnabled()

Indicates whether the ToolTipEnabled property should be persisted.

public override bool ShouldSerializeToolTipEnabled()

Returns

Boolean:

true if the property value has changed from its default; otherwise, false.

ShouldSerializeUseToolBarStyleForPopupMenu()

Indicates whether the UseToolBarStyleForPopupMenu property should be persisted.

public virtual bool ShouldSerializeUseToolBarStyleForPopupMenu()

Returns

Boolean:

true if the property value has changed from its default; otherwise, false.

WriteAttributesToXml(BarLayoutXmlSerializer)

Serializes the attribute data for the BarCommand to XML.

protected override void WriteAttributesToXml(BarLayoutXmlSerializer serializer)
Parameter Type Description
serializer BarLayoutXmlSerializer

The BarLayoutXmlSerializer to use.

WriteElementsToXml(BarLayoutXmlSerializer)

Serializes the child element data for the BarCommand to XML.

protected override void WriteElementsToXml(BarLayoutXmlSerializer serializer)
Parameter Type Description
serializer BarLayoutXmlSerializer

The BarLayoutXmlSerializer to use.

Inherited Members