RussJudge.WPFControlsAndStylizer 1.1.2

RussJudge.WPFControlsAndStylizer

This project is for primarily offering a ResourceDictionary for common stylizing of various WPF controls. It also offers controls that are not available through standard WPF functionality, such as an activity indicator.

This initial publish does not offer much, but more will be added as needed by the developer.

For an example of how to use this, see the example project at https://github.com/russjudge/RussJudge.WPFControlsAndStylizer

Styles

Colors

These colors can be overridden in Resources to change colors of choice.

Brushes

These brushes can be overridden in Resources to change colors of choice.

Templates

DialogWindowStyle

Stylizes a window to behave like a dialog. If you use the attached property Attached.TitleContent, the object defined in Attached.TitleContent will be presented in the Title bar.

StandardWindowStyle

Stylizes a window. If you use the attached property Attached.TitleContent, the object defined in Attached.TitleContent will be presented in the Title bar.

ImportantButtonStyle

Stylizes a button to include animation on MouseOver.

TitleBarButtonStyle

Stylizes a button that is used in the TitleContent attached property.

Controls

ActivityIndicator

This control is merely a spinner to indicate activity. By default, it is hidden, and the Visibility is bound to its property "IsActive", which in turn is bound to the static property "IsActive" on RussJudge.WPFControlsAndStylizer.GlobalControl.Current. Set the Visibility to make it visible, or set "IsActive" on the ActivityIndicator to make it visible, or set RussJudge.WPFControlsAndStylizer.GlobalControl.Current.IsActive = true;

Using RussJudge.WPFControlsAndStylizer.GlobalControl.Current.IsActive allows for all ActivityIndicator controls on all open windows to appear and be controlled from a single location.

There are three color properties that can be stylized:

By default, the ActivityIndicator is a circle. However, by setting the Height and Width differently, an elllipse is formed that will create a differently behaving activity indicator.

About

This is a standard "About" window, stylized with the "DialogWindowStyle" that displays properties from any given Assembly. The default Assembly is the Entry Assembly.
Open the About window with:

var optionalAssembly = System.Reflection.EntryAssembly;`

About.DisplayAbout("optional informational string", optionalAssembly);`

InputPromptDialog

This is a simplified dialog window for providing a prompt to accept a string from the user.

string? result = InputPromptDialog.ShowDialog();
if (result == null)
{
	//User selected "Cancel"
}
else
{
	//User entered a string for processing.
	string value = result;
}

TaskMonitor

This Singleton provides a mechanism for starting and monitoring background tasks, with the capability to cancel.

Tasks can be added by calling the AddTask method. The first parameter is a delegate that must accept a CancellationToken as its only parameter. This token can be ignored within the delegate, but can be used to allow controlled cancellation of the Task. The second parameter of AddTask is a simple description.

TaskMontior.Current.BackgroundProcesses is a bindable collection of running tasks.

Attached Properties

IsStylized

Set to true only if using the DialogWindowStyle or StandardWindowStyle. Setting this property causes the System Commands (Maximize, Minimize, Restore, Close) to be properly bound to the Window Titlebar Buttons. These buttons won't function without setting this attached property. Setting this is NOT required if TitleContent is set.

TitleContent

Content that will display on the Window Titlebar left of the Title on a Window using the DialogWindowStyle or StandardWindowStyle.

Placeholder

Setting this attached property on a TextBox will display the Placeholder over the empty area of the TextBox. This Placeholder disappears when focus is on the TextBox, or if the TextBox.Text has a value.