Version

Exposing OpenAlert Windows

Topic Overview

Purpose

This topic provides an overview of the WinDesktopAlert™ feature allowing you to expose and navigate open window desktop alerts.

Required background

The following topic is a prerequisite to understanding this topic:

Topic Purpose

The topics in this section will give you a better idea of why you would want to use WinDesktopAlert™ in your applications.

In this topic

This topic contains the following sections:

Expose Open Windows Overview

Introduction

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.

Note
Note:

Adding new windows to the collection and displaying the windows within the collection requires you to use the previously defined architecture.

Code Illustration

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.

WinDesktopAlert Exposing Open Alert Windows 1.png

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

Related Content

Topics

The following topic provides additional information related to this topic.

Topic Purpose

In this section, you’ll find short, task-based topics that explain how to perform a specific task related to the WinDesktopAlert component.