Programming guideline of WinDom

BubbleEvnt()

NAME

BubbleEvnt - display the bubble help defined by BubbleAttach().

PROTOTYPAGE

int BubbleEvnt(void);

PARAMETERS

valeur de retour:

0 if bubble is not found,
WS_FORM if bubble is found in a dialog box,
MW_TOOLBAR if bubble is found in a toolbar.

DESCRIPTION

This function find the object pointed by the mouse sprite. If the an object is found and if a bubble help is linked to this object (with BubbleAttach()) the bubble help is displayed. BubbleEvnt() works only with window formular or toolbar.

EXAMPLE

     /*
      * Example of BubbleGEM support
      * with WinDom
      */
     #include <windom.h>
     
     void RightButton( void) {
     	if( evnt.mbut & 0x2)
     		BubbleEvnt();
     }
     
     int main(void) {
     	OBJECT *tree;
     
     	ApplInit();
     	RsrcLoad( "TEST.RSC");
     	rsrc_gaddr( 0, FORM1, &tree);
     
     	/* Link the bubble help to objects ... */
     	BubbleAttach( tree,  0, "Formular background"); /* FORM1 */
     	BubbleAttach( tree, OK, "An exit button");  	/* FORM1 */
     
     	/* Create form */
     	FormCreate( tree, MOVER|NAME, NULL, "test", NULL, 1, 0);
     
     	/* Handle globally the MU_BUTTON event */
     	EvntAttach( NULL, WM_XBUTTON, RightButton);
     
     	/* On gère les clicks souris GAUCHE et DROIT */
     	evnt.bclick = 258;
     	evnt.bmask = 0x1|0x2;
     	evnt.bstate = 0;
     
     	do
     		EvntWindom( MU_MESAG|MU_BUTTON);
     	while( wglb.first);
     
     	BubbleFree();  /* release the bubbles */
     	RsrcFree();
     	ApplExit();
     	return 0;
     }