version 2003
PA_CreateTip (tipContent; posX; posY; objectRect)
Parameter | Type | Description | |
tipContent | char * | Content of the tip to draw | |
posX | short | Left local coordinate of the tip (window) | |
posY | short | Top local coordinate of the tip | |
objectRect | PA_Rect | Rectangle(local) where the tip is valid |
Description
The routine PA_CreateTip creates a tip window.
tipContent is the string that will be displayed.
If posX and posY are both equal to zero, the tip window will be at 16 pixels South East from mouse position by default.
objectRect is the area of the object described by the tip. If the user moves the mouse outside of this rectangle, the tip window will be closed.
The tip window will also close after a certain delay. If a tip was opened before this call, it will be closed.
All coordinates are expressed in local coordinates of the window.
Depending on default settings or on previous calls to PA_UsePStrings or PA_UseCStrings, tipContent will be a Pascal or an ANSI C string.
NOTE
The tip is "temporary" and not saved in the structure like a "regular" tip created in the Design environment.
Example
PA_Rect r = {100, 100, 120, 185}; // Local coordinates of a "Save" button PA_CreateTip("Close the window, saving changes", 0, 0, r);
See Also
No reference.
Error Handling
PA_GetLastError always returns eER_NoErr