[]
        
(Showing Draft Content)

C1.WPF.C1DropDownButton

C1DropDownButton Class

C1DropDown provides a generic drop-down control with a Header property that determines what the user sees when the drop-down part of the control is closed, and a Content property that determines what goes into the drop-down section.

Namespace: C1.WPF
Assembly: C1.WPF.4.6.2.dll
Syntax
[TemplatePart(Name = "ArrowToggle", Type = typeof(ToggleButton))]
[TemplatePart(Name = "DropDownPopup", Type = typeof(Popup))]
[TemplateVisualState(Name = "Opened", GroupName = "DropDownOpenStates")]
[TemplateVisualState(Name = "Closed", GroupName = "DropDownOpenStates")]
[TemplateVisualState(Name = "MouseOver", GroupName = "CommonStates")]
[TemplateVisualState(Name = "Disabled", GroupName = "CommonStates")]
[TemplateVisualState(Name = "Normal", GroupName = "CommonStates")]
[TemplateVisualState(Name = "Focused", GroupName = "FocusStates")]
[TemplateVisualState(Name = "Unfocused", GroupName = "FocusStates")]
[TemplateVisualState(Name = "Valid", GroupName = "ValidationStatesStates")]
[TemplateVisualState(Name = "InvalidUnfocused", GroupName = "ValidationStatesStates")]
[TemplateVisualState(Name = "InvalidFocused", GroupName = "ValidationStatesStates")]
[StyleTypedProperty(Property = "ValidationDecoratorStyle", StyleTargetType = typeof(C1ValidationDecorator))]
public class C1DropDownButton : C1HeaderedContentControl, IAnimatable, IFrameworkInputElement, IInputElement, ISupportInitialize, IQueryAmbient, IAddChild

Constructors

Name Description
C1DropDownButton()

Initializes a new instance of a C1DropDownButton.

Fields

Name Description
AutoCloseProperty

Identifies the AutoClose dependency property.

AutoSizeModeProperty

Identifies the AutoSizeMode dependency property.

CornerRadiusProperty

Identifies the CornerRadius dependency property.

DropDownDirectionProperty

Identifies the DropDownDirection dependency property.

DropDownHeightProperty

Identifies the DropDownHeight dependency property.

DropDownWidthProperty

Identifies the DropDownWidth dependency property.

FocusBrushProperty

Identifies the FocusBrush dependency property.

IsDropDownOpenProperty

Identifies the IsDropDownOpen dependency property.

IsFocusedProperty

Identifies the IsFocused dependency property.

MaxDropDownHeightProperty

Identifies the MaxDropDownHeight dependency property.

MaxDropDownWidthProperty

Identifies the MaxDropDownWidth dependency property.

MinDropDownHeightProperty

Identifies the MinDropDownHeight dependency property.

MinDropDownWidthProperty

Identifies the MinDropDownWidth dependency property.

MouseOverBrushProperty

Identifies the MouseOverBrush dependency property.

PressedBrushProperty

Identifies the PressedBrush dependency property.

ValidationDecoratorStyleProperty

Identifies the ValidationDecoratorStyle dependency property.

Properties

Name Description
AutoClose

Auto closes the dropdown when the user clicks outside it.

AutoSizeMode

Gets or sets how the content of the poup will be resized as the content size changes.

CornerRadius

Gets or sets a value that represents the degree to which the corners of the element are rounded.

DropDownDirection

Specifies the expand direction of the control drop-down box.

DropDownHeight

Gets or sets the height of the drop-down box (set to Double.NaN to size automatically).

DropDownWidth

Gets or sets the width of the drop-down box (set to Double.NaN to size automatically).

FocusBrush

Gets or sets the Brush used to highlight the focused control.

IsDropDownOpen

Open or close the control drop-down box.

IsFocused

Returns true if the control has the focus.

MaxDropDownHeight

Gets or sets maximum height constraint of the drop-down box.

MaxDropDownWidth

Gets or sets maximum width constraint of the drop-down box.

MinDropDownHeight

Gets or sets minimum height constraint of the drop-down box.

MinDropDownWidth

Gets or sets minimum width constraint of the drop-down box.

MouseOverBrush

Gets or sets the Brush used to highlight the control when it has the mouse over.

PressedBrush

Gets or sets the Brush used to paint a button when it is pressed.

ValidationDecoratorStyle

Gets or sets the style that is applied to the inner C1ValidationDecorator.

Methods

Name Description
ChangeVisualStateCommon(bool)

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

ChangeVisualStateDropDownOpen(bool)

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

ChangeVisualStateFocus(bool)

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

GetPreferedLocations()

Get the locations where the dropdown will try to locate the Popup once it's opened.

OnApplyTemplate()

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

OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invoked whenever the effective value of any dependency property has been updated.

Events

Name Description
IsDropDownOpenChanged

Event raised when the IsDropDownOpen property has changed.

IsMouseOverChanged

Event raised when the IsMouseOver property has changed.

Extension Methods