ANNBUTTON

typedef struct _ANNBUTTON 
{ 
   L_UINT uStructSize; 
   L_UINT uFlags; 
   L_UINT uTool; 
   L_UINT uToolCount; 
   pANNTOOL pTools; 
   pBITMAPHANDLE pBitmapUp; 
   pBITMAPHANDLE pBitmapDown; 
   L_UINT uBitmapStructSize; 
   L_INT nToolTipTextID; 
   L_TCHAR * pToolTipText; 
} ANNBUTTON, *pANNBUTTON; 

The ANNBUTTON structure contains information about buttons contained in the annotation toolbar.

Members

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() operator to calculate this value.

uFlags

Flag that indicates whether this button contains multiple tools. Possible values are:

uTool

Value that indicates the tool associated with this button, if this button has only one tool. If this button has more than one tool, this is the default tool for the button.

uToolCount

The number of tools associated with this button if ANNBUTTON_MULTIPLE is set in uFlags.

pTools

An array of tools associated with this button if ANNBUTTON_MULTIPLE is set in uFlags.

pBitmapUp

Pointer to the bitmap handle that references the bitmap that is displayed when the button is not pressed. This bitmap must be specified. The bitmap should have one of the following sets of dimensions, depending on the toolbar style used:

• Old style toolbar (TOOLBARIMAGECX,TOOLBARIMAGECY)
  When using the old style toolbar,  we recommend that all bitmaps used for the annotation buttons should use the same palette.

• New XP style toolbar (TOOLBARIMAGEXP_CX, TOOLBARIMAGEXP_CY)

pBitmapDown

Pointer to the bitmap handle that references the bitmap that is displayed when the button is pressed. You can use the same pointers for pBitmapUp and pBitmapDown.

uBitmapStructSize

Size, in bytes, of the structures pointed to by pBitmapUp and pBitmapDown. Use sizeof(BITMAPHANDLE).

nToolTipTextID

Index into the annotation menu dialog strings (ANNAUTOTEXT_XXX). If this value is -1, the text for the tool tip is in pToolTipText. If this value is >= 0, this value is an index into the set of annotation menu dialog strings and the tool tip text will come from here.

pToolTipText

Character string that contains the text for the tool tip. This is only valid if nToolTipTextID is -1.

Comments

An array of ANNBUTTON structures is used both to retrieve information about tool buttons in the existing toolbar, and to set information about tool button to set in the tool bar. For an example showing the use of this structure, refer to L_AnnFreeToolBarButtons.

Some functions which take this structure as a parameter require that the structure be initialized prior to the function call. You must set the uStructSize member to the total size, in bytes, of the structure. Use the sizeof() operator to calculate this value. Functions that do not require the structure be initialized will take the total size of the structure, in bytes, as an additional function parameter.

When using the new style annotation toolbar, the dimensions of the bitmap should be TOOLBARIMAGEXP_CX x TOOLBARIMAGEXP_CY pixels. The bitmap should be 32 bits per pixel (24 bits per pixel with an 8 bit alpha channel). Pixel values in the alpha channel range from 0x00 (completely transparent) to 0xFF (completely opaque). For more information on using the new style annotation toolbar, refer to L_AnnSetOptions.