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

C1DropDownButton

C1DropDown

Implements

INotifyPropertyChanged

IDisposable

Namespace: C1.WinUI.Input

Assembly: C1.WinUI.Input.dll

Syntax

public class C1DropDownButton : ContentControl, INotifyPropertyChanged, IDisposable

Public Class C1DropDownButton
    Inherits ContentControl
    Implements INotifyPropertyChanged, IDisposable

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 Microsoft.UI.Xaml.Media.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.
IsDisposed	Gets whether this instance is disposed.
IsDropDownOpen	Open or close the control drop-down popup.
IsFocused	Gets whether the control is focused.
IsMouseOver	Gets whether the mouse is over the control.
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 Microsoft.UI.Xaml.Media.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 Microsoft.UI.Xaml.Media.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()
Dispose(bool)
Finalize()	Finalizes this instance of the C1DropDownButton class.
GetPreferedLocations()	Get the locations where the dropdown will try to locate the Microsoft.UI.Xaml.Controls.Primitives.Popup once it's opened.
OnApplyTemplate()
OnGotFocus(RoutedEventArgs)
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.