Provides management for desktop alerts, allowing registration, display, animation, and positioning of alerts on the screen. The class supports multiple constructors for customizing the alerts' screen position, offset, and distance between alerts. It includes animation functionalities for showing and hiding alerts, as well as customizing those animations' duration and behavior. The manager facilitates adding and removing alerts, controlling their visibility, and ensuring they are displayed in an organized manner according to user-defined settings. This class also manages alert positioning, enables attachment to specific windows for context-sensitive display, and provides functionality to detach alerts from those windows, restoring default behavior. The built-in event handling for alert windows allows for seamless interaction and management of alert lifecycle events.
Definition
Namespace:Telerik.Windows.Controls
Assembly:Telerik.Windows.Controls.Navigation.dll
Syntax:
public class RadDesktopAlertManagerInheritance: objectRadDesktopAlertManager
Constructors
Initializes a new instance of the RadDesktopAlertManager class.
public RadDesktopAlertManager()Initializes a new instance of the RadDesktopAlertManager class.
public RadDesktopAlertManager(AlertScreenPosition screenPosition, double alertsDistance)The position on the screen used to display the alerts on.
alertsDistancedoubleDistance between the opened alerts.
Initializes a new instance of the RadDesktopAlertManager class.
public RadDesktopAlertManager(AlertScreenPosition screenPosition, Point screenPositionOffset, double alertsDistance)The position on the screen used to display the alerts on.
screenPositionOffsetPointOffset of the used screen position.
alertsDistancedoubleDistance between the opened alerts.
Initializes a new instance of the RadDesktopAlertManager class.
public RadDesktopAlertManager(AlertScreenPosition screenPosition, Point screenPositionOffset)The position on the screen used to display the alerts on.
screenPositionOffsetPointOffset of the used screen position.
Initializes a new instance of the RadDesktopAlertManager class.
public RadDesktopAlertManager(AlertScreenPosition screenPosition)The position on the screen used to display the alerts on.
Properties
Gets or sets the distance between the opened alerts.
public double AlertsDistance { get; set; }Gets or sets duration in milliseconds of the animation used for updating the order of all instances of RadDesktopAlert.
public int AlertsReorderAnimationDuration { get; set; }Gets or sets the animation used for hiding all instances of RadDesktopAlert.
public RadAnimation HideAnimation { get; set; }Gets the position on the screen used to display all instances of RadDesktopAlert.
public AlertScreenPosition ScreenPosition { get; }Gets or sets the animation used for showing all instances of RadDesktopAlert.
public RadAnimation ShowAnimation { get; set; }Methods
Attaches the current instance of RadDesktopAlertManager to the Window of the passed element. When attached to Window, the manager shows alerts on the current screen where the Window is located.
public void Attach(DependencyObject element)Unregisters a desktop alert from the manager and close it.
public void CloseAlert(RadDesktopAlert alert, bool useAnimations = true)The alert to close.
useAnimationsboolIndicates whether the Close animation should be used. By default is True.
Unregisters all desktop alerts from the manager and close them.
public void CloseAllAlerts(bool useAnimations = true)Indicates whether the Close animation should be used. By default is True.
Evaluates whether a given RadDesktopAlert is registered with the RadDesktopAlertManager.
public bool ContainsAlert(RadDesktopAlert alert)The RadDesktopAlert to check.
Returns:True if RadDesktopAlert is present; otherwise, false.
Detaches the current instance of RadDesktopAlertManager from Window. All alerts will be shown on the main monitor.
public void Detach()Gets a collection of all registered RadDesktopAlert instances with the RadDesktopAlertManager.
Registers an instance of the RadDesktopAlert from the provided DesktopAlertParameters and displays it on the screen.
public void ShowAlert(DesktopAlertParameters parameters, bool useAnimations = true)The alert to show.
useAnimationsboolIndicates whether the Show animation should be used. By default is True.
Registers an instance of the RadDesktopAlert and displays it on the screen.
public void ShowAlert(RadDesktopAlert alert, bool useAnimations = true)The alert to show.
useAnimationsboolIndicates whether the Show animation should be used. By default is True.