[]
        
(Showing Draft Content)

C1.WPF.C1MenuItem

C1MenuItem Class

Represents a selectable item inside a C1Menu control.

Namespace: C1.WPF
Assembly: C1.WPF.4.6.2.dll
Syntax
[TemplatePart(Name = "HeaderPanel", Type = typeof(Grid))]
[TemplatePart(Name = "ExpandIcon", Type = typeof(Shape))]
[TemplatePart(Name = "MenuIcon", Type = typeof(ContentControl))]
[TemplatePart(Name = "CheckIcon", Type = typeof(FrameworkElement))]
[TemplatePart(Name = "SubItemsPopup", Type = typeof(Popup))]
[TemplatePart(Name = "SubItemsPresenter", Type = typeof(ItemsPresenter))]
[TemplatePart(Name = "HExpandIcon", Type = typeof(Shape))]
[TemplatePart(Name = "VExpandIcon", Type = typeof(Shape))]
[TemplateVisualState(Name = "Opened", GroupName = "OpenedStates")]
[TemplateVisualState(Name = "Closed", GroupName = "OpenedStates")]
[TemplateVisualState(Name = "Highlighted", GroupName = "HighlightedStates")]
[TemplateVisualState(Name = "NonHighlighted", GroupName = "HighlightedStates")]
public class C1MenuItem : C1HierarchicalPresenter, IAnimatable, IFrameworkInputElement, IInputElement, ISupportInitialize, IQueryAmbient, IAddChild, IContainItemStorage

Constructors

Name Description
C1MenuItem()

Initializes a new instance of a C1MenuItem.

Fields

Name Description
CommandParameterProperty

Identifies the CommandParameter dependency property.

CommandProperty

Identifies the Command dependency property.

DisabledCuesVisibilityProperty

Identifies the DisabledCuesVisibility dependency property.

FocusCuesVisibilityProperty

Identifies the FocusCuesVisibility dependency property.

GroupNameProperty

Identifies the GroupName dependency property.

HeaderBackgroundProperty

Identifies the HeaderBackground dependency property.

HeaderForegroundProperty

Identifies the HeaderForeground dependency property.

HighlightedBackgroundProperty

Identifies the HighlightedBackground dependency property.

IconProperty

Identifies the Icon dependency property.

InputGestureTextProperty

Identifies the InputGestureText dependency property.

IsCheckableProperty

Identifies the IsCheckable dependency property.

IsCheckedProperty

Identifies the IsChecked dependency property.

IsHighlightedProperty

Identifies the IsHighlighted dependency property.

IsSubmenuOpenProperty

Identifies the IsSubmenuOpen dependency property.

OpenedBackgroundProperty

Identifies the OpenedBackground dependency property.

SubMenuMaxHeightProperty

Identifies the SubMenuMaxHeight dependency property.

TextAlignmentProperty

Identifies the TextAlignment dependency property.

TextDecorationsProperty

Identifies the TextDecorations dependency property.

TextWrappingProperty

Identifies the TextWrapping dependency property.

Properties

Name Description
Command

Gets or sets the command to invoke when this button is pressed.

CommandParameter

Gets or sets the parameter to pass to the Command property.

DisabledCuesVisibility

Gets or sets a value indicating whether the disabled visuals of the control are visible.

FocusCuesVisibility

Gets or sets a value indicating whether the focus visuals of the control are visible.

GroupName

Gets or sets the name that specifies which MenuItems are mutually exclusive (when checkable).

HeaderBackground

Gets or sets the background brush of the header.

HeaderForeground

Gets or sets the foreground brush of the header.

HighlightedBackground

Gets or sets the Brush used to highlight the menu item.

Icon

Gets or sets the icon that appears in a C1MenuItem.

Index

Gets the index of this C1.Silverlight.C1MenuItem in its parent items collection.

InputGestureText

Gets or sets the text describing an input gesture that will call the command tied to the specified item.

IsCheckable

Gets a value that indicates whether a C1MenuItem can be checked.

IsChecked

Gets or sets a value that indicates whether the C1MenuItem is checked.

IsFirstLevel

Indicates whether the current item is a FirstLevel submenu.

IsHighlighted

Gets a value that indicates whether a C1MenuItem is highlighted.

IsSubmenuOpen

Gets a value that indicates whether the submenu of the C1MenuItem is open.

Menu

Identifies the parent C1.Silverlight.C1Menu of this item.

OpenedBackground

Gets or sets the Brush used in a menu item when this item is opened.

Parent

Gets the C1MenuItem that is the parent of this item.

ParentItem

Gets the C1MenuItem that is the parent of this item.

SubMenuMaxHeight

Gets or sets a value that indicates the MaxHeight of the SubMenu.

TextAlignment

Gets or sets a value that indicates the horizontal alignment of text content in the Header.

TextDecorations

Gets or sets a TextDecorationCollection that contains the effects to apply to the text of the Header.

TextWrapping

Gets or sets a value that indicates how any text should be wrapped in the Header.

Methods

Name Description
ChangeVisualStateHighlighted(bool)

Updates the current visual state of the Highlighted visual state group to match the object's properties.

ChangeVisualStateOpened(bool)

Updates the current visual state of the Opened visual state group to match the object's properties.

ClearContainerForItemOverride(DependencyObject, object)
GetContainerForItemOverride()
IsItemItsOwnContainerOverride(object)
OnAccessKey(AccessKeyEventArgs)
OnApplyTemplate()

Builds the visual tree for the C1MenuItem control when a new template is applied.

OnChecked(SourcedEventArgs)

Responds to a check item action by raising a Checked event.

OnClick(SourcedEventArgs)

Responds to a click action by raising a Click event.

OnItemsChanged(NotifyCollectionChangedEventArgs)
OnMouseClick(object, MouseEventArgs)

Called when the user clicks the item.

OnMouseEnter(object, MouseEventArgs)

Called when the mouse pointer enters the bounds of the header element.

OnMouseLeave(object, MouseEventArgs)

Called when the mouse pointer leaves the bounds of the header element.

OnMouseRightButtonDown(MouseButtonEventArgs)

Called before the System.Windows.UIElement.MouseRightButtonDown event occurs.

OnSubmenuClosed(SourcedEventArgs)

Responds to a closed item action by raising a SubmenuClosed event.

OnSubmenuClosing(CancelSourceEventArgs)

Responds to a close item action by raising a SubmenuClosing event.

OnSubmenuOpened(SourcedEventArgs)

Responds to an open item action by raising a SubmenuOpened event.

OnSubmenuOpening(CancelSourceEventArgs)

Responds to an open item action by raising a SubmenuOpening event.

OnUnchecked(SourcedEventArgs)

Responds to an uncheck item action by raising a Unchecked event.

PrepareContainerForItemOverride(DependencyObject, object)

Events

Name Description
Checked

Occurs when a C1MenuItem is checked.

Click

Occurs when the C1MenuItem is clicked.

SubmenuClosed

Occurs when the state of the IsSubmenuOpen property changes to false.

SubmenuClosing

Occurs when a submenu is closing.

SubmenuOpened

Occurs when the state of the IsSubmenuOpen property changes to true.

SubmenuOpening

Occurs when a submenu is opening.

Unchecked

Occurs when a C1MenuItem is unchecked.

Extension Methods