This topic provides an overview of the WinDesktopAlert™ feature allowing you to expose and navigate open window desktop alerts.
The following topic is a prerequisite to understanding this topic:
This topic contains the following sections:
Earlier version the UltraDesktopAlert did not expose the open windows collection requiring you to invoke the IsOpen
method passing a Key or previously stored instance of an UltraDesktopAlertWindowInfo in order to traverse the open windows.
The newly enhanced feature, presented here, makes it much easier to query the collection of open windows using the OpenWindows property exposes a read-only version of the collection that internally tracks open windows.
Users can traverse the collection of each UltraDesktopAlertWindowInfo object currently displayed and retrieve the count of the collection through the ReadOnlyCollection
object; returned by the OpenWindows property.
The following IDE screenshot shows a code example, triggered by a button-click event for retrieving the count of open alert windows from the OpenWindows collection. Other properties and methods are also available as shown in the IntelliSense drop-down.
The open windows collection works best when paired with the AutoClose property set to false, and the MultipleWindowDisplayStyle set to anything other than Default or None , otherwise it will always contain one alert window, for example:
In C#:
ultraDesktopAlert1.AutoClose = Infragistics.Win.DefaultableBoolean.False;
ultraDesktopAlert1.MultipleWindowDisplayStyle = MultipleWindowDisplayStyle.Tiled;
In Visual Basic:
ultraDesktopAlert1.AutoClose = Infragistics.Win.DefaultableBoolean.[False]
ultraDesktopAlert1.MultipleWindowDisplayStyle = MultipleWindowDisplayStyle.Tiled
The following topic provides additional information related to this topic.