 |
 |
Infragistics2.Win.Misc.v7.2 |
| Infragistics.Win.Misc Namespace : UltraDesktopAlert Class |
|
|
Infragistics2.Win.Misc.v7.2 |
| Infragistics.Win.Misc Namespace : UltraDesktopAlert Class |
Windows Forms Component which handles the display of desktop alert/notification windows.
For a list of all members of this type, see UltraDesktopAlert members.
  ~288.gif)    ~288.gif)
|
[Visual Basic]
Public Class UltraDesktopAlert
Inherits UltraComponentControlManagerBase
Implements IUltraComponent, IUltraLicensedComponent, ISupportAppStyling, IUltraControl [C#]
public class UltraDesktopAlert : UltraComponentControlManagerBase, IUltraComponent, IUltraLicensedComponent, ISupportAppStyling, IUltraControl The Infragistics UltraDesktopAlert component provides the ability for the end developer to display an UltraControlBase-derived control, hosted in a top-level window, which notifies the end user of some event. The end user can interact with the notification by clicking one of the hyperlinks (as defined by the UltraDesktopAlertShowWindowInfo.Caption, UltraDesktopAlertShowWindowInfo.Text, and UltraDesktopAlertShowWindowInfo.FooterText properties), which utilize the FormattedTextUIElement. User interaction is also supported via the UltraDesktopAlert.AlertButtons collection, which extend the ability to customize the appearance and behavior of the buttons which appear alongside the bottom edge of the desktop alert window. The desktop alert windows exhibit animated effects when they appear and close, which are controlled by the UltraDesktopAlert.AnimationStyleShow and UltraDesktopAlert.AnimationStyleAutoClose properties. A desktop alert can be made to appear at any of the four corners of the user's screen, and also fully supports multi-monitor configurations, using the UltraDesktopAlertShowWindowInfo.ScreenPosition and UltraDesktopAlertShowWindowInfo.Screen properties, or can be displayed at an explicit screen location by setting the UltraDesktopAlertShowWindowInfo.ScreenLocation property. A sound can be played as the desktop alert window appears by setting the UltraDesktopAlertShowWindowInfo.Sound property, which supports the SystemSound class, as well as a path to a sound file or URL, or a Stream that contains sound data in the popular Windows WAV (Waveform Audio Format) format. The desktop alert windows can be made to emulate either the New Mail Desktop Alert notification mechanism seen in MS Outlook, or the notification windows seen in the MS Windows Live Messenger online chat application, by setting the UltraDesktopAlert.Style property.
The displaying of a desktop alert window is accomplished by a simple two-step process; first, an object of type UltraDesktopAlertShowWindowInfo is created, which exposes settable properties that extend the ability to change the attributes of the desktop alert, such as the text and formatting of the links it displays, the image it displays, and the sound that is played when it appears. The component's UltraDesktopAlert.Show(UltraDesktopAlertShowWindowInfo) method is then called, which accepts as its only parameter the UltraDesktopAlertShowWindowInfo instance that was created in the first step. An object of type UltraDesktopAlertWindowInfo is returned from the Show method, which contains information about the desktop alert window, as well as a way to identify it and/or refer to it programmatically.
The following table cross references some of the features of the UltraDesktopAlert component with
the members of the public object model which control them:
