Skip to content

Latest commit

 

History

History
128 lines (90 loc) · 6.72 KB

getting-started.md

File metadata and controls

128 lines (90 loc) · 6.72 KB
title page_title description slug tags published position
Getting Started
Getting Started
Check our "Getting Started" documentation article for the RadDesktopAlert {{ site.framework_name }} control.
raddesktopalert-getting-started
getting,started
true
1

Getting Started with {{ site.framework_name }} DesktopAlert

This topic will walk you through the creating of RadDesktopAlert.

Assembly References

To use the RadDesktopAlert in your projects you have to add references to the following assemblies:

  • Telerik.Licensing.Runtime
  • Telerik.Windows.Controls
  • Telerik.Windows.Controls.Input
  • Telerik.Windows.Controls.Navigation

You can find the required assemblies for each control from the suite in the {% if site.site_name == 'Silverlight' %}[Controls Dependencies]({%slug installation-installing-controls-dependencies%}){% else %}[Controls Dependencies]({%slug installation-installing-controls-dependencies-wpf%}){% endif %} help article.

tip With the 2025 Q1 release, the Telerik UI for WPF has a new licensing mechanism. You can learn more about it [here]({%slug installing-license-key%}).

Adding Telerik Assemblies Using NuGet

To use RadDesktopAlert when working with NuGet packages, install the Telerik.Windows.Controls.Navigation.for.Wpf.Xaml package. The [package name may vary]({%slug nuget-available-packages%}) slightly based on the Telerik dlls set - [Xaml or NoXaml]({%slug xaml-vs-noxaml%})

Read more about NuGet installation in the [Installing UI for WPF from NuGet Package]({%slug nuget-installation%}) article.

Adding RadDesktopAlert in the Project

You can include the control in your page by either dragging it from the toolbox in Visual Studio, or manually creating the control. Below is an example of how to create RadDesktopAlert in code behind:

[C#] Creating RadDesktopAlert

{{region cs-raddesktopalert-getting-started_0}} var alert = new RadDesktopAlert(); alert.Header = "MAIL NOTIFICATION"; alert.Content = "Hello, Here are two things that we noticed today on our daily meeting."; alert.ShowDuration = 3000; {{endregion}}

[VB] Creating RadDesktopAlert

{{region vb-raddesktopalert-getting-started_0}} Dim alert = New RadDesktopAlert() alert.Header = "MAIL NOTIFICATION" alert.Content = "Hello, Here are two things that we noticed today on our daily meeting." alert.ShowDuration = 3000 {{endregion}}

RadDesktopAlert is designed to work with [RadDesktopAlertManager]({%slug raddesktopalert-desktop-alert-manager%}). If just placed in XAML it won't be completely functional.

In order to visualize it, a new instance of RadDesktopAlertManager should be created and the already declared above RadDesktopAlert should be passed as a parameter to its ShowAlert method:

[C#] Showing RadDesktopAlert

{{region cs-raddesktopalert-getting-started_1}} RadDesktopAlertManager manager = new RadDesktopAlertManager(); manager.ShowAlert(alert); {{endregion}}

[VB] Showing RadDesktopAlert

{{region vb-raddesktopalert-getting-started_1}} Dim manager As New RadDesktopAlertManager() manager.ShowAlert(alert) {{endregion}}

Setting a Theme

The controls from our suite support different themes. You can see how to apply a theme different than the default one in the [Setting a Theme]({%slug styling-apperance-implicit-styles-overview%}) help article.

important Changing the theme using implicit styles will affect all controls that have styles defined in the merged resource dictionaries. This is applicable only for the controls in the scope in which the resources are merged.

To change the theme, you can follow the steps below:

  • Choose between the themes and add reference to the corresponding theme assembly (ex: Telerik.Windows.Themes.Windows8.dll). You can see the different themes applied in the Theming examples from our {% if site.site_name == 'WPF' %}WPF Controls Examples{% else %}Silverlight Controls Examples{% endif %} application.

  • Merge the ResourceDictionaries with the namespace required for the controls that you are using from the theme assembly. For the RadDesktopAlert, you will need to merge the following resources:

    • Telerik.Windows.Controls
    • Telerik.Windows.Controls.Navigation

Example 1 demonstrates how to merge the ResourceDictionaries so that they are applied globally for the entire application.

[XAML] Example 1: Merge the ResourceDictionaries

{{region raddesktopalert-getting-started_6}} <Application.Resources> <ResourceDictionary.MergedDictionaries> </ResourceDictionary.MergedDictionaries> </Application.Resources> {{endregion}}

Alternatively, you can use the theme of the control via the {% if site.site_name == 'WPF' %}StyleManager{% else %}StyleManager{% endif %}.

Figure 1 shows a RadDesktopAlert with the Windows8 theme applied.

Figure 1: RadDesktopAlert with the Windows8 theme

RadDesktopAlert with Windows8 theme

{% if site.site_name == 'WPF' %}

Telerik UI for WPF Learning Resources

See Also

  • [Overview]({%slug raddesktopalert-overview%})
  • [Visual Structure]({%slug raddesktopalert-visual-structure%})
  • [Desktop Alert Manager]({%slug raddesktopalert-desktop-alert-manager%})