1 changed files with 48 additions and 43 deletions
@ -1,53 +1,58 @@ |
|||||
# ByteUpDown |
# ByteUpDown |
||||
|
|
||||
The ByteUpDown control provides a TextBox with button spinners that allow incrementing and decrementing Nullable<byte> values by using the spinner buttons, keyboard up/down arrows, or mouse wheel. |
The ByteUpDown control provides a TextBox with button spinners that allow incrementing and decrementing Nullable<byte> values by using the spinner buttons, keyboard up/down arrows, or mouse wheel. |
||||
|
|
||||
* [Usage](#usage) |
* [Usage](#usage) |
||||
* [Watermark](#watermarks) |
* [Watermark](#watermark) |
||||
* [Properties](#properties) |
* [Properties](#properties) |
||||
* [Events](#events) |
* [Events](#events) |
||||
{anchor:usage} |
|
||||
## Usage |
### Usage |
||||
|
|
||||
When using the ByteUpDown in data binding scenarios, bind your object's value to the **Value** property. You can specify how much to increment the value by setting the **Increment** property. You can control the minimum and maximum allowed values by setting the **Minimum** and the **Maximum** properties. Use IsReadOnly to determine whether the control is read only. If you would like to get the actual formatted string representation of the value, you can use the **Text** property. |
When using the ByteUpDown in data binding scenarios, bind your object's value to the **Value** property. You can specify how much to increment the value by setting the **Increment** property. You can control the minimum and maximum allowed values by setting the **Minimum** and the **Maximum** properties. Use IsReadOnly to determine whether the control is read only. If you would like to get the actual formatted string representation of the value, you can use the **Text** property. |
||||
{{ |
|
||||
<xctk:ByteUpDown Value="156" />}} |
``` |
||||
{anchor:watermarks} |
<xctk:ByteUpDown Value="156" /> |
||||
## Watermark |
``` |
||||
|
|
||||
|
### Watermark |
||||
You can provide a **Watermark** to show text in place of a NULL **Value**. |
You can provide a **Watermark** to show text in place of a NULL **Value**. |
||||
{{ |
``` |
||||
<xctk:ByteUpDown Watermark="Enter Integer" /> |
<xctk:ByteUpDown Watermark="Enter Integer" /> |
||||
}} |
``` |
||||
{anchor:properties} |
|
||||
## Properties |
### Properties |
||||
|| Property || Description |
| Property | Description | |
||||
| AllowSpin | Gets or sets the ability to perform increment/decrement operations via the keyboard, button spinners, or mouse wheel. (Inherited from UpDownBase) |
| --- | --- | |
||||
| AllowTextInput | Determines if the editable part of the control can be edited. The editable part does not include buttons or spinners, it is typically the text part. |
| AllowSpin | Gets or sets the ability to perform increment/decrement operations via the keyboard, button spinners, or mouse wheel. (Inherited from UpDownBase) | |
||||
| AutoMoveFocus | Gets or sets if the focus can move from this control to other controls. (Inherited from NumericUpDown) |
| AllowTextInput | Determines if the editable part of the control can be edited. The editable part does not include buttons or spinners, it is typically the text part. | |
||||
| AutoSelectBehavior | Gets or sets a value indicating how the content of the auto-select text box is selected (Never or OnFocus). By default, OnFocus. (Inherited from NumericUpDown) |
| AutoMoveFocus | Gets or sets if the focus can move from this control to other controls. (Inherited from NumericUpDown) | |
||||
| ButtonSpinnerLocation | Gets/Sets the location of the Up/Down buttons (either on the left or on the right) of numericUpDown controls. |
| AutoSelectBehavior | Gets or sets a value indicating how the content of the auto-select text box is selected (Never or OnFocus). By default, OnFocus. (Inherited from NumericUpDown) | |
||||
| ClipValueToMinMax | Gets or sets if the value should be clipped when minimum/maximum is reached. (Inherited from UpDownBase) |
| ButtonSpinnerLocation | Gets/Sets the location of the Up/Down buttons (either on the left or on the right) of numericUpDown controls. | |
||||
| CultureInfo | Gets or sets the current CultureInfo. (Inherited from InputBase) |
| ClipValueToMinMax | Gets or sets if the value should be clipped when minimum/maximum is reached. (Inherited from UpDownBase) | |
||||
| DefaultValue | Gets or sets the value to use when the **Value** is null and an increment/decrement operation is performed. (Inherited from UpDownBase) |
| CultureInfo | Gets or sets the current CultureInfo. (Inherited from InputBase) | |
||||
| DisplayDefaultValueOnEmptyText | Gets or sets if the defaultValue should be displayed when the Text is empty. (Inherited from UpDownBase) |
| DefaultValue | Gets or sets the value to use when the **Value** is null and an increment/decrement operation is performed. (Inherited from UpDownBase) | |
||||
| FormatString | Gets or sets the dispaly format of the **Value**. |
| DisplayDefaultValueOnEmptyText | Gets or sets if the defaultValue should be displayed when the Text is empty. (Inherited from UpDownBase) | |
||||
| Increment | Gets or sets the amount in which to increment the value. (Inherited from NumericUpDown) |
| FormatString | Gets or sets the dispaly format of the **Value**. | |
||||
| IsReadOnly | Gets or sets if the control is read only. (Inherited from InputBase) |
| Increment | Gets or sets the amount in which to increment the value. (Inherited from NumericUpDown) | |
||||
| Maximum | Gets or sets the maximum allowed value. (Inherited from UpDownBase) |
| IsReadOnly | Gets or sets if the control is read only. (Inherited from InputBase) | |
||||
| Minimum | Gets or sets the minimum allowed value. (Inherited from UpDownBase) |
| Maximum | Gets or sets the maximum allowed value. (Inherited from UpDownBase) | |
||||
| MouseWheelActiveTrigger | Gets or sets when the MouseWheel is active (Focused, FocusedMouseOver, MouseOver, Disabled). By default, FocusedMouseOver. (Inherited from UpDownBase). |
| Minimum | Gets or sets the minimum allowed value. (Inherited from UpDownBase) | |
||||
| ParsingNumberStyle | Gets or sets the parsing style (AllowLeadingWhite, Float, AllowHexSpecifier, ...). By default, Any. (Inherited from CommonNumericUpDown) |
| MouseWheelActiveTrigger | Gets or sets when the MouseWheel is active (Focused, FocusedMouseOver, MouseOver, Disabled). By default, FocusedMouseOver. (Inherited from UpDownBase) | |
||||
| ShowButtonSpinner | Gets or sets if the ButtonSpinners are visibles. (Inherited from UpDownBase) |
| ParsingNumberStyle | Gets or sets the parsing style (AllowLeadingWhite, Float, AllowHexSpecifier, ...). By default, Any. (Inherited from CommonNumericUpDown) | |
||||
| Text | Gets or sets the formated string representation of the value. (Inherited from InputBase) |
| ShowButtonSpinner | Gets or sets if the ButtonSpinners are visibles. (Inherited from UpDownBase) | |
||||
| TextAlignment | Gets or sets the alignment of the **Text** (Left, Right, Center, Justify). By default, Left. (Inherited from InputBase) |
| Text | Gets or sets the formated string representation of the value. (Inherited from InputBase) | |
||||
| UpdateValueOnEnterKey | Gets or sets a value indicating whether the synchronization between "Value" and "Text" should be done only on the Enter key press (and lost focus). (Inherited from UpDownBase) |
| TextAlignment | Gets or sets the alignment of the **Text** (Left, Right, Center, Justify). By default, Left. (Inherited from InputBase) | |
||||
| Value | Gets or sets the numeric value. (Inherited from UpDownBase) |
| UpdateValueOnEnterKey | Gets or sets a value indicating whether the synchronization between "Value" and "Text" should be done only on the Enter key press (and lost focus). (Inherited from UpDownBase) | |
||||
| Watermark | Gets or sets the object to use as a watermark if the **Value** is null. (Inherited from InputBase) |
| Value | Gets or sets the numeric value. (Inherited from UpDownBase) | |
||||
| WatermarkTemplate| Gets or sets the DatTemplate to use for the **Watermark**. (Inherited from InputBase) |
| Watermark | Gets or sets the object to use as a watermark if the **Value** is null. (Inherited from InputBase) | |
||||
{anchor:events} |
| WatermarkTemplate| Gets or sets the DatTemplate to use for the **Watermark**. (Inherited from InputBase) | |
||||
## Events |
|
||||
|| Event || Description |
### Events |
||||
| InputValidationError | Occurs when the Text cannot be converted to a valid Value. (Inherited from UpDownBase) |
| Event | Description | |
||||
| ValueChanged | Raised when the Value changes. (Inherited from UpDownBase) |
| --- | --- | |
||||
|
| InputValidationError | Occurs when the Text cannot be converted to a valid Value. (Inherited from UpDownBase) | |
||||
**Support this project, check out the [Plus Edition](http://wpftoolkit.com).** |
| ValueChanged | Raised when the Value changes. (Inherited from UpDownBase) | |
||||
--- |
|
||||
|
--- |
||||
|
**Support this project, check out the [Plus Edition](http://wpftoolkit.com).** |
||||
Loading…
Reference in new issue