Updated Wiki: CheckComboBox

June 6, 2014, 10:37 am

≫ Next: Updated Wiki: CheckListBox

≪ Previous: Updated Wiki: AvalonDock

$

0

0

CheckComboBox

Derives from Xceed.Wpf.Toolkit.Primitives.Selector

CheckComboBox is a combo box in which the items in the dropdown are preceded by a checkbox. As items are checked or unchecked, the Text property displayed above the dropdown is updated using the concatenated string representations of the checked items. The text displayed is formated using the value of the Delimiter property to separate the individual strings.

<xctk:CheckComboBox x:Name="_combo" 
                             HorizontalAlignment="Center" 
                             VerticalAlignment="Center" 
                             DisplayMemberPath="Color"
                             ValueMemberPath="Level"
                             SelectedValue="{Binding SelectedValue}"
                             SelectedItems="{Binding SelectedItems}" />

Properties / Events

Property	Description
Command	Gets or sets the command to execute when an item is checked/unchecked. (Inherited from Selector)
Delimiter	Gets or sets the string used to separate the concatenated string representations of the checked items. (Inherited from Selector)
IsDropDownOpen	Gets or sets a value indicating whether the combo box drop-down is currently open.
MaxDropDownHeight	Gets or sets the maximum height of the popup.
SelectedItem	Gets or sets the last checked item. (Inherited from Selector)
SelectedItems	Gets the collection of checked items. (Inherited from Selector)
SelectedItemsOverride	Gets or sets the list of SelectedItems. (Inherited from Selector)
SelectedMemberPath	Gets or sets a path to a value on the source object used to determine whether an item is selected. (Inherited from Selector)
SelectedValue	Gets or sets a string containing the selected items separated by the value of Delimiter (ex., "Item1, Item2, Item3"). (Inherited from Selector)
Text	Gets or sets the formated text of the currently checked items.
ValueMemberPath	Gets or sets a path to a value on the source object representing the value to use. (Inherited from Selector)

Event	Description
ItemSelectionChanged	Raised when an item's selection is changed. (Inherited from Selector)

Support this project, check out the Plus Edition.
---

---

Updated Wiki: CheckListBox

June 6, 2014, 10:37 am

≫ Next: Updated Wiki: Charts

≪ Previous: Updated Wiki: CheckComboBox

$

0

0

CheckListBox

Derives from Xceed.Wpf.Toolkit.Primitives.Selector

The CheckListBox control is a ListBox in which each item is represented with a CheckBox. The CheckBox.IsSelected can be data bound using the SelectedMemberPath property. The CheckListBox also provides a Command property which will execute everytime an item is checked/unchecked. The CommandParameter is the recently checked/unchecked item.

NOTE: As of v1.6.0, this control derives from Selector.

<xctk:CheckListBox x:Name="_listBox" 
                            Height="250"
                            DisplayMemberPath="Color"
                            ValueMemberPath="Level" 
                            SelectedMemberPath="IsSelected"
                            SelectedValue="{Binding SelectedValue}"
                            SelectedItemsOverride="{Binding SelectedItems}" />

Properties / Events

Property	Description
Command	Gets or sets the command to execute when an item is checked/unchecked. (Inherited from Selector)
Delimiter	Gets or sets the string used to separate the concatenated string representations of the checked items. (Inherited from Selector)
SelectedItem	Gets or sets the last checked item. (Inherited from Selector)
SelectedItems	Gets the collection of checked items. (Inherited from Selector)
SelectedItemsOverride	Gets or sets the list of SelectedItems. (Inherited from Selector)
SelectedMemberPath	Gets or sets a path to a value on the source object used to determine whether an item is selected. (Inherited from Selector)
SelectedValue	Gets or sets a string containing the selected items separated by the value of Delimiter (ex., "Item1, Item2, Item3"). (Inherited from Selector)
ValueMemberPath	Gets or sets a path to a value on the source object representing the value to use. (Inherited from Selector)

Event	Description
ItemSelectionChanged	Raised when an item's selection is changed. (Inherited from Selector)

Support this project, check out the Plus Edition.
---

Updated Wiki: Charts

June 6, 2014, 10:50 am

≫ Next: Updated Wiki: Home

≪ Previous: Updated Wiki: CheckListBox

$

0

0

Charts

Only available in the Plus Edition

Derives from Control

Chart control is designed to display rich, flexible, configurable and extendable charts. Wpf Chart is 100% look-less control. Chart is able to display multiple areas with multiple charts at the same time. Use Areas property to add Area objects. Chart supports build-in legend. However, if custom legend needed to be displayed, Use Legend property to apply custom legend to chart.

• Properties
• Events
• Area
  • Properties
  • Methods
  • Events
• Series
  • Properties
  • Methods
• Axis
  • Properties
  • Methods
  • Events

Properties

Property	Description
Areas	Gets list of Area
Legend	Gets or sets Chart Legend.
ShowLegend	Gets or sets if chart legend is visible.

Events

Event	Description
SeriesChanged	Raised when Series list in any Area is changed.

Area

Derives from Panel

Used to display charts and a grid with axes and labels.

Properties

Property	Description
Title	Gets or sets Area title.
XAxis	Gets or sets X axis.
YAxis	Gets or sets Y axis.
Series	Gets or sets list of Series
LayoutBounds	Gets layout bounds for series interior.
BackgroundTemplate	Gets or sets data template for grid representation.

Methods

Method	Description
GetSeriesLayoutBounds()	Calculates layout bounds without tick and tittle labels.
Invalidate()	Invalidates Area and all it's children.
GetActualPoint( Point point )	Converts point in user logic coordinates into actual pixels point.
GetActualPoint( DataPoint point )	Converts DataPoint into actual pixels point.
HighlightSeries( Series series, bool highlighted )	Sets highlighted state for specified series.

Events

Event	Description
LegendRefresh	Raised when need legend items refresh.

Series

Derives from DependencyObject

Displays a list of DataPoint primitives in an Area of a Chart.

Properties

Property	Description
ShowHintLabels	Gets or Sets, show hint labels for series elements or not.
ShowPointsInLegend	If true, DataPoints from this Series are displayed in legend.
IsOwnerHighlight	Gets or Sets, is this Series performing highlight of it's child elements manually or not.
MarkerTemplate	Gets or Sets DataTemplate for Markers.
Template	Gets or Sets DataTemplate for this Series elements.
HintLabelTemplate	Gets or sets hint label template for elements of this series.
HintLineTemplate	Gets or sets hint line template for elements of this series.
HintLineLength	Gets or sets hint line length.
Title	Gets or Sets Series Title. Displayed in LegendItem
Spacing	Gets or Sets Spacing between series elements. this value is % relative to element width. Example: if for Column layout type spacing is 20, then column width is 80.
Layout	Gets or Sets LayoutEngine for this Series, that will layout this Series.
DefaultInterior	Gets or Sets default interior color for series elements.
Area	Gets parent Area
DataPointBindings	Gets list of BindingInfo objects. Add BindingInfo objects to this list to set up binding for DataPoints.
DataPointsSource	Gets or Sets binding source for DataPoints.
DataPoints	Gets or sets list of DataPoint.
LayoutPrimitives	Gets list of ChartPrimitive for layout elements.
LayoutHints	Gets list of ChartPrimitive for layout hints.

Methods

Method	Description
ApplyDefaultTemplate()	Applies default DataTemplates for series elements.
GetSortedPoints()	Gets array of DataPoints contained in this series, sorted if needed.
Reset()	Clears list of chart primitives.

Axis

Derives from Xceed.Wpf.Toolkit.Chart.GridLine

Represents an axis.

Properties

Property	Description
LabelsType	Gets or sets type of tick labels.
DateTimeFormatInfo	Gets or sets DateTime format, uses to convert DateTime to labels text in LabelsType.DateTime mode.
DateTimeFormat	Gets or sets DateTime format. Used from convert DateTime to labels text in LabelsType.DateTime mode.
Location	Gets start point of axis line.
ScaleMode	Gets or sets scale mode of the axis.
GraduationMode	Gets or sets graduation mode of the axis.
CustomRangeStart	Gets or sets custom start point for manual scale mode.
CustomRangeEnd	Gets or sets custom end point for manual scale mode.
TickLabels	Gets list of tick labels.
TicksCount	Gets or sets the count of ticks.
TitleMargin	Gets or sets the margin between title label and axis line.
TickList	Gets collection of ticks.
GridLines	Gets collection of grid lines.
ShowArrow	Gets or sets the visibility of the arrow.
ShowAxis	Gets or sets the visibility of the axis.
ShowGridLines	Gets or sets the visibility of grid lines.
ShowTicks	Gets or sets the visibility of ticks.
ShowTickLabels	Gets or sets the visibility of tick labels.
ShowAxisLabel	Gets or sets the visibility of the axis label.
Reversed	Gets or sets indicator of the axis revertion.
Range	Gets or sets range of the axis.
GridTemplate	Gets or sets data template for grid lines representation.
TickTemplate	Gets or sets data template for ticks representation.
ArrowTemplate	Gets or sets data template for arrow representation.
LabelTemplate	Gets or sets data template for labels representation.
Arrow	Gets or sets instance of the axis arrow.
Title	Gets or sets text for title label.
AxisTitleTemplate	Gets or sets data template for axis labels representation.
AxisLabelsLayout	Gets or sets axis labels style of layout.
GridPoint	Gets layout point used to calculate position of the element. (Inherited from GridLine)
Orientation	Gets or sets orientation of the grid line. (Inherited from GridLine)
Info	Gets or Sets binding source object for this primitive. (Inherited from ChartPrimitive)
IsHighlighted	Gets or Sets, is primitive highlighted or not. (Inherited from ChartPrimitive)
IsCovered	Gets or Sets is primitive "covered" or not. "Covered" means this primitive is not highlighted, but some other primitive is highlighted.
DataPoint	Gets DataPoint corresponding to this primitive. (Inherited from ChartPrimitive)

Methods

Method	Description
GetRealPoint( double pt )	Converts point in user logic coordinates into point in actual pixels.
Reset()	Resets layout.
SetTitlesDirection( DataRange layoutRange, bool layoutReversed )	Sets direction of the tick labels.
PerformGraduation()	Performs graduation of the axis.
PerformCustomRangeGraduation()	Perform graduation for custom range in manual scale mode.

Events

Event	Description
HighlightEnter	Raised when primitive gets highlighted. (Inheridted from ChartPrimitive)
HighlightLeave	Raised when primitive gets un-highlighted. (Inherited from ChartPrimtive)

---

Updated Wiki: Home

June 6, 2014, 11:00 am

≫ Next: Updated Wiki: Home

≪ Previous: Updated Wiki: Charts

$

0

0

June 2014 update: v2.2.0 of the Community Edition released with two new controls and 15 bug fixes and improvements. Subscribers of the Plus Edition got an additional two new controls in v2.2.0, and have just received v2.3.0 with a new control and 30 new bug fixes and improvements (see list).



Extended WPF Toolkit™ is the number one collection of WPF controls, components and utilities for creating next generation Windows applications. Use it to build professional looking, modern, and easy to use line of business applications. The Extended WPF Toolkit project has been downloaded more than 250,000 times here and on Nuget.

The free, open source Community Edition is provided under the Microsoft Public License. The controls included in each edition are:

Community Edition
AvalonDock	AutoSelectTextBox	BusyIndicator	ButtonSpinner
ByteUpDown	Calculator	CalculatorUpDown	CheckComboBox
CheckListBox	ChildWindow	CollectionEditor	CollectionControlDialog
ColorCanvas	ColorPicker	DataGrid	DateTimePicker
DateTimeUpDown	DecimalUpDown	DoubleUpDown	DropDownButton
IntegerUpDown	LongUpDown	Magnifier	MaskedTextBox
MessageBox	MultiLineTextEditor	PieChart	PrimitiveTypeCollEditor
PropertyGrid	RangeSlider	RichTextBox	RichTextBoxFormatBar
SplitButton	SwitchPanel	TimelinePanel	TimePicker
TimeSpanUpDown	ValueRangeTextBox	WatermarkTextBox	WindowContainer
WindowControl	Wizard	Zoombox	Windows 8 Theme
Plus Edition
Charts	ChildWindow Plus	MultiColumnComboBox	Pileflow
PropertyGrid Plus	RadialGauge	Rating	StylableWindow
SwitchPanel Plus	ToggleSwitch	Ultimate ListBox	Metro theme
Office theme	Technical support	1 release ahead

Upgrade to Extended WPF Toolkit Plus to be at least one release ahead of the Community Edition, get even more controls and features, and fast, professional support. Update to Xceed Business Suite for WPF to get an even more full-featured version of the industry's best datagrid.

Latest News

New Live Explorer app available online as a Click Once app. Try it now!.

 

You can purchase with bitcoins and get a 1-year, 1-developer subscription for the Plus Edition for 500000 bits (0.5 BTC). Just scroll down to the bottom of any page on http://wpftoolkit.com and select 'Pay with Bitcoin'.

• June. 2014, released Plus Edition v2.3.0 containing a new controls and 30 bug fixes and improvements. Released Community Edition v2.2.0, containing two new controls and 15 bug fixes and improvements (see list).
• Feb. 2014, released Plus Edition v2.2.0 containing 4 new controls and 20 bug fixes and improvements. Released Community Edition v2.1.0, containing 70 bug fixes and improvements (see list).

 

Action items

• Enjoy WPF!
• Please rate this release and write something positive. It's at the bottom of the downloads page
• Follow this project (click "follow" at the top right of this page)
• Follow @datagrid on Twitter for WPF and Toolkit news
• Like Xceed's WPF page on Facebook
• Check out a video or two on XceedVideos YouTube Channel
• Add bugs or feature requests to the Issue Tracker

Updated Wiki: Home

June 6, 2014, 11:08 am

≫ Next: Updated Wiki: DecimalUpDown

≪ Previous: Updated Wiki: Home

$

0

0

June 2014 update: v2.2.0 of the Community Edition released with two new controls and 15 bug fixes and improvements. Subscribers of the Plus Edition got an additional two new controls in v2.2.0, and have just received v2.3.0 with a new control and 30 new bug fixes and improvements (see list).



Extended WPF Toolkit™ is the number one collection of WPF controls, components and utilities for creating next generation Windows applications. Use it to build professional looking, modern, and easy to use line of business applications. The Extended WPF Toolkit project has been downloaded more than 250,000 times here and on Nuget.

The free, open source Community Edition is provided under the Microsoft Public License. The Plus Edition adds additional controls, features, pro support, and is one release version ahead. The Business Suite for WPF adds the full-featured version of the industry's best datagrid.

The controls included in each edition are:

Community Edition
AvalonDock	AutoSelectTextBox	BusyIndicator	ButtonSpinner
ByteUpDown	Calculator	CalculatorUpDown	CheckComboBox
CheckListBox	ChildWindow	CollectionEditor	CollectionControlDialog
ColorCanvas	ColorPicker	DataGrid	DateTimePicker
DateTimeUpDown	DecimalUpDown	DoubleUpDown	DropDownButton
IntegerUpDown	LongUpDown	Magnifier	MaskedTextBox
MessageBox	MultiLineTextEditor	PieChart	PrimitiveTypeCollEditor
PropertyGrid	RangeSlider	RichTextBox	RichTextBoxFormatBar
SplitButton	SwitchPanel	TimelinePanel	TimePicker
TimeSpanUpDown	ValueRangeTextBox	WatermarkTextBox	WindowContainer
WindowControl	Wizard	Zoombox	Windows 8 Theme
Plus Edition
Charts	ChildWindow Plus	MultiColumnComboBox	Pileflow
PropertyGrid Plus	RadialGauge	Rating	StylableWindow
SwitchPanel Plus	ToggleSwitch	Ultimate ListBox	Metro theme
Office theme	Technical support	1 release ahead
Business Suite for WPF
Advanced DataGrid	3D Views for WPF	Blendables for WPF	More themes

Latest News

New Live Explorer app available online as a Click Once app. Try it now!.

 

You can purchase with bitcoins and get a 1-year, 1-developer subscription for the Plus Edition for 500000 bits (0.5 BTC). Just scroll down to the bottom of any page on http://wpftoolkit.com and select 'Pay with Bitcoin'.

• June. 2014, released Plus Edition v2.3.0 containing a new controls and 30 bug fixes and improvements. Released Community Edition v2.2.0, containing two new controls and 15 bug fixes and improvements (see list).
• Feb. 2014, released Plus Edition v2.2.0 containing 4 new controls and 20 bug fixes and improvements. Released Community Edition v2.1.0, containing 70 bug fixes and improvements (see list).

 

Action items

• Enjoy WPF!
• Please rate this release and write something positive. It's at the bottom of the downloads page
• Follow this project (click "follow" at the top right of this page)
• Follow @datagrid on Twitter for WPF and Toolkit news
• Like Xceed's WPF page on Facebook
• Check out a video or two on XceedVideos YouTube Channel
• Add bugs or feature requests to the Issue Tracker

Updated Wiki: DecimalUpDown

June 6, 2014, 11:22 am

≫ Next: Updated Wiki: DoubleUpDown

≪ Previous: Updated Wiki: Home

$

0

0

DecimalUpDown

The DecimalUpDown control provides a TextBox with button spinners that allow incrementing and decrementing Nullable<Decimal> values by using the spinner buttons, keyboard up/down arrows, or mouse wheel.

• Usage
• Applying Format Strings
• Supported Format Strings
• Watermark
• Properties/Events

Usage

When using the DecimalUpDown 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.

Applying FormatStrings

Default:

<xctk:DecimalUpDown Value="1564.6749586" />

Floating Point:

<xctk:DecimalUpDown FormatString="F3" Value="1564.6749586" Increment=".001"  Maximum="200000.599" />

Currency:

<xctk:DecimalUpDown FormatString="C2" Value="1564.6749586" Increment=".5" Maximum="5000.50" Minimum="50.01" />

Supported Format Strings

Format Specifier	Name
C	Currency
F	Fixed Point
G	General
N	Number
P	Percent

Watermark

You can provide a Watermark to show text in place of a NULL Value.

<xctk:DecimalUpDown Watermark="Enter Decimal" />

Properties / Events

Property	Description
AllowSpin	Gets or sets the ability to perform increment/decrement operations via the keyboard, button spinners, or mouse wheel.
CultureInfo	Gets or sets the current CultureInfo.
DefaultValue	Gets or sets the value to use when the Value is null and an increment/decrement operation is performed.
FormatString	Gets or sets the dispaly format of the Value.
Increment	Gets or sets the amount in which to increment the value.
IsReadOnly	Gets or sets a value indicating whether the control is read only.
Maximum	Gets or sets the maximum allowed value.
Mimum	Gets or sets the minimum allowed value.
MouseWheelActiveOnFocus	Gets or sets if the control must have focus in order for the mouse wheel to incement/decrement the value. By default, True.
SelectAllOnGotFocus	Gets or sets if all text is selected when control gets focus.
ShowButtonSpinner	Gets or sets if the button spinners are visible.
Text	Gets or sets the formatted string representation of the value.
TextAlignment	Gets or sets the alignment of the Text
Value	Gets or sets the numeric value.
Watermark	Gets or sets the object to use as a watermark if the Value is null.
WatermarkTemplate	Gets or sets the DataTemplate to use for the Watermark.

Event	Description
ValueChanged	Raised when the Value changes.

Support this project, check out the Plus Edition.
---

Updated Wiki: DoubleUpDown

June 6, 2014, 11:25 am

≫ Next: Updated Wiki: IntegerUpDown

≪ Previous: Updated Wiki: DecimalUpDown

$

0

0

DoubleUpDown

The DoubleUpDown control provides a TextBox with button spinners that allow incrementing and decrementing Nullable<Double> values by using the spinner buttons, keyboard up/down arrows, or mouse wheel.

• Usage
• Applying Format Strings
• Supported Format Strings
• Watermark
• Properties/Events

Usage

When using the DoubleUpDown 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.

Applying FormatStrings

Default:

<xctk:DoubleUpDown Value="1564.6749586" />

Floating Point:

<xctk:DoubleUpDown FormatString="F3" Value="1564.6749586" Increment=".001"  Maximum="200000.599" />

Currency:

<xctk:DoubleUpDown FormatString="C2" Value="1564.6749586" Increment=".5" Maximum="5000.50" Minimum="50.01" />

Supported Format Strings

Format Specifier	Name
C	Currency
F	Fixed Point
G	General
N	Number
P	Percent

Watermark

You can provide a Watermark to show text in place of a NULL Value.

<xctk:DoubleUpDown Watermark="Enter Double" />

Properties / Events

Property	Description
AllowSpin	Gets or sets the ability to perform increment/decrement operations via the keyboard, button spinners, or mouse wheel.
CultureInfo	Gets or sets the current CultureInfo.
DefaultValue	Gets or sets the value to use when the Value is null and an increment/decrement operation is performed.
FormatString	Gets or sets the dispaly format of the Value.
Increment	Gets or sets the amount in which to increment the value.
IsReadOnly	Gets or sets a value indicating whether the control is read only.
Maximum	Gets or sets the maximum allowed value.
Mimum	Gets or sets the minimum allowed value.
MouseWheelActiveOnFocus	Gets or sets if the control must have focus in order for the mouse wheel to incement/decrement the value. True by default.
SelectAllOnGotFocus	Gets or sets if all text is selected when control gets focus.
ShowButtonSpinner	Gets or sets if the button spinners are visible.
Text	Gets or sets the formatted string representation of the value.
TextAlignment	Gets or sets the alignment of the Text
Value	Gets or sets the numeric value.
Watermark	Gets or sets the object to use as a watermark if the Value is null.
WatermarkTemplate	Gets or sets the DataTemplate to use for the Watermark.

Event	Description
ValueChanged	Raised when the Value changes.

Support this project, check out the Plus Edition.
---

Updated Wiki: IntegerUpDown

June 6, 2014, 11:27 am

≫ Next: Updated Wiki: LongUpDown

≪ Previous: Updated Wiki: DoubleUpDown

$

0

0

IntegerUpDown

The IntegerUpDown control provides a TextBox with button spinners that allow incrementing and decrementing Nullable<int> values by using the spinner buttons, keyboard up/down arrows, or mouse wheel.

• Usage
• Applying Format Strings
• Supported Format Strings
• Watermark
• Properties/Events

Usage

When using the IntegerUpDown 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.

Applying FormatStrings

Default:

<xctk:IntegerUpDown Value="1564" />

Number:

<xctk:IntegerUpDown FormatString="N0" Value="1564" Increment="1" Maximum="200000"/>

Currency:

<xctk:IntegerUpDown FormatString="C0" Value="1564" Increment="1" Maximum="5000" Minimum="50"/>

Supported Format Strings

Format Specifier	Name
C	Currency
F	Fixed Point
G	General
N	Number
P	Percent

Watermark

You can provide a Watermark to show text in place of a NULL Value.

<xctk:IntegerUpDown Watermark="Enter Integer" />

Properties / Events

Property	Description
AllowSpin	Gets or sets the ability to perform increment/decrement operations via the keyboard, button spinners, or mouse wheel.
CultureInfo	Gets or sets the current CultureInfo.
DefaultValue	Gets or sets the value to use when the Value is null and an increment/decrement operation is performed.
FormatString	Gets or sets the display format of the Value.
Increment	Gets or sets the amount in which to increment the value.
IsReadOnly	Gets or sets a value indicating whether the control is read only.
Maximum	Gets or sets the maximum allowed value.
Mimum	Gets or sets the minimum allowed value.
MouseWheelActiveOnFocus	Gets or sets if the control must have focus in order for the mouse wheel to incement/decrement the value. True by default.
SelectAllOnGotFocus	Gets or sets if all text is selected when control gets focus.
ShowButtonSpinner	Gets or sets if the button spinners are visible.
Text	Gets or sets the formatted string representation of the value.
TextAlignment	Gets or sets the alignment of the Text.
Value	Gets or sets the numeric value.
Watermark	Gets or sets the object to use as a watermark if the Value is null.
WatermarkTemplate	Gets or sets the DataTemplate to use for the Watermark.

Event	Description
ValueChanged	Raised when the Value changes.

Support this project, check out the Plus Edition.
---

---

Updated Wiki: LongUpDown

June 6, 2014, 11:29 am

≫ Next: Updated Wiki: Charts

≪ Previous: Updated Wiki: IntegerUpDown

$

0

0

LongUpDown

The LongUpDown control provides a TextBox with button spinners that allow incrementing and decrementing Nullable<long> values by using the spinner buttons, keyboard up/down arrows, or mouse wheel.

• Usage
• Watermark
• Properties/Events

Usage

When using the LongUpDown 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:LongUpDown Value="156" />

Watermark

You can provide a Watermark to show text in place of a NULL Value.

<xctk:LongUpDown Watermark="Enter value" />

Properties / Events

Property	Description
AllowSpin	Gets or sets the ability to perform increment/decrement operations via the keyboard, button spinners, or mouse wheel.
CultureInfo	Gets or sets the current CultureInfo.
DefaultValue	Gets or sets the value to use when the Value is null and an increment/decrement operation is performed.
FormatString	Gets or sets the display format of the Value.
Increment	Gets or sets the amount in which to increment the value.
IsReadOnly	Gets or sets a value indicating whether the control is read only.
Maximum	Gets or sets the maximum allowed value.
Mimum	Gets or sets the minimum allowed value.
MouseWheelActiveOnFocus	Gets or sets if the control must have focus in order for the mouse wheel to incement/decrement the value. True by default.
SelectAllOnGotFocus	Gets or sets if all text is selected when control gets focus.
ShowButtonSpinner	Gets or sets if the button spinners are visible.
Text	Gets or sets the formatted string representation of the value.
TextAlignment	Gets or sets the alignment of the Text.
Value	Gets or sets the numeric value.
Watermark	Gets or sets the object to use as a watermark if the Value is null.
WatermarkTemplate	Gets or sets the DataTemplate to use for the Watermark.

Event	Description
ValueChanged	Raised when the Value changes.

Support this project, check out the Plus Edition.
---

Updated Wiki: Charts

June 6, 2014, 12:12 pm

≫ Next: Updated Wiki: Area

≪ Previous: Updated Wiki: LongUpDown

$

0

0

Charts

Only available in the Plus Edition

Derives from Control

The Chart control is designed to display rich, flexible, configurable and extendable charts. The Wpf Chart is 100% look-less control, and is able to display multiple areas with multiple charts at the same time. Use the Areas property to add Area objects. The Chart supports a built-in legend. However, you can use the Legend property if a custom legend needs to be displayed.

Properties

Property	Description
Areas	Gets list of Area
Legend	Gets or sets Chart Legend.
ShowLegend	Gets or sets if chart legend is visible.

Events

Event	Description
SeriesChanged	Raised when Series list in any Area is changed.

---

Updated Wiki: Area

June 6, 2014, 12:13 pm

≫ Next: Updated Wiki: Series

≪ Previous: Updated Wiki: Charts

$

0

0

Area

Derives from Panel

Used to display charts and a grid with axes and labels. Use the Series property to specify the list of DataPoints.

Properties

Property	Description
Title	Gets or sets Area title.
XAxis	Gets or sets X Axis.
YAxis	Gets or sets Y Axis.
Series	Gets or sets list of Series
LayoutBounds	Gets layout bounds for series interior.
BackgroundTemplate	Gets or sets data template for grid representation.

Methods

Method	Description
GetSeriesLayoutBounds()	Calculates layout bounds without tick and tittle labels.
Invalidate()	Invalidates Area and all it's children.
GetActualPoint( Point point )	Converts point in user logic coordinates into actual pixels point.
GetActualPoint( DataPoint point )	Converts DataPoint into actual pixels point.
HighlightSeries( Series series, bool highlighted )	Sets highlighted state for specified series.

Events

Event	Description
LegendRefresh	Raised when need legend items refresh.

---

Updated Wiki: Series

June 6, 2014, 12:13 pm

≫ Next: Updated Wiki: Axis

≪ Previous: Updated Wiki: Area

$

0

0

Series

Derives from DependencyObject

Displays a list of DataPoint primitives in an Area of a Chart.

Properties

Property	Description
ShowHintLabels	Gets or Sets, show hint labels for series elements or not.
ShowPointsInLegend	If true, DataPoints from this Series are displayed in legend.
IsOwnerHighlight	Gets or Sets, is this Series performing highlight of it's child elements manually or not.
MarkerTemplate	Gets or Sets DataTemplate for Markers.
Template	Gets or Sets DataTemplate for this Series elements.
HintLabelTemplate	Gets or sets hint label template for elements of this series.
HintLineTemplate	Gets or sets hint line template for elements of this series.
HintLineLength	Gets or sets hint line length.
Title	Gets or Sets Series Title. Displayed in LegendItem
Spacing	Gets or Sets Spacing between series elements. this value is % relative to element width. Example: if for Column layout type spacing is 20, then column width is 80.
Layout	Gets or Sets LayoutEngine for this Series, that will layout this Series.
DefaultInterior	Gets or Sets default interior color for series elements.
Area	Gets parent Area
DataPointBindings	Gets list of BindingInfo objects. Add BindingInfo objects to this list to set up binding for DataPoints.
DataPointsSource	Gets or Sets binding source for DataPoints.
DataPoints	Gets or sets list of DataPoint.
LayoutPrimitives	Gets list of ChartPrimitive for layout elements.
LayoutHints	Gets list of ChartPrimitive for layout hints.

Methods

Method	Description
ApplyDefaultTemplate()	Applies default DataTemplates for series elements.
GetSortedPoints()	Gets array of DataPoints contained in this series, sorted if needed.
Reset()	Clears list of chart primitives.

---

Updated Wiki: Axis

June 6, 2014, 12:14 pm

≫ Next: Updated Wiki: Charts

≪ Previous: Updated Wiki: Series

$

0

0

Axis

Derives from Xceed.Wpf.Toolkit.Chart.GridLine

Represents an axis.

Properties

Property	Description
LabelsType	Gets or sets type of tick labels.
DateTimeFormatInfo	Gets or sets DateTime format, uses to convert DateTime to labels text in LabelsType.DateTime mode.
DateTimeFormat	Gets or sets DateTime format. Used from convert DateTime to labels text in LabelsType.DateTime mode.
Location	Gets start point of axis line.
ScaleMode	Gets or sets scale mode of the axis.
GraduationMode	Gets or sets graduation mode of the axis.
CustomRangeStart	Gets or sets custom start point for manual scale mode.
CustomRangeEnd	Gets or sets custom end point for manual scale mode.
TickLabels	Gets list of tick labels.
TicksCount	Gets or sets the count of ticks.
TitleMargin	Gets or sets the margin between title label and axis line.
TickList	Gets collection of ticks.
GridLines	Gets collection of grid lines.
ShowArrow	Gets or sets the visibility of the arrow.
ShowAxis	Gets or sets the visibility of the axis.
ShowGridLines	Gets or sets the visibility of grid lines.
ShowTicks	Gets or sets the visibility of ticks.
ShowTickLabels	Gets or sets the visibility of tick labels.
ShowAxisLabel	Gets or sets the visibility of the axis label.
Reversed	Gets or sets indicator of the axis revertion.
Range	Gets or sets range of the axis.
GridTemplate	Gets or sets data template for grid lines representation.
TickTemplate	Gets or sets data template for ticks representation.
ArrowTemplate	Gets or sets data template for arrow representation.
LabelTemplate	Gets or sets data template for labels representation.
Arrow	Gets or sets instance of the axis arrow.
Title	Gets or sets text for title label.
AxisTitleTemplate	Gets or sets data template for axis labels representation.
AxisLabelsLayout	Gets or sets axis labels style of layout.
GridPoint	Gets layout point used to calculate position of the element. (Inherited from GridLine)
Orientation	Gets or sets orientation of the grid line. (Inherited from GridLine)
Info	Gets or Sets binding source object for this primitive. (Inherited from ChartPrimitive)
IsHighlighted	Gets or Sets, is primitive highlighted or not. (Inherited from ChartPrimitive)
IsCovered	Gets or Sets is primitive "covered" or not. "Covered" means this primitive is not highlighted, but some other primitive is highlighted.
DataPoint	Gets DataPoint corresponding to this primitive. (Inherited from ChartPrimitive)

Methods

Method	Description
GetRealPoint( double pt )	Converts point in user logic coordinates into point in actual pixels.
Reset()	Resets layout.
SetTitlesDirection( DataRange layoutRange, bool layoutReversed )	Sets direction of the tick labels.
PerformGraduation()	Performs graduation of the axis.
PerformCustomRangeGraduation()	Perform graduation for custom range in manual scale mode.

Events

Event	Description
HighlightEnter	Raised when primitive gets highlighted. (Inheridted from ChartPrimitive)
HighlightLeave	Raised when primitive gets un-highlighted. (Inherited from ChartPrimtive)

---

Updated Wiki: Charts

June 6, 2014, 12:21 pm

≫ Next: Updated Wiki: Area

≪ Previous: Updated Wiki: Axis

$

0

0

Charts

Only available in the Plus Edition

Derives from Control

The Chart control is designed to display rich, flexible, configurable and extendable charts. The Wpf Chart is 100% look-less control, and is able to display multiple areas with multiple charts at the same time. Use the Areas property to add Area objects. The Chart supports a built-in legend. However, you can use the Legend property if a custom legend needs to be displayed.

• Area
  • Series
  • Axis

Properties

Property	Description
Areas	Gets list of Area
Legend	Gets or sets Chart Legend.
ShowLegend	Gets or sets if chart legend is visible.

Events

Event	Description
SeriesChanged	Raised when Series list in any Area is changed.

---

Updated Wiki: Area

June 6, 2014, 12:23 pm

≫ Next: Updated Wiki: Area

≪ Previous: Updated Wiki: Charts

$

0

0

Area

Derives from Panel

Used to display charts and a grid with axes and labels. Use the Series property to specify the list of DataPoints.

• Series
• Axis

Properties

Property	Description
Title	Gets or sets Area title.
XAxis	Gets or sets X axis.
YAxis	Gets or sets Y axis.
Series	Gets or sets list of Series.
LayoutBounds	Gets layout bounds for series interior.
BackgroundTemplate	Gets or sets data template for grid representation.

Methods

Method	Description
GetSeriesLayoutBounds()	Calculates layout bounds without tick and tittle labels.
Invalidate()	Invalidates Area and all it's children.
GetActualPoint( Point point )	Converts point in user logic coordinates into actual pixels point.
GetActualPoint( DataPoint point )	Converts DataPoint into actual pixels point.
HighlightSeries( Series series, bool highlighted )	Sets highlighted state for specified series.

Events

Event	Description
LegendRefresh	Raised when need legend items refresh.

---

---

Updated Wiki: Area

June 6, 2014, 12:23 pm

≫ Next: Updated Wiki: Series

≪ Previous: Updated Wiki: Area

$

0

0

Area

Only available in the Plus Edition

Derives from Panel

Used to display charts and a grid with axes and labels. Use the Series property to specify the list of DataPoints.

• Series
• Axis

Properties

Property	Description
Title	Gets or sets Area title.
XAxis	Gets or sets X axis.
YAxis	Gets or sets Y axis.
Series	Gets or sets list of Series.
LayoutBounds	Gets layout bounds for series interior.
BackgroundTemplate	Gets or sets data template for grid representation.

Methods

Method	Description
GetSeriesLayoutBounds()	Calculates layout bounds without tick and tittle labels.
Invalidate()	Invalidates Area and all it's children.
GetActualPoint( Point point )	Converts point in user logic coordinates into actual pixels point.
GetActualPoint( DataPoint point )	Converts DataPoint into actual pixels point.
HighlightSeries( Series series, bool highlighted )	Sets highlighted state for specified series.

Events

Event	Description
LegendRefresh	Raised when need legend items refresh.

---

Updated Wiki: Series

June 6, 2014, 12:23 pm

≫ Next: Updated Wiki: Axis

≪ Previous: Updated Wiki: Area

$

0

0

Series

Only available in the Plus Edition

Derives from DependencyObject

Displays a list of DataPoint primitives in an Area of a Chart.

Properties

Property	Description
ShowHintLabels	Gets or Sets, show hint labels for series elements or not.
ShowPointsInLegend	If true, DataPoints from this Series are displayed in legend.
IsOwnerHighlight	Gets or Sets, is this Series performing highlight of it's child elements manually or not.
MarkerTemplate	Gets or Sets DataTemplate for Markers.
Template	Gets or Sets DataTemplate for this Series elements.
HintLabelTemplate	Gets or sets hint label template for elements of this series.
HintLineTemplate	Gets or sets hint line template for elements of this series.
HintLineLength	Gets or sets hint line length.
Title	Gets or Sets Series Title. Displayed in LegendItem
Spacing	Gets or Sets Spacing between series elements. this value is % relative to element width. Example: if for Column layout type spacing is 20, then column width is 80.
Layout	Gets or Sets LayoutEngine for this Series, that will layout this Series.
DefaultInterior	Gets or Sets default interior color for series elements.
Area	Gets parent Area
DataPointBindings	Gets list of BindingInfo objects. Add BindingInfo objects to this list to set up binding for DataPoints.
DataPointsSource	Gets or Sets binding source for DataPoints.
DataPoints	Gets or sets list of DataPoint.
LayoutPrimitives	Gets list of ChartPrimitive for layout elements.
LayoutHints	Gets list of ChartPrimitive for layout hints.

Methods

Method	Description
ApplyDefaultTemplate()	Applies default DataTemplates for series elements.
GetSortedPoints()	Gets array of DataPoints contained in this series, sorted if needed.
Reset()	Clears list of chart primitives.

---

Updated Wiki: Axis

June 6, 2014, 12:24 pm

≫ Next: Updated Wiki: Documentation

≪ Previous: Updated Wiki: Series

$

0

0

Axis

Only available in the Plus Edition

Derives from Xceed.Wpf.Toolkit.Chart.GridLine

Represents an axis.

Properties

Property	Description
LabelsType	Gets or sets type of tick labels.
DateTimeFormatInfo	Gets or sets DateTime format, uses to convert DateTime to labels text in LabelsType.DateTime mode.
DateTimeFormat	Gets or sets DateTime format. Used from convert DateTime to labels text in LabelsType.DateTime mode.
Location	Gets start point of axis line.
ScaleMode	Gets or sets scale mode of the axis.
GraduationMode	Gets or sets graduation mode of the axis.
CustomRangeStart	Gets or sets custom start point for manual scale mode.
CustomRangeEnd	Gets or sets custom end point for manual scale mode.
TickLabels	Gets list of tick labels.
TicksCount	Gets or sets the count of ticks.
TitleMargin	Gets or sets the margin between title label and axis line.
TickList	Gets collection of ticks.
GridLines	Gets collection of grid lines.
ShowArrow	Gets or sets the visibility of the arrow.
ShowAxis	Gets or sets the visibility of the axis.
ShowGridLines	Gets or sets the visibility of grid lines.
ShowTicks	Gets or sets the visibility of ticks.
ShowTickLabels	Gets or sets the visibility of tick labels.
ShowAxisLabel	Gets or sets the visibility of the axis label.
Reversed	Gets or sets indicator of the axis revertion.
Range	Gets or sets range of the axis.
GridTemplate	Gets or sets data template for grid lines representation.
TickTemplate	Gets or sets data template for ticks representation.
ArrowTemplate	Gets or sets data template for arrow representation.
LabelTemplate	Gets or sets data template for labels representation.
Arrow	Gets or sets instance of the axis arrow.
Title	Gets or sets text for title label.
AxisTitleTemplate	Gets or sets data template for axis labels representation.
AxisLabelsLayout	Gets or sets axis labels style of layout.
GridPoint	Gets layout point used to calculate position of the element. (Inherited from GridLine)
Orientation	Gets or sets orientation of the grid line. (Inherited from GridLine)
Info	Gets or Sets binding source object for this primitive. (Inherited from ChartPrimitive)
IsHighlighted	Gets or Sets, is primitive highlighted or not. (Inherited from ChartPrimitive)
IsCovered	Gets or Sets is primitive "covered" or not. "Covered" means this primitive is not highlighted, but some other primitive is highlighted.
DataPoint	Gets DataPoint corresponding to this primitive. (Inherited from ChartPrimitive)

Methods

Method	Description
GetRealPoint( double pt )	Converts point in user logic coordinates into point in actual pixels.
Reset()	Resets layout.
SetTitlesDirection( DataRange layoutRange, bool layoutReversed )	Sets direction of the tick labels.
PerformGraduation()	Performs graduation of the axis.
PerformCustomRangeGraduation()	Perform graduation for custom range in manual scale mode.

Events

Event	Description
HighlightEnter	Raised when primitive gets highlighted. (Inheridted from ChartPrimitive)
HighlightLeave	Raised when primitive gets un-highlighted. (Inherited from ChartPrimtive)

---

Updated Wiki: Documentation

June 6, 2014, 12:48 pm

≫ Next: Updated Wiki: Carousel

≪ Previous: Updated Wiki: Axis

$

0

0

Controls

• AutoSelectTextBox
• AvalonDock
• BusyIndicator
• ButtonSpinner
• Calculator
• CalculatorUpDown
• Charts -Plus Edition
• CheckComboBox
• CheckListBox
• ChildWindow
• ChildWindow Plus - Plus Edition
• CollectionEditor
• CollectionControlDialog
• ColorCanvas
• ColorPicker
• DataGrid
• DateTimePicker
• DateTimeUpDown
• DropDownButton
• Magnifier
• MaskedTextBox
• MessageBox
• MultiColumnComboBox - Plus Edition
• MultiLineTextEditor
• NumericUpDown - OBSOLETE! Use the NumericUpDown-derived controls (see next)
• NumericUpDown-derived controls (for decimal, double, byte, integer, long, short, and single types)
• Panel controls (SwitchPanel control provides an animated, switchable environment for children and panels)
• PieChart
• Pileflow - Plus Edition
• PrimitiveTypeCollectionEditor
• PropertyGrid
• PropertyGrid Plus - Plus Edition
• RadialGauge -Plus Edition
• RangeSlider
• Rating -Plus Edition
• RichTextBox
• RichTextBoxFormatBar
• SplitButton
• StylableWindow -Plus Edition
• SwitchPanel
• SwitchPanel Plus - Plus Edition
• TimelinePanel
• TimePicker
• TimeSpanUpDown
• ToggleSwitch -Plus Edition
• Ultimate ListBox - Plus Edition
• ValueRangeTextBox
• WatermarkTextBox
• WindowContainer
• WindowControl
• Wizard
• Zoombox

Installation and Usage Instructions

Please note: The Extended WPF Toolkit is dependent on .NET Framework 4.0. You must install .NET Framework 4.0 in order to use any features in the Toolkit.

Instructions for using the Extended WPF Toolkit binaries:

1. Install .NET Framework 4.0.
2. Download the ExtendedWPFToolkit_Binaries
3. Unblock the ZIP file.
   1. Right-click ExtendedWPFToolkit_Binaries.zip -> Properties -> Unblock
4. Unzip the ExtendedWPFToolkit_Binaries.zip
5. Reference the binaries in your project:
   1. Reference WPFToolkit.Extended.dll in your project (Xceed.Wpf.DataGrid.dll for the datagrid control)
   2. Add a using statement ("using Xceed.Wpf.Toolkit;" for most of the controls, "using Xceed.Wpf.DataGrid;" for the datagrid control) to the top of .cs files
   3. Add a new xmlns (xmlns:xctk="http://schemas.xceed.com/wpf/xaml/toolkit" for most of the controls, xmlns:xcdg="http://schemas.xceed.com/wpf/xaml/datagrid" for the datagrid control) to the top of XAML files
   4. Remember to use the namespace prefix (in the above example, <xctk: ...> or <xcdg: ...>) in the body of your XAML

Installation using NuGet

1. Install NuGet (can be downloaded for this link).
2. Open your Visual Studio.
3. Open your solution/project.
4. Open Tools menu, select Library Package Manager and select Package Manager Console
5. Run the following command Install-Package Extended.Wpf.Toolkit
   1. Add a using statement ("using Xceed.Wpf.Toolkit;" for most of the controls, "using Xceed.Wpf.DataGrid;" for the datagrid control) to the top of .cs files
      
   2. Add a new xmlns (xmlns:xctk="http://schemas.xceed.com/wpf/xaml/toolkit" for most of the controls, xmlns:xcdg="http://schemas.xceed.com/wpf/xaml/datagrid" for the datagrid control) to the top of XAML files
   3. Remember to use the namespace prefix (in the above example, <xctk: ...> or <xcdg: ...>) in the body of your XAML

Updated Wiki: Carousel

June 9, 2014, 11:56 am

≫ Next: Updated Wiki: DockPanel

≪ Previous: Updated Wiki: Documentation

$

0

0

Carousel

Only available in the Plus Edition

Derives from AnimationPanel

Positions the elements in a carousel mode with a centered element in front.

Properties

Property	Description
*	All the Properties from Canvas Panel
AngularOffset	Gets or sets the rotation on the carousel from the children.
AngularExtend	Gets or sets the extension of the carousel (360 is a perfect circle).
AreChildrenScaled	Gets or sets if the children in the back are smaller than the ones in the front.
AreChildrenOrdered	Gets or sets is the children are ordered in the carousel.
CenteredChild	Gets the center child in the carousel.
DistantChildScale	Gets or sets the children scale for non-centered children.
MaximumAngularSeparation	Gets or sets the maximum angle between children.
MaximumRadius	Gets or sets the maximum radius in the carousel.
MinimumAngularSeparation	Gets or sets the minimum angle between children.
MinimumRadius	Gets or sets the minimum radius in the carousel.
Orientation	Gets or sets the orientation of the carousel (Vertical or Horizontal).
Radius	Gets the radius in the carousel.
Tilt	Gets or sets the tilt angle of the carousel.

Events

Event	Description
*	All the Events from Canvas Panel.

Methods

Method	Description
CenterChild( UIElement child, TimeSpan animationDuration, bool perQuarterTurn )	Moves child to the front center of the carousel.
ReorderChildrenAroundChild( UIElement child )	This function will reorder the children inside the panel based on the given child.
StopAnimation()	Stop any active animation.
GetChildOffset( DependencyObject d )	Gets the ChildOffset property.
SetChildOffset( DependencyObject d, double value )	sets the ChildOffset property.
GetChildScale( DependencyObject d )	Gets the ChildScale property.
SetChildScale( DependencyObject d, double value )	Sets the ChildScale property.
GetChildZIndex( DependencyObject d )	Gets or sets the ChildZIndex property.
SetChildZIndex( DependencyObject d, int value )	sets the ChildZIndex property.

---