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

object

DispatcherObject

C1HeaderedContentControl

C1DropDownButton

C1DropDown

Implements

IAnimatable

IFrameworkInputElement

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

<TemplatePart(Name:="ArrowToggle", Type:=GetType(ToggleButton))>
<TemplatePart(Name:="DropDownPopup", Type:=GetType(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:=GetType(C1ValidationDecorator))>
Public Class C1DropDownButton
    Inherits C1HeaderedContentControl
    Implements 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

Extensions.FindParent<T>(FrameworkElement)

Extensions.GetAllParents(FrameworkElement)

Extensions.GetVisualStateGroup(FrameworkElement, string)

Extensions.SetBinding<T>(FrameworkElement, DependencyProperty, T, Expression<Func<T, object>>)

Extensions.SetBinding<T>(FrameworkElement, DependencyProperty, T, Expression<Func<T, object>>, IValueConverter)

Extensions.C1TransformToVisual(UIElement, UIElement)