Back to Devexpress

TdxAlertWindowManager.Show(string,string,TcxImageIndex) Method

vcl-dxalertwindow-dot-tdxalertwindowmanager-dot-show-x28-system-dot-string-system-dot-string-cxgraphics-dot-tcximageindex-x29.md

latest3.0 KB
Original Source

TdxAlertWindowManager.Show(string,string,TcxImageIndex) Method

Creates a new alert window, initializes it with specified message settings and displays this window on screen.

Declaration

delphi
function Show(const ACaption: string; const AText: string; AImageIndex: TcxImageIndex = -1): TdxAlertWindow;

Parameters

NameType
ACaptionstring
ATextstring
AImageIndexTcxImageIndex

Returns

Type
TdxAlertWindow

Remarks

Calling this function does the following:

  • Creates a new alert window and appends it to the Items collection;

  • Initializes the created window’s LookAndFeel.MasterLookAndFeel property with the LookAndFeel property value of the alert window manager;

  • Initializes the created window’s Options-prefixed properties with corresponding options of the alert window manager;

  • Adds a message to the window with the Caption, Text, and ImageIndex properties initialized with the ACaption, AText, and AImageIndex function parameters;

  • Fires the OnInitialize event, enabling you to customize the window content and default settings.

  • If the WindowMaxCount limit is not reached, the Show function fires the OnBeforeShow event, enabling you to complete the window’s initialization, and then calls the window’s Show method. If the limit is reached, the alert window manager postpones showing new alert windows until one of the visible windows is closed or hidden.

Once the window is shown, the OnShow event is fired.

See Also

TdxAlertWindow.Close

TdxAlertWindowManager.Close

TdxAlertWindowManager Class

TdxAlertWindowManager Members

dxAlertWindow Unit