Documents

NextGrid & NextDBGrid

NextGrid

NextDBGrid

NextInspector

NextSheet

NextCollection

Misc

Labs

NextGrid .NET

NxAlertWindow Tutorial

Related Articles:

Info
  • Skill:
  • Version: 1.0.0
  • Author: Gordana Milinkovic
  • Created: 2008-07-22
  • Updated: 2008-07-27
Click on Next Collection Tab/Category and chose icon . Click on Form and component will be placed. The NxAlertWindow on the Form looks like this:



Like you can notice, the NxAlertWindow is composed of two parts: the header and the panel.


Header properties




Caption - Specifies a text string that identifies the control to the user. The caption appears at the left side of the header.


HeaderFont - Controls the attributes of text written on the header. To change to a new font, specify a new TFont object. To modify a font, change the value of the Charset, Color, Height, Name, Pitch, Size, or Style of the TFont object.


HeaderSize - Specifies the vertical size of the header in pixels. Use the HeaderSize property to read or change the height of the header.


SmallGlyph - Specifies the bitmap that appears on the left side of the header, in front of the text specified in the Caption property.




CloseGlyph - Specifies the bitmaps that appears on the right side of the header, at the place of the x-button.

Value Meaning Existing bitmap New bitmap
NormalGlyph Specifies the bitmap that appears at the place of the x-button.
HoverGlyph Specifies the bitmap that appears instead of the bitmap specified in the NormalGlyph property when the cursor is positioned on the bitmap.

Note: This property has effect only when the sub property aoCloseButton of the Options property is set to True.



Panel properties




Text - Contains a text inside the panel.

Note: The sub property aoHtmlText of the Options property takes effect on the Text property content.


TextMargins - Specifies the distance, in pixels, between the edge of the text area and the edge of the panel. This property allows you to set the size of each margin separately.


Alignment - Specifies how the text specified in the Text property is aligned horizontally within the panel.

Value Meaning Screenshot
taCenter The text is centered.
taLeftJustify The text is left justified.
taRightJustify The text is right justified.



VerticalAlignment - Specifies how the text specified in the Text property is aligned vertically within the panel.

Value Meaning Screenshot
taAlignBottom The text appears near the bottom of the panel.
taAlignTop The text appears near the top of the panel.
taVerticalCenter The text appears at the center of the panel.

Note: This property doesn't take effect when the WordWrap property is set to True.


WordWrap - Determines the way in which the text specified in the Text property is shown inside the panel.

Value Meaning Screenshot
False In the one line is as much text as it possible to fit in that width of the panel.
True The text is arranged in a few lines.



LargeGlyph - Specifies the bitmap that appears on the panel.


GlyphPosition - Determines where the bitmap specified in the LargeGlyph property appears on the panel.

Value Meaning Screenshot
gpLeft The bitmap appears near the left side of the panel.
gpTop The bitmap appears near the top of the panel.

Note: Use the TextMargins property to make indent between the bitmap and the text. The text is always inside the margins and the bitmap position is fixed.


OptionText - Contains a text inside the options link.

Note: This property has effect only when the sub property aoOptionsLink of the Options property is set to True.


Font - Controls the attributes of text specified in the OptionText property. To change to a new font, specify a new TFont object. To modify a font, change the value of the Charset, Color, Height, Name, Pitch, Size, or Style of the TFont object.


Color - Specifies the background color of the panel.

Note: This property has effect only when BackgrounStyle property is set to btAuto.


Other properties




Options – There are three different sub properties of this property: the first one, the aoCloseButton, takes effect on the x-button appearance, the second one, the aoHtmlText, takes effect on the Text property content and the third one, aoOptionsText, determinates whether the options link is visible.

aoCloseButton - Determinates whether the x-button is visible.

Value Meaning Screenshot
False The x-button is not visible.
True The x-button is visible.



aoHtmlText - Determines whether the HTML tags can be placed inside the Text property.

When aoHtmlText is set to False, the HTML tags can’t be placed inside the Text property.

When aoHtmlText is set to True, the HTML tags can be placed inside the Text property.


aoOptionsLink - Determinates whether the options link is visible.

Value Meaning Screenshot
False The options link is not visible.
True The options link is visible.



PopupLocation - Indicates the location where the NxAlertWindow appears.

When the PopupLocation is set to plLeft, the NxAlertWindow appears on the left side of the screen.

When the PopupLocation is set to plRight, the NxAlertWindow appears on the left side of the screen.


PopupSound - Determinates the notification sound when NwAlertWindow is opening.

There are offered five notification sounds (mslconAsterisk, mslconExclamation, mslconHand, mslconQuestion and msOk) and silent option (msNone).


CloseDelay – Specifies the time interval after which the NxAlertWindow will disappear.

The time is specified in milliseconds. Default delay is 5000 milliseconds.


AdaptiveColors – Determinates whether the color of the NxAlertWindow can be changed.

When the AdaptiveColor is set to False, the color can be changed.

When the AdaptiveColor is set to True, the color can’t be changed.

Note: Use ForegroundColor property to change the color of the NxAlertWindow.


ForegroundColor – Determinates the color of the NxAlertWindow.

Example: This is how the NxAlertWindow looks like when the ForegroundColor property is set to clBlack, clRed and clSilver.



Note: The NxAlertWindow looks like this only when the BackgroundStyle property is set to btAuto.


Methods




Calling Popup method will open NxAlertWindow.

Calling Close method will close NxAlertWindow.


Events




OnClose - Occurs immediately after the NxAlertWindow is closed.


OnCloseClick – Occurs immediately after the NxAlertWindow is closed by clicking on the x-button.


OnOptionsClick - Occurs immediately after the clicking on the options link.


OnPopup - Occurs immediately after the NxAlertWindow appears.

Was This Article Useful?

Only constructive comments, code contributions... will be publishes. Questions, non-official discussion will not be published.