Skip to main content

TdxAlertWindowManager.Show(string,string,TcxImageIndex) Method

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

Declaration

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

Parameters

Name Type
ACaption string
AText string
AImageIndex TcxImageIndex

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