AnnoSetLayers

#include “BiAnno.h”

BOOL CALLBACK AnnoSetLayers( INT_PTR  PAnno,
LPWORD lpLayers,
WORD      wNumOfLayers )

Description

Sets the viewable and editable layers. The layer numbering is 0-based and the default layer is 0 (zero).

Parameters

INT_PTR

pAnno

Annotation handle

LPWORD

lpLayers

Pointer to an array, which contains the 16 bit layer numbers to set

WORD

wNumOfLayers

The number of data items (layers) in the array

Return value

FALSE, if there is not enough memory, otherwise TRUE.

Programming Notes

You can choose one or more layer to view and edit at the same time. Objects on the viewable layers can be modified. New objects are placed on the active layer, which can be specified by the AnnoSelectLayer function. The active layer must be one of the viewable layers,  so  you  cannot  change  the  active  layer, if  the  number you pass to the AnnoSelectLayer function is not in the layer list entered by the AnnoSetLayers function. On the other hand, the AnnoSetLayers function can specify different layers than the active layer, in this case the first layer in the array will be the active.

If lpLayers or wNumOfLayers is NULL(0), all the layers will be visible (this is the default). The Annotation SDK allocates memory inside for the layer number array, so you can free your array immediately after the function returns.

Code Example

None