In This Topic ▼

LAnnPushPin::GetSecondaryBitmap

#include "ltwrappr.h"

virtual L_INT LAnnPushPin::GetSecondaryBitmap(pLBitmap, uStructSize)

virtual L_INT LAnnPushPin::GetSecondaryBitmap(pBitmap, uStructSize)

LBitmapBase * pLBitmap;	pointer to an LBitmapBase object
pBITMAPHANDLE pBitmap;	address of the variable to be updated
L_UINT uStructSize;	size of the structure

Gets the bitmap handle for the secondary bitmap of the annotation object.

Parameter	Description
pLBitmap	Pointer to an LBitmapBase object to be updated with the handle to the annotation object's secondary bitmap.
pBitmap	Address of the variable to be updated with the handle to the annotation object's secondary bitmap.
uStructSize	Size in bytes, of the structure pointed to by pBitmap, for versioning. Use sizeof(BITMAPHANDLE).

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Before calling LAnnPushPin::GetSecondaryBitmap(pLBitmap), where pLBitmap is of type LBitmapBase , you must declare an LBitmapBase object. Then, pass the address of the object in the pLBitmap parameter. This function will update the object with the handle to the annotation object's secondary bitmap.

Before calling LAnnPushPin::GetBitmap(pBitmap), where pBitmap is of type pBITMAPHANDLE, you must declare a variable of data type BITMAPHANDLE. Then, pass the address of the variable in the pBitmap parameter. This function will update the variable with the handle to the annotation object's secondary bitmap.

A pushpin object has a primary bitmap, (manipulated using LAnnPushPin::SetBitmap/LAnnPushPin::GetBitmap) when the text is shown, and a secondary bitmap, manipulated using LAnnPushPin::SetSecondaryBitmap/LAnnPushPin::GetSecondaryBitmap. The primary bitmap is shown with the note text. The secondary bitmap is shown by itself when the note is minimized.

In design mode, the PushPin object shows the text and displays the primary bitmap. In run mode, the object shows/hides the text when clicked. The pushpin object has the active mode property. When the mode is ANNACTIVE_ENABLED, the text is shown and the primary bitmap is painted in the top-left corner of the note.

When the mode is ANNACTIVE_DISABLED, the text is hidden and the secondary bitmap is displayed.

Required DLLs and Libraries

LTANN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

Example

For an example of both forms of LAnnPushPin::GetSecondaryBitmap(pBitmap), refer to LAnnPushPin::GetBitmap.

Download our FREE evaluation

Help Version 20.0.2020.4.5

LEADTOOLS Raster Imaging C++ Class Library Help

Introduction

Version History

Getting Started

LEADTOOLS Raster Imaging Features

Redistributables/Files To Be Included With Your Application

Quick Reference

Tutorials

Classes and Member Functions

Summary of Features

Functions:	LAnnPushPin::SetSecondaryBitmap, LAnnPushPin::GetBitmap, LAnnPushPin::SetBitmap, Class Members
Topics:	Annotation Functions: Object Properties
	Using Annotation Bitmap Objects