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.

Member Description
uStructSize Size of this structure in bytes, for versioning. Use the sizeof() macro to calculate this value.
uFlags Flag that indicates whether this button contains multiple tools. Possible values are:
  Value Meaning
  0 Only one tool is associated with this button.
  ANNBUTTON_MULTIPLE This button has more than one tool is associated with this button.
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() macro 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.

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Raster Imaging C API Help