LAnnotation::GetSnapToGrid

#include "ltwrappr.h"

virtual L_INT LAnnotation::GetSnapToGrid(puSnapToGridMode, pOptions, uStructSize)

L_UINT * puSnapToGridMode;

address of the variable to be updated with a constant that specifies the snap-to-grid state (on or off)

pANNSNAPTOGRIDOPTIONS pOptions;

pointer to a structure that specifies snap-to-grid options

L_UINT uStructSize;

size in bytes, of the structure pointed to by pOptions

Gets the current snap-to-grid state (on or off), and the options that determine the look and the behavior of the annotation snap-to-grid.

Parameter Description
puSnapToGridMode Address of the variable to be updated with the constant that specifies the snap-to-grid state. Possible values are:
  Value Meaning
  ANN_SNAPTOGRID_OFF The snap-to-grid feature is disabled.
  ANN_SNAPTOGRID_ON The snap-to-grid feature is enabled, and is visible in automation design mode.
pOptions Pointer to the ANNSNAPTOGRIDOPTIONS structure will be updated with the snap-to-grid options.
uStructSize Size in bytes, of the structure pointed to by pOptions, for versioning. Use sizeof(ANNSNAPTOGRIDOPTIONS).

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function is used to get the current annotation snap-to-grid state (on or off), and to get the options that customize the snap-to-grid appearance and behavior.

The snap-to-grid feature is used in annotation automation design mode to allow the user to precisely draw, locate, and align annotation objects. When snap-to-grid is enabled by setting the uSnapToGridMode parameter of the LAnnotation::SetSnapToGrid function to ANN_SNAPTOGRID_ON, a grid pattern consisting of dots and lines is overlayed on the image. When creating annotations in design mode, each point snaps to the nearest grid point. This behavior holds for creating any annotation object EXCEPT the freehand annotation. When creating a freehand annotation, the individual points do NOT snap to the nearest grid point because this would adversely affect the behavior of the freehand. The snap-to-grid feature affects the moving of all annotations object types in design mode, in that the bounding box of the annotation object snaps to the nearest grid point.

To quickly determine the snap-to-grid state, pass the address of a variable of type L_UINT for the puSnapToGridMode parameter, and pass NULL for the pOptions parameter.

To get a list of the snap-to-grid options that customize the look and behavior of the snap-to-grid, declare a variable of type ANNSNAPTOGRIDOPTIONS, and pass the address of this variable for pOptions. For a detailed explanation of the annotation snap-to-grid feature, see the documentation for ANNSNAPTOGRIDOPTIONS.

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.

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++ 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
Call Back Functions
Summary of Features