Skip to end of metadata
Go to start of metadata

Represents a selection control in a drop-down list form.

Definition

public class UXDropDownEditor : ISContentControl,

IKeyboardFocus, IFocusRedirection

Summary

The following table summarizes the members exposed in this class.

Public Constructors

UXDropDownEditor Constructor() Initializes a new instance of the UXDropDownEditor class.

Public Properties

BoundaryOffset Gets or set the minimum boundary offset.
ContentPresenter Gets the content presenter.
CornerRadiusDouble Corner Radius in double type for template binding.
DisplayAnimation Gets or sets a value that determines the display animation.
DropDownBackground Represents the brush used to draw the dropdown background.
DropDownBorderBrush Represents the brush used to draw the dropdown border.
DropDownBorderThickness Gets or sets the dropdown border thickness.
DropDownCornerRadius Corner Radius for input template binding.
DropDownEffect Gets or sets the System.Windows.Media.Effects.Effect to apply to the dropdown element.
DropDownHeight Gets or sets the height of content inside drop down list.
DropDownHeightCalculated Gets or sets the height of content inside drop down list.
DropDownWidth Gets or sets the width of content inside drop down list.
EnableFadeInAnimation Gets or sets a value that determines whether the fade animation is enabled.
EnableFadeOutAnimation Gets or sets a value that determines whether the fade animation is enabled.
EnableFocusAnimation Specifies whether this button should be animated when focused.
GlassBackground Represents the brush used to draw the glass element of the button.
GlassMargin Gets or sets the value that represents the margin of the glass element.
HideAnimation Gets or sets a value that determines the hide animation.
HorizontalOffset Gets or sets the distance between the left side of the Silverlight control and the left side of the popup.
InnerBorderVisibility Specifies whether the inner border should be visible.
InnerCornerRadius Inner corner radius.
IsDropDownEnabled Gets or sets a value indicating whether the dropdown button is enabled.
IsDropDownOpen Gets or sets whether the dropdown menu is currently displaying on the screen.
IsEditable Gets or sets a value that indicates whether the UXDropDownEditor is editable.
IsKeyboardFocused Gets a value that indicates whether this element has keyboard focus.
IsKeyboardFocusWithin Gets a value that indicates whether keyboard focus is anywhere within the element or child elements.
IsReadOnly Gets or sets a value that indicates whether the UXDropDownEditor is read only.
MaxDropDownHeight Gets or sets the maximum height of content inside drop down list.
MaxDropDownWidth Gets or sets the maximum width of content inside drop down list.
MinDropDownHeight Gets or sets the minimum height of content inside drop down list.
MinDropDownWidth Gets or sets the minimum width of content inside drop down list.
MinWidthCalculated Gets or sets the minimum width of content inside drop down list.
PreferredHorizontalDirection Gets or sets the preferred horizontal direction.
PreferredPosition Gets or sets the preferred pop up positions.
PreferredVerticalDirection Gets or sets the preferred vertical direction.
RaiseEventOnLostFocus Gets or sets the value indicating whether event should be raised on lost focus.
RootElement Gets the root element.
ScrollViewerStyle Gets or sets the UXScrollViewer style.
ShowKeyboardFocusVisual Gets or sets the value indicating whether keyboard focus visual should be shown.
SlideDirection Gets or sets a value that determine the slide direction when slide animation is used.
StaysOpen Gets or sets a value that determines whether the popup stays open regardless the hide command.
SupportKeyboardFocus Gets or sets the value indicating whether keyboard focus is supported.
Text Gets or sets the text value.
TextBoxBackground Represents the brush used to draw the textbox background.
TextBoxPadding Gets or sets the padding of the text box element of the UXDropDownEditor.
TextBoxStyle Gets or sets the TextBoxStyle style.
Value Gets or sets the Value property
VerticalOffset Gets or sets the distance between the top of the Silverlight control and the top of the popup.
WatermarkForeground Specifies the brush applied in watermark text's foreground.
WatermarkText Gets or sets the text displayed as watermark.
WatermarkTextStyle Specifies the watermark text style.
WatermarkTextVisibility Specifies whether watermark text should be displayed when the Text is empty.

Protected Properties

Product Product Info.

Fields

BoundaryOffsetProperty Identifies the BoundaryOffset dependency property.
CornerRadiusDoubleProperty Identifies the CornerRadiusDouble dependency property.
DisplayAnimationProperty Identifies the DisplayAnimation dependency property.
DropDownBackgroundProperty Identifies the DropDownBackground dependency property.
DropDownBorderBrushProperty Identifies the "DropDownBorderBrush dependency property.
DropDownBorderThicknessProperty Identifies the DropDownBorderThickness dependency property.
DropDownCornerRadiusProperty Identifies the CornerRadiusDouble dependency property.
DropDownEffectProperty Identifies the DropDownEffect dependency property.
DropDownHeightCalculatedProperty Identifies the DropDownHeightCalculated dependency property.
DropDownHeightProperty Identifies the DropDownHeight dependency property.
DropDownTemplateProperty Identifies the DropDownTemplate dependency property.
DropDownWidthProperty Identifies the DropDownWidth dependency property.
EnableFadeInAnimationProperty Identifies the EnableFadeAnimation dependency property.
EnableFadeOutAnimationProperty Identifies the EnableFadeAnimation dependency property.
EnableFocusAnimationProperty Identifies the EnableFocusAnimation dependency property.
GlassBackgroundProperty Identifies the GlassBackground dependency property.
GlassMarginProperty Identifies the GlassMargin dependency property
HeaderTemplateProperty Identifies the HeaderTemplate dependency property.
HideAnimationProperty Identifies the HideAnimation dependency property.
HorizontalOffsetProperty Identifies the HorizontalOffset dependency property.
InnerBorderVisibilityProperty Identifies the InnerBorderVisibility dependency property.
InnerCornerRadiusProperty Identifies the InnerCornerRadius dependency property.
IsDropDownEnabledProperty
IsDropDownOpenProperty Identifies the IsDropDownOpen dependency property.
IsEditableProperty Identifies the IsEditable dependency property.
IsKeyboardFocusedProperty Identifies the IsKeyboardFocused dependency property.
IsReadOnlyProperty Identifies the IsReadOnly 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.
MinWidthCalculatedProperty Identifies the MinWidthCalculated dependency property.
PreferredHorizontalDirectionProperty Identifies the PreferredPosition dependency property.
PreferredPositionProperty Identifies the PreferredPosition dependency property.
PreferredVerticalDirectionProperty Identifies the PreferredVerticalDirection dependency property.
ScrollViewerStyleProperty
ShowKeyboardFocusVisualProperty Identifies the ShowKeyboardFocusVisual dependency property.
SlideDirectionProperty Identifies the SlideDirection dependency property.
StaysOpenProperty Identifies the StaysOpen dependency property.
TextBoxBackgroundProperty Identifies the TextBoxBackground dependency property.
TextBoxPaddingProperty Identifies the TextBoxPadding dependency property.
TextBoxStyleProperty Identifies the TextBoxStyle dependency property.
TextProperty Identifies the Text dependency property.
ValueProperty Identifies the Value dependency property.
VerticalOffsetProperty Identifies the VerticalOffset dependency property.
WatermarkForegroundProperty Identifies the WatermarkForeground dependency property.
WatermarkTextProperty Identifies the WatermarkText dependency property.
WatermarkTextStyleProperty Identifies the WatermarkTextStyle dependency property.
WatermarkTextVisibilityProperty Identifies the WatermarkTextVisibility dependency property.

Public Methods

AttachEventHandlers() Attach built-in event handlers to control templates. Call this method if necessary.
DetachedEventHandlers() Detach built-in event handlers from control templates. Call this method if necessary.
Dispose() Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
InitializeTemplates() Initializes control templates.
OnApplyTemplate() Builds the visual tree for the UXDropDownButton when a new template is applied.
SelectAllText() Select the input text.
SelectText(int, int) Select the input text.
SetFocus() Redirects focus to the text input element.

Protected Methods

ChangeVisualState() Change visual state.
ChangeVisualState(bool) Change visual state.
Menu_Closed(object, ISRoutedEventArgs) On drop down menu closed.
Menu_Opened(object, ISRoutedEventArgs) On drop down menu opened.
Menu_Repositioned(object, UXPopUpEventArgs) On drop down menu repositioned.
MenuStateChanged(bool) On dropdown menu state changed.
OnCornerRadiusChanged() Called when the value of CornerRadius property changes.
OnGotFocus(RoutedEventArgs) Called before the GotFocus event occurs.
OnIsDropDownOpenChanged(DependencyPropertyChangedEventArgs) Called when the value of IsDropDownOpen property changes.
OnIsEnabledChanged(object, DependencyPropertyChangedEventArgs) Called when the value of IsEnabled property changes.
OnIsKeyboardFocusChanged(DependencyPropertyChangedEventArgs) Called when the value of IsKeyboardFocus property changes.
OnIsPressedChanged(DependencyPropertyChangedEventArgs) Called when the value of IsPressed property changes.
OnLostFocus(RoutedEventArgs) Called before the LostFocus event occurs.
OnLostKeyboardFocus(KeyboardFocusChangedEventArgs) Inheritors should override this method to handle custom logic for LostKeyboardFocus event.
OnMouseEnter(MouseEventArgs) Called before MouseEnter event occurs.
OnMouseLeave(MouseEventArgs) Called before the MouseLeave event occurs.
OnMouseLeftButtonDown(MouseButtonEventArgs) Called before the MouseLeftButtonDown event occurs.
OnMouseLeftButtonUp(MouseButtonEventArgs) Called before the MouseLeftButtonUp event occurs.
OnWatermarkTextVisibilityChanged() Called when the WatermarkTextVisibility property is changed.

Events

Closed Occurs when the dropdown menu of the button is closed.
GotKeyboardFocus Occurs when the keyboard is focused on this element.
LostKeyboardFocus Occurs when the keyboard is no longer focused on this element.
Opened Occurs when the dropdown menu of the button is opened.

Public Constructors

public UXDropDownEditor()

Initializes a new instance of the UXDropDownEditor class.

Public Properties

public Thickness BoundaryOffset { get; set; }

Gets or set the minimum boundary offset.

public StylishLabel ContentPresenter { get; }

Gets the content presenter.

public double CornerRadiusDouble { get; set; }

Corner Radius in double type for template binding.

public PopupAnimation DisplayAnimation { get; set; }

Gets or sets a value that determines the display animation.

public Brush DropDownBackground { get; set; }

Represents the brush used to draw the dropdown background.

public Brush DropDownBorderBrush { get; set; }

Represents the brush used to draw the dropdown border.

public Thickness DropDownBorderThickness { get; set; }

Gets or sets the dropdown border thickness.

public CornerRadius DropDownCornerRadius { get; set; }

Corner Radius for input template binding.

public Effect DropDownEffect { get; set; }

Gets or sets the System.Windows.Media.Effects.Effect to apply to the dropdown element.

public double DropDownHeight { get; set; }

Gets or sets the height of content inside drop down list.

public double DropDownHeightCalculated { get; set; }

Gets or sets the height of content inside drop down list.

public double DropDownWidth { get; set; }

Gets or sets the width of content inside drop down list.

public bool EnableFadeInAnimation { get; set; }

Gets or sets a value that determines whether the fade animation is enabled.

public bool EnableFadeOutAnimation { get; set; }

Gets or sets a value that determines whether the fade animation is enabled.

public bool EnableFocusAnimation { get; set; }

Specifies whether this button should be animated when focused.

public Brush GlassBackground { get; set; }

Represents the brush used to draw the glass element of the button.

public Thickness GlassMargin { get; set; }

Gets or sets the value that represents the margin of the glass element.

public PopupAnimation HideAnimation { get; set; }

Gets or sets a value that determines the hide animation.

public double HorizontalOffset { get; set; }

Gets or sets the distance between the left side of the Silverlight control and the left side of the popup.

public Visibility InnerBorderVisibility { get; set; }

Specifies whether the inner border should be visible.

public CornerRadius InnerCornerRadius { get; set; }

Inner corner radius.

public bool IsDropDownEnabled { get; set; }

Gets or sets a value indicating whether the dropdown button is enabled.

public bool IsDropDownOpen { get; set; }

Gets or sets whether the dropdown menu is currently displaying on the screen.

public bool IsEditable { get; set; }

Gets or sets a value that indicates whether the UXDropDownEditor is editable.

public bool IsKeyboardFocused { get; set; }

Gets a value that indicates whether this element has keyboard focus.

public bool IsKeyboardFocusWithin { get; }

Gets a value that indicates whether keyboard focus is anywhere within the element or child elements.

public bool IsReadOnly { get; set; }

Gets or sets a value that indicates whether the UXDropDownEditor is read only.

public double MaxDropDownHeight { get; set; }

Gets or sets the maximum height of content inside drop down list.

public double MaxDropDownWidth { get; set; }

Gets or sets the maximum width of content inside drop down list.

public double MinDropDownHeight { get; set; }

Gets or sets the minimum height of content inside drop down list.

public double MinDropDownWidth { get; set; }

Gets or sets the minimum width of content inside drop down list.

public double MinWidthCalculated { get; set; }

Gets or sets the minimum width of content inside drop down list.

public PopupHorizontalDirection PreferredHorizontalDirection { get; set; }

Gets or sets the preferred horizontal direction.

public PopupPosition PreferredPosition { get; set; }

Gets or sets the preferred pop up positions.

public PopupVerticalDirection PreferredVerticalDirection { get; set; }

Gets or sets the preferred vertical direction.

public bool RaiseEventOnLostFocus { get; }

Gets or sets the value indicating whether event should be raised on lost focus.

public Grid RootElement { get; }

Gets the root element.

public Style ScrollViewerStyle { get; set; }

Gets or sets the UXScrollViewer style.

public bool ShowKeyboardFocusVisual { get; set; }

Gets or sets the value indicating whether keyboard focus visual should be shown.

public Direction SlideDirection { get; set; }

Gets or sets a value that determine the slide direction when slide animation is used.

public bool StaysOpen { get; set; }

Gets or sets a value that determines whether the popup stays open regardless the hide command.

public bool SupportKeyboardFocus { get; }

Gets or sets the value indicating whether keyboard focus is supported.

public string Text { get; set; }

Gets or sets the text value.

public Brush TextBoxBackground { get; set; }

Represents the brush used to draw the textbox background.

public Thickness TextBoxPadding { get; set; }

Gets or sets the padding of the text box element of the UXDropDownEditor.

public Style TextBoxStyle { get; set; }

Gets or sets the TextBoxStyle style.

public object Value { get; set; }

Gets or sets the Value property

public double VerticalOffset { get; set; }

Gets or sets the distance between the top of the Silverlight control and the top of the popup.

public Brush WatermarkForeground { get; set; }

Specifies the brush applied in watermark text's foreground.

public string WatermarkText { get; set; }

Gets or sets the text displayed as watermark.

public FontStyle WatermarkTextStyle { get; set; }

Specifies the watermark text style.

public Visibility WatermarkTextVisibility { get; set; }

Specifies whether watermark text should be displayed when the Text is empty.

Protected Properties

protected ProductInfo Product { get; }

Product Info.

Fields

public static readonly DependencyProperty BoundaryOffsetProperty

Identifies the BoundaryOffset dependency property.

public static readonly DependencyProperty CornerRadiusDoubleProperty

Identifies the CornerRadiusDouble dependency property.

public static readonly DependencyProperty DisplayAnimationProperty

Identifies the DisplayAnimation dependency property.

public static readonly DependencyProperty DropDownBackgroundProperty

Identifies the DropDownBackground dependency property.

public static readonly DependencyProperty DropDownBorderBrushProperty

Identifies the "DropDownBorderBrush dependency property.

public static readonly DependencyProperty DropDownBorderThicknessProperty

Identifies the DropDownBorderThickness dependency property.

public static readonly DependencyProperty DropDownCornerRadiusProperty

Identifies the CornerRadiusDouble dependency property.

public static readonly DependencyProperty DropDownEffectProperty

Identifies the DropDownEffect dependency property.

public static readonly DependencyProperty DropDownHeightCalculatedProperty

Identifies the DropDownHeightCalculated dependency property.

public static readonly DependencyProperty DropDownHeightProperty

Identifies the DropDownHeight dependency property.

public static readonly DependencyProperty DropDownTemplateProperty

Identifies the DropDownTemplate dependency property.

public static readonly DependencyProperty DropDownWidthProperty

Identifies the DropDownWidth dependency property.

public static readonly DependencyProperty EnableFadeInAnimationProperty

Identifies the EnableFadeAnimation dependency property.

public static readonly DependencyProperty EnableFadeOutAnimationProperty

Identifies the EnableFadeAnimation dependency property.

public static readonly DependencyProperty EnableFocusAnimationProperty

Identifies the EnableFocusAnimation dependency property.

public static readonly DependencyProperty GlassBackgroundProperty

Identifies the GlassBackground dependency property.

public static readonly DependencyProperty GlassMarginProperty

Identifies the GlassMargin dependency property

public static readonly DependencyProperty HeaderTemplateProperty

Identifies the HeaderTemplate dependency property.

public static readonly DependencyProperty HideAnimationProperty

Identifies the HideAnimation dependency property.

public static readonly DependencyProperty HorizontalOffsetProperty

Identifies the HorizontalOffset dependency property.

public static readonly DependencyProperty InnerBorderVisibilityProperty

Identifies the InnerBorderVisibility dependency property.

public static readonly DependencyProperty InnerCornerRadiusProperty

Identifies the InnerCornerRadius dependency property.

public static readonly DependencyProperty IsDropDownEnabledProperty

public static readonly DependencyProperty IsDropDownOpenProperty

Identifies the IsDropDownOpen dependency property.

public static readonly DependencyProperty IsEditableProperty

Identifies the IsEditable dependency property.

public static readonly DependencyProperty IsKeyboardFocusedProperty

Identifies the IsKeyboardFocused dependency property.

public static readonly DependencyProperty IsReadOnlyProperty

Identifies the IsReadOnly dependency property.

public static readonly DependencyProperty MaxDropDownHeightProperty

Identifies the MaxDropDownHeight dependency property.

public static readonly DependencyProperty MaxDropDownWidthProperty

Identifies the MaxDropDownWidth dependency property.

public static readonly DependencyProperty MinDropDownHeightProperty

Identifies the MinDropDownHeight dependency property.

public static readonly DependencyProperty MinDropDownWidthProperty

Identifies the MinDropDownWidth dependency property.

public static readonly DependencyProperty MinWidthCalculatedProperty

Identifies the MinWidthCalculated dependency property.

public static readonly DependencyProperty PreferredHorizontalDirectionProperty

Identifies the PreferredPosition dependency property.

public static readonly DependencyProperty PreferredPositionProperty

Identifies the PreferredPosition dependency property.

public static readonly DependencyProperty PreferredVerticalDirectionProperty

Identifies the PreferredVerticalDirection dependency property.

public static readonly DependencyProperty ScrollViewerStyleProperty

public static readonly DependencyProperty ShowKeyboardFocusVisualProperty

Identifies the ShowKeyboardFocusVisual dependency property.

public static readonly DependencyProperty SlideDirectionProperty

Identifies the SlideDirection dependency property.

public static readonly DependencyProperty StaysOpenProperty

Identifies the StaysOpen dependency property.

public static readonly DependencyProperty TextBoxBackgroundProperty

Identifies the TextBoxBackground dependency property.

public static readonly DependencyProperty TextBoxPaddingProperty

Identifies the TextBoxPadding dependency property.

public static readonly DependencyProperty TextBoxStyleProperty

Identifies the TextBoxStyle dependency property.

public static readonly DependencyProperty TextProperty

Identifies the Text dependency property.

public static readonly DependencyProperty ValueProperty

Identifies the Value dependency property.

public static readonly DependencyProperty VerticalOffsetProperty

Identifies the VerticalOffset dependency property.

public static readonly DependencyProperty WatermarkForegroundProperty

Identifies the WatermarkForeground dependency property.

public static readonly DependencyProperty WatermarkTextProperty

Identifies the WatermarkText dependency property.

public static readonly DependencyProperty WatermarkTextStyleProperty

Identifies the WatermarkTextStyle dependency property.

public static readonly DependencyProperty WatermarkTextVisibilityProperty

Identifies the WatermarkTextVisibility dependency property.

Public Methods

public void AttachEventHandlers()

Attach built-in event handlers to control templates. Call this method if necessary.

public void DetachedEventHandlers()

Detach built-in event handlers from control templates. Call this method if necessary.

public void Dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

public void InitializeTemplates()

Initializes control templates.

public void OnApplyTemplate()

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

public void SelectAllText()

Select the input text.

public void SelectText(int start, int length)

Select the input text.

Parameters

start Start position
length Length

public void SetFocus()

Redirects focus to the text input element.

Protected Methods

protected void ChangeVisualState()

Change visual state.

protected void ChangeVisualState(bool useTransitions)

Change visual state.

Parameters

useTransitions Use transition.

protected void Menu_Closed(object sender, ISRoutedEventArgs e)

On drop down menu closed.

Parameters

sender
e

protected void Menu_Opened(object sender, ISRoutedEventArgs e)

On drop down menu opened.

Parameters

sender
e

protected void Menu_Repositioned(object sender, UXPopUpEventArgs e)

On drop down menu repositioned.

Parameters

sender
e

protected void MenuStateChanged(bool isOpen)

On dropdown menu state changed.

Parameters

isOpen A value that indicates whether the menu is being opened or closed.

protected void OnCornerRadiusChanged()

Called when the value of CornerRadius property changes.

protected void OnGotFocus(RoutedEventArgs e)

Called before the GotFocus event occurs.

Parameters

e The data for the event.

protected void OnIsDropDownOpenChanged(DependencyPropertyChangedEventArgs e)

Called when the value of IsDropDownOpen property changes.

Parameters

e The event data for the property change.

protected void OnIsEnabledChanged(object sender, DependencyPropertyChangedEventArgs e)

Called when the value of IsEnabled property changes.

Parameters

sender The sender of the event.
e The event data for the property change.

protected void OnIsKeyboardFocusChanged(DependencyPropertyChangedEventArgs e)

Called when the value of IsKeyboardFocus property changes.

Parameters

e >The event data for the property change.

protected void OnIsPressedChanged(DependencyPropertyChangedEventArgs e)

Called when the value of IsPressed property changes.

Parameters

e The event data for the property change.

protected void OnLostFocus(RoutedEventArgs e)

Called before the LostFocus event occurs.

Parameters

e The data for the event.

protected void OnLostKeyboardFocus(KeyboardFocusChangedEventArgs e)

Inheritors should override this method to handle custom logic for LostKeyboardFocus event.

Parameters

e KeyboardFocusChangedEventArgs object.

protected void OnMouseEnter(MouseEventArgs e)

Called before MouseEnter event occurs.

Parameters

e The data for the event.

protected void OnMouseLeave(MouseEventArgs e)

Called before the MouseLeave event occurs.

Parameters

e The data for the event.

protected void OnMouseLeftButtonDown(MouseButtonEventArgs e)

Called before the MouseLeftButtonDown event occurs.

Parameters

e The data for the event.

protected void OnMouseLeftButtonUp(MouseButtonEventArgs e)

Called before the MouseLeftButtonUp event occurs.

Parameters

e The data for the event.

protected void OnWatermarkTextVisibilityChanged()

Called when the WatermarkTextVisibility property is changed.

Events

public event ISRoutedEventHandler Closed

Occurs when the dropdown menu of the button is closed.

public event KeyboardFocusChangedEventHandler GotKeyboardFocus

Occurs when the keyboard is focused on this element.

public event KeyboardFocusChangedEventHandler LostKeyboardFocus

Occurs when the keyboard is no longer focused on this element.

public event ISRoutedEventHandler Opened

Occurs when the dropdown menu of the button is opened.

  • No labels