TMUIArea.CreateBubble

Create a MUI Bubble

Declaration

Source position: MUIClass.Area.pas line 126

Arguments

Function result

Bubble Handle use to close the bubble again with: DeleteBubble()

Description

Together with DeleteBubble(), this method provides an interface for MUIs bubble mechanism. Applications can use bubbles for their own purpose, e.g. for indicating error conditions on certain gadgets.

CreateBubble() creates a bubble at the specified coordinates with the specified (textual) contents. It returns a bubble "handle" that has to be passed to DeleteBubble() when the bubble shall disappear.

There's no limitation on the number of bubbles, you can create lots of them at a time if you wish. Also, these custom bubbles are completely independant of MUI's bubble help system and won't disappear automatically when the mouse is moved.

Note that bubbles will only show up when the object in question is visible. Otherwise CreateBubble() returns nil. You are responsible for deleting the bubble before the object get's invisible. Good place to remove a custom bubble is e.g. the Hide method of your object.

Defined flags:

MUIV_CreateBubble_DontHidePointer

prevents MUI from hiding the mouse pointer when displaying the help bubble. It is recommended that you always set this, unless your bubble is meant to disappear as soon as there is some user input.

See also