 | ApplicationBase Class |
Encapsulates a Windows Presentation Foundation (WPF) application.
Inheritance HierarchySystemObject
System.Windows.ThreadingDispatcherObject
System.WindowsApplication
Cauldron.XAMLApplicationBase
System.Windows.ThreadingDispatcherObject
System.WindowsApplication
Cauldron.XAMLApplicationBase
Namespace: Cauldron.XAML
Assembly: Cauldron.Win32.WPF (in Cauldron.Win32.WPF.dll) Version: 3.2.0.1 (3.2.0.1)
SyntaxC#
public abstract class ApplicationBase : Application, IViewModel, INotifyPropertyChanged, INotifyBehaviourInvocation
The ApplicationBase type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | ApplicationBase |
Initializes a new instance of the ApplicationBase |
Properties| Name | Description | |
|---|---|---|
 | ApplicationSplash |
Gets or sets the application splash screen image. This is only neccessary if the property IsSinglePage is set to true
|
 | ApplicationUrlProtocols |
Gets a list of application url protocolls.
Please note that these protocols are not automatically registered. To register these protocols, invoke the method RegisterUrlProtocols.
|
| Dispatcher |
Gets the Dispatcher this Object is associated with.
|
| Id |
Gets the unique Id of the view model
|
| IsLoading |
Gets or sets a value that indicates if the viewmodel is loading
|
| IsSingleInstance |
Gets or sets a value that indicates that the application is single instanced. Default is false.
|
| IsSinglePage |
Gets or sets a value that indicates that the application is a single page application.
This application will behave almost like a UWP app. Default is false.
|
| MessageDialog |
Gets the message dialog
|
| Navigator |
Gets the window navigator
|
| ShouldBringToFront |
Gets or sets a value that indicates if the main window should be brought to front if a
second instance of the application sends arguments. Default is true.
|
Methods| Name | Description | |
|---|---|---|
 | AfterRaiseNotifyPropertyChanged |
Occures after the event PropertyChanged has been invoked
|
| BeforeRaiseNotifyPropertyChanged |
Occured before the PropertyChanged event is invoked.
|
| OnActivated |
Occures if the application is activated by passing arguments from a second app instance.
Will only occures if IsSingleInstance is true
|
| OnActivationProtocol |
Occures if the application is activated by a URI whose scheme name this app is registered
to handle.
|
| OnConstruction |
Occures on initialization of ApplicationBase |
| OnException |
Centralized error handling
|
| OnPreload |
Occures on preload. Will only occures if IsSingleInstance is true or if the inheriting class has a View.
The view can be added by the ViewAttribute or as a DataTemplate with the correct naming nomenclature.
|
| OnResourceLoad |
Occures before loading XAML resources
|
| OnStartup |
Occures if the application is launched
|
| RaiseNotifyBehaviourInvoke |
Invokes the BehaviourInvoke event
|
| RaisePropertyChanged |
Invokes the PropertyChanged event
|
| RegisterUrlProtocols |
Registers all url protocols listed in ApplicationUrlProtocols.
|
Events| Name | Description | |
|---|---|---|
 | BehaviourInvoke |
Occures if a behaviour should be invoked
|
| IsLoadingChanged |
Occures if the IsLoading property has changed.
|
| PropertyChanged |
Occurs when a property value changes.
|
Extension Methods| Name | Description | |
|---|---|---|
  | As(Type) | Overloaded.
Converts a type using the implicit or explicit operators. If both fails it will try to
convert the value with ChangeType(Object, Type).
(Defined by ExtensionsConvertions.) |
| As(Type, Type) | Overloaded.
Converts a type using the implicit or explicit operators. If both fails it will try to
convert the value with ChangeType(Object, Type).
(Defined by ExtensionsConvertions.) |
| AsT | Overloaded.
Performs a cast between compatible reference types. If a convertion is not possible then
null is returned. As a last resort it will use ChangeType(Object, Type).
Tries to use the implicit and explicit operators if exists when convertion with 'as'
returns null.
(Defined by ExtensionsConvertions.) |
| CreateTypeT |
Creates a new Type that implements the properties of an interface defined by T
and copies all value of anon to the new object.
(Defined by ExtensionsInterception.) |
| GetPropertyNonPublicValueT |
Searches for the specified property, using the specified binding constraints and returns
its value.
Default BindingFlags are Instance and NonPublic (Defined by ExtensionsReflection.) |
| GetPropertyValue(String, BindingFlags) | Overloaded.
Searches for the specified property, using the specified binding constraints and returns
its value.
(Defined by ExtensionsReflection.) |
| GetPropertyValueT(String) | Overloaded.
Searches for the specified property, using the specified binding constraints and returns
its value.
Default BindingFlags are Instance and Public (Defined by ExtensionsReflection.) |
| GetPropertyValueT(String, BindingFlags) | Overloaded.
Searches for the specified property, using the specified binding constraints and returns
its value.
(Defined by ExtensionsReflection.) |
| MapToT |
Maps all properties and fields of an instance to another instance. The Clone() method is used to copy an instance if exist.
Mapping fails on jagged and multidimensional array. Classes without parameterless constructor will stay null.
(Defined by ExtensionsCloning.) |
| Run |
Handles neccessary setting of the IsLoading flag if implemented and the error handling
(Defined by Extensions.) |
| RunAsync |
Handles neccessary setting of the IsLoading flag and the error handling
(Defined by Extensions.) |
| RunDispatcherAsync |
Runs the action asyncronously using the Dispatcher on the lowest priority.
Handles neccessary setting of the IsLoading flag and the error handling.
(Defined by Extensions.) |
| ToLong | (Defined by ExtensionsConvertions.) |
| ToStringEx(String) | Overloaded.
Converts the value of this instance to its equivalent string representation, using the
specified format.
The following custom formatter are already added: ByteSizeFormatter, MetricUnitFormatter (Defined by Extensions.) |
| ToStringEx(String, CultureInfo) | Overloaded.
Converts the value of this instance to its equivalent string representation, using the
specified format.
The following custom formatter are already added: ByteSizeFormatter, MetricUnitFormatter (Defined by Extensions.) |
| TryDispose |
Tries to performs application-defined tasks associated with freeing, releasing, or
resetting unmanaged resources.
This will dispose an object if it implements the IDisposable interface.
(Defined by Extensions.) |
See Also