BrushEditBox Class
Represents a Brush
edit box.
public class BrushEditBox : PartEditBoxBase<Brush>
- Inheritance:
- object Visual UIElement FrameworkElement Control PartEditBoxBase<Brush> object
Constructors
BrushEditBox()
Initializes an instance of the BrushEditBox
class.
public BrushEditBox()
Properties
CanReuseBrush
Gets or sets whether the Brush
value can simply have components like gradient stops updated instead of requiring a new brush to be created on any update.
public bool CanReuseBrush { get; set; }
Property Value
- bool:
true
if theBrush
value can simply have components like gradient stops updated instead of requiring a new brush to be created on any update; otherwise,false
. The default value istrue
.
Remarks
Set this to false
in scenarios where ValueChanged events need to fire on any update, or when binding to Value
using value converters.
HasPopupButtonWhenReadOnly
Gets whether the control should display the popup button when the control is read-only.
protected override bool HasPopupButtonWhenReadOnly { get; }
Property Value
- bool:
true
if the control should display the popup button when the control is read-only; otherwise,false
.
HasSwatch
Gets or sets whether the edit box should display a swatch that previews the Value
.
public bool HasSwatch { get; set; }
Property Value
- bool:
true
if the edit box should display a swatch that previews theValue
; otherwise,false
. The default value istrue
.
HasText
Gets or sets whether the edit box should display a text representation of the Value
.
public bool HasText { get; set; }
Property Value
- bool:
true
if the edit box should display a text representation of theValue
; otherwise,false
. The default value istrue
.
IsAlphaEnabled
Gets or sets whether the alpha channel (transparency) of the brush value colors are enabled.
public bool IsAlphaEnabled { get; set; }
Property Value
- bool:
true
if the alpha channel (transparency) of the brush value colors is enabled; otherwise,false
. The default value istrue
.
Remarks
When disabled, no transparency is supported.
IsGradientAllowed
Gets or sets whether gradient brush values can be entered.
public bool IsGradientAllowed { get; set; }
Property Value
- bool:
true
if gradient brush values can be entered; otherwise,false
. The default value istrue
.
SwatchBrush
Gets the Brush that renders a sample swatch.
SwatchMargin
Gets or sets the Thickness of the margin around the sample swatch.
public Thickness SwatchMargin { get; set; }
Property Value
Methods
ConvertToString(Brush)
Converts the specified value to a string representation.
protected override string ConvertToString(Brush valueToConvert)
Parameter | Type | Description |
---|---|---|
valueToConvert | Brush | The value. |
Returns
- string:
The string representation of the specified value.
CreateIncrementalChangeRequest(IncrementalChangeRequestKind)
Creates an incremental change (spin) request.
protected override IncrementalChangeRequest<Brush> CreateIncrementalChangeRequest(IncrementalChangeRequestKind kind)
Parameter | Type | Description |
---|---|---|
kind | IncrementalChangeRequestKind | The kind of request. |
Returns
- IncrementalChangeRequest<Brush>:
The incremental change (spin) request that was created.
GenerateParts()
Generates the parts for the edit box.
protected override IList<IPart> GenerateParts()
Returns
IsValidValue(Brush)
Returns whether the specified value is valid.
protected override bool IsValidValue(Brush value)
Parameter | Type | Description |
---|---|---|
value | Brush | The value to examine. |
Returns
- bool:
true
if the value is valid; otherwise,false
.
OnApplyTemplate()
Invoked whenever application code or internal processes call ApplyTemplate
.
public override void OnApplyTemplate()
OnIntermediateValueChanged(Brush, Brush)
Invoked when the value of the IntermediateValue
property changes.
protected override void OnIntermediateValueChanged(Brush oldValue, Brush newValue)
Parameter | Type | Description |
---|---|---|
oldValue | Brush | The old value of the property. |
newValue | Brush | The new value of the property. |
RaiseValueChangedEvent()
Raises the ValueChanged event.
protected override void RaiseValueChangedEvent()
ResetValue()
Resets the value to a default value.
protected override void ResetValue()
TryConvertFromString(string, bool, out Brush)
Tries to convert the specified text to a value.
protected override bool TryConvertFromString(string textToConvert, bool canCoerce, out Brush value)
Parameter | Type | Description |
---|---|---|
textToConvert | string | The text. |
canCoerce | bool | Whether the returned value should be coerced to fall within the allowed value range. |
value | Brush | Returns the value for the specified text. |
Returns
- bool:
true
if the text was converted to a value successfully; otherwise,false
.
Events
ValueChanged
Occurs after the Value
property value changes.
Fields
CanReuseBrushProperty
Identifies the CanReuseBrush dependency property. This field is read-only.
public static readonly DependencyProperty CanReuseBrushProperty
HasSwatchProperty
Identifies the HasSwatch dependency property. This field is read-only.
public static readonly DependencyProperty HasSwatchProperty
HasTextProperty
Identifies the HasText dependency property. This field is read-only.
public static readonly DependencyProperty HasTextProperty
IsAlphaEnabledProperty
Identifies the IsAlphaEnabled dependency property. This field is read-only.
public static readonly DependencyProperty IsAlphaEnabledProperty
IsGradientAllowedProperty
Identifies the IsGradientAllowed dependency property. This field is read-only.
public static readonly DependencyProperty IsGradientAllowedProperty
SwatchBrushProperty
Identifies the SwatchBrush dependency property. This field is read-only.
public static readonly DependencyProperty SwatchBrushProperty
SwatchMarginProperty
Identifies the SwatchMargin dependency property. This field is read-only.
public static readonly DependencyProperty SwatchMarginProperty
Inherited Members
- PartEditBoxBase<Brush>.ActivePartIndexProperty
- PartEditBoxBase<Brush>.CommitTriggersProperty
- PartEditBoxBase<Brush>.HasPopupProperty
- PartEditBoxBase<Brush>.InlinesProperty
- PartEditBoxBase<Brush>.InputScopeNameValueProperty
- PartEditBoxBase<Brush>.IntermediateValueProperty
- PartEditBoxBase<Brush>.IsArrowKeyPartNavigationEnabledProperty
- PartEditBoxBase<Brush>.IsEditableProperty
- PartEditBoxBase<Brush>.IsNullAllowedProperty
- PartEditBoxBase<Brush>.IsPopupButtonVisibleProperty
- PartEditBoxBase<Brush>.IsPopupOpenProperty
- PartEditBoxBase<Brush>.IsReadOnlyProperty
- PartEditBoxBase<Brush>.IsSpinnerVisibleProperty
- PartEditBoxBase<Brush>.IsUndoEnabledProperty
- PartEditBoxBase<Brush>.PlaceholderTextProperty
- PartEditBoxBase<Brush>.PopupBackgroundProperty
- PartEditBoxBase<Brush>.PopupBorderBrushProperty
- PartEditBoxBase<Brush>.PopupPickerStyleProperty
- PartEditBoxBase<Brush>.SpinWrappingProperty
- PartEditBoxBase<Brush>.TextAlignmentProperty
- PartEditBoxBase<Brush>.ValueProperty
- PartEditBoxBase<Brush>.IsNonDefaultUsageContextProperty
- PartEditBoxBase<Brush>.SpinnerVisibilityProperty
- PartEditBoxBase<Brush>.UsageContextProperty
- PartEditBoxBase<Brush>.CoerceValidValue(Brush)
- PartEditBoxBase<Brush>.Commit()
- PartEditBoxBase<Brush>.Commit(bool)
- PartEditBoxBase<Brush>.InvalidateParts()
- PartEditBoxBase<Brush>.OnCreateAutomationPeer()
- PartEditBoxBase<Brush>.OnGotFocus(RoutedEventArgs)
- PartEditBoxBase<Brush>.OnIsNullAllowedChanged(bool, bool)
- PartEditBoxBase<Brush>.OnKeyDown(KeyEventArgs)
- PartEditBoxBase<Brush>.OnLostFocus(RoutedEventArgs)
- PartEditBoxBase<Brush>.OnPopupOpened()
- PartEditBoxBase<Brush>.OnValueChanged(Brush, Brush)
- PartEditBoxBase<Brush>.ProcessTextInput(string)
- PartEditBoxBase<Brush>.SelectAll()
- PartEditBoxBase<Brush>.UpdateIntermediateValueAndTextFromValue()
- PartEditBoxBase<Brush>.OnIsKeyboardFocusWithinChanged(DependencyPropertyChangedEventArgs)
- PartEditBoxBase<Brush>.OnLostMouseCapture(MouseEventArgs)
- PartEditBoxBase<Brush>.OnMouseLeftButtonDown(MouseButtonEventArgs)
- PartEditBoxBase<Brush>.OnPreviewMouseUp(MouseButtonEventArgs)
- PartEditBoxBase<Brush>.OnPreviewTextInput(TextCompositionEventArgs)
- PartEditBoxBase<Brush>.ActivePartIndex
- PartEditBoxBase<Brush>.CommitTriggers
- PartEditBoxBase<Brush>.CurrentSelectionLength
- PartEditBoxBase<Brush>.CurrentSelectionStartOffset
- PartEditBoxBase<Brush>.CurrentText
- PartEditBoxBase<Brush>.HasPopup
- PartEditBoxBase<Brush>.Inlines
- PartEditBoxBase<Brush>.InputScopeNameValue
- PartEditBoxBase<Brush>.IntermediateValue
- PartEditBoxBase<Brush>.IsArrowKeyPartNavigationEnabled
- PartEditBoxBase<Brush>.IsEditable
- PartEditBoxBase<Brush>.IsNullAllowed
- PartEditBoxBase<Brush>.IsPopupButtonVisible
- PartEditBoxBase<Brush>.IsPopupOpen
- PartEditBoxBase<Brush>.IsReadOnly
- PartEditBoxBase<Brush>.IsSpinnerVisible
- PartEditBoxBase<Brush>.IsUndoEnabled
- PartEditBoxBase<Brush>.Parts
- PartEditBoxBase<Brush>.PlaceholderText
- PartEditBoxBase<Brush>.PopupBackground
- PartEditBoxBase<Brush>.PopupBorderBrush
- PartEditBoxBase<Brush>.PopupPickerStyle
- PartEditBoxBase<Brush>.ResetValueCommand
- PartEditBoxBase<Brush>.SmallDecrementValueCommand
- PartEditBoxBase<Brush>.SmallIncrementValueCommand
- PartEditBoxBase<Brush>.SpinWrapping
- PartEditBoxBase<Brush>.TextAlignment
- PartEditBoxBase<Brush>.Value
- PartEditBoxBase<Brush>.IsNonDefaultUsageContext
- PartEditBoxBase<Brush>.SpinnerVisibility
- PartEditBoxBase<Brush>.UsageContext