#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnSetSnapToGrid(hAutomation, uSnapToGridMode, pOptions)

HANNOBJECT hAutomation;

handle to the automation object

L_UINT uSnapToGridMode;

constant that specifies the snap-to-grid state (on or off)


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

Sets the state (on or off), the look, and the behavior of the annotation snap-to-grid.

Parameter Description
hAutomation Handle to the annotation automation object.
uSnapToGridMode The constant that specifies the snap-to-grid state. Possible values are.
uSnapToGridMode The constant that specifies the snap-to-grid state. Possible values are:
  Value Meaning
  ANN_SNAPTOGRID_OFF The snap-to-grid features is disabled.
  ANN_SNAPTOGRID_ON The snap-to-grid features is enabled, and is visible in automation design mode
pOptions Pointer to the ANNSNAPTOGRIDOPTIONS structure that LEADTOOLS uses to customize the look and behavior of the snap-to-grid.



The function was successful.

< 1

An error occurred. Refer to Return Codes.


This function is used to enable or disable a snap-to-grid, and to customize its 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 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 enable to disable the snap-to-grid, pass the appropriate constant for uSnapToGridMode parameter, and pass NULL for the pOptions parameter.

To 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


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


Win32, x64.

See Also




Annotation Objects - Automated Features


This sample

Help Version 20.0.2019.3.12
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2019 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help