[]
        
(Showing Draft Content)

C1.WPF.Input.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.

Inheritance
C1DropDownButton
Namespace: C1.WPF.Input
Assembly: C1.WPF.Input.dll
Syntax
[StyleTypedProperty(Property = "PopupStyle", StyleTargetType = typeof(C1PopupBorder))]
[StyleTypedProperty(Property = "DropDownIconStyle", StyleTargetType = typeof(ContentControl))]
[StyleTypedProperty(Property = "DropDownButtonStyle", StyleTargetType = typeof(C1ToggleButton))]
[TemplatePart(Name = "DropDownButton", Type = typeof(C1ToggleButton))]
[TemplatePart(Name = "AutoSize", Type = typeof(AutoSizeContentPresenter))]
[TemplateVisualState(Name = "Normal", GroupName = "CommonStates")]
[TemplateVisualState(Name = "MouseOver", GroupName = "CommonStates")]
[TemplateVisualState(Name = "Focused", GroupName = "CommonStates")]
[TemplateVisualState(Name = "Disabled", GroupName = "CommonStates")]
[TemplateVisualState(Name = "Opened", GroupName = "DropDownOpenStates")]
[TemplateVisualState(Name = "Closed", GroupName = "DropDownOpenStates")]
public class C1DropDownButton : C1ContentControl, INotifyPropertyChanged

Constructors

Name Description
C1DropDownButton()

Initializes a new instance of the C1DropDownButton class.

Fields

Name Description
AutoCloseProperty

Identifies the AutoClose dependency property.

AutoSizeModeProperty

Identifies the AutoSizeMode dependency property.

CloseOnLostFocusProperty

Identifies the CloseOnLostFocus dependency property.

DropDownButtonStyleProperty

Identifies the DropDownButtonStyle dependency property.

DropDownDirectionProperty

Identifies the DropDownDirection dependency property.

DropDownHeightProperty

Identifies the DropDownHeight dependency property.

DropDownIconStyleProperty

Identifies the DropDownIconStyle dependency property.

DropDownIconTemplateProperty

Identifies the DropDownIconTemplate dependency property.

DropDownWidthProperty

Identifies the DropDownWidth dependency property.

FocusBrushProperty

Identifies the FocusBrush dependency property.

HeaderProperty

Identifies the Header dependency property.

HeaderTemplateProperty

Identifies the HeaderTemplate dependency property.

IsDropDownOpenProperty

Identifies the IsDropDownOpen 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.

PopupStyleProperty

Identifies the PopupStyle 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.

CloseOnLostFocus

Gets or sets whether the popup is closed automatically when the control loses the focus.

DropDownButtonStyle

Gets or sets the style of the button that opens the drop-down.

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).

DropDownIconStyle

Gets or sets the style of the icon shown in the drop-down button.

DropDownIconTemplate

Gets or sets the template of the icon used in the drop-down button.

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.

Header

Gets or sets the header of the drop-down.

HeaderTemplate

Gets or sets the template displayed in the header of the drop-down.

HeaderVisibility

Gets the visibility of the header.

IsDropDownOpen

Open or close the control drop-down popup.

IsFocused

Gets whether the control is focused.

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.

PopupStyle

Gets or sets the style for the popup.

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.

Dispose(bool)
GetPreferedLocations()

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

OnApplyTemplate()
OnFlowDirectionChanged()

Called when the flow direction changed.

OnGotFocus(RoutedEventArgs)
OnKeyDown(KeyEventArgs)
OnPropertyChanged(string)

Called when a property changed

Events

Name Description
IsDropDownOpenChanged

Called when the drop-down popup is opened or closed.

PropertyChanged

Occurs when a property value changed.