フレームを表示

L_AnnGetSnapToGrid

フレームを表示

#include "l_bitmap.h"

L_LTANN_API L_INT EXT_FUNCTION L_AnnGetSnapToGridhAutomationpuSnapToGridModepOptions

HANNOBJECT hAutomation;

/* 自動オブジェクトへのハンドル*/

L_UINT *puSnapToGridMode;

/* グリッドスナップ状態(つけるかつけない)を指定する定数で更新される変数のアドレス*/

pANNSNAPTOGRIDOPTIONS pOptions;

/* グリッドスナップオプションを指定する構造体へのポインタ*/

現在のグリッドスナップ状態(つけるかつけない)と見た目とアノテーショングリッドスナップの動作を決定するオプションを取得します。

パラメーター

説明

hAutomation

アノテーションオートメーションオブジェクトを扱えます。

puSnapToGridMode

グリッドスナップ状態を指定する定数で更新される変数のアドレス。設定可能な値は、以下の通りです。

uSnapToGridMode

グリッドスナップ状態を指定する定数。設定可能な値は、以下の通りです。

 

意味

 

ANN_SNAPTOGRID_OFF

グリッドスナップ機能が無効になっています。

 

ANN_SNAPTOGRID_ON

グリッドスナップ機能有効にされる、そして、オートメーション設計モードで見える、

pOptions

ANNSNAPTOGRIDOPTIONS構造体へのポインターは、グリッドスナップオプションでアップデートされます。

戻り値

SUCCESS

関数は成功しました。

<1

エラーが発生しました。リターンコードを参照してください

コメント

この関数は、現在のアノテーショングリッドスナップ状態(つけるかつけない)を取得して、グリッドスナップ外観と動作をカスタマイズするオプションを取得するのに用いられます。

グリッドスナップ機能が、正確にアノテーションオブジェクトを描画して、見つけて、位置合わせするのにユーザーを見込むために、アノテーションオートメーション設計モードで使われます。グリッドスナップがuSnapToGridModeパラメーターをANN_SNAPTOGRID_ONに設定することによって有効にされるとき、点と行からなる格子図形はimageの上でオーバレイです。設計モードではアノテーションを作成するとき、各々のポイントは最も近いグリッド点にスナップします。この動作は、作成している任意のアノテーションオブジェクトEXCEPTのために、フリーハンドのアノテーションを保持します。フリーハンドのアノテーションを作成するとき、これがフリーハンドの動作に悪影響を与えるので、個々のポイントは最も近いグリッド点にスナップしません。アノテーションオブジェクトの境界ボックスが最も近いグリッド点にカチッとしまるという点で、グリッドスナップ機能は設計モードではすべてのアノテーションオブジェクトタイプを移動することに影響を及ぼします。

グリッドスナップ状態を速く決定するために、puSnapToGridModeパラメーターのために型L_UINTのアドレス変数の世代を渡します、そして、pOptionsパラメーターのためにNULLを渡します。

グリッドスナップの見た目と動作をカスタマイズするグリッドスナップオプションのリストを取得するために、型ANNSNAPTOGRIDOPTIONSの変数を宣言します、そして、pOptionsのためにこの変数のアドレスを渡します。アノテーショングリッドスナップ機能の詳解のために、ANNSNAPTOGRIDOPTIONSのためにドキュメンテーションを参照します。

必須のDLLとライブラリ

LTANN

ツールキットバージョンに基づいた正確なDLLとライブラリのリストについては、「アプリケーションとともに配布するファイル」を参照してください

プラットホーム

Win32 x 64

参照

関数:

L_AnnSetSnapToGrid

トピック:

アノテーションObjects-オートメーション化した機能

サンプル

サンプルのために、参照しますL_AnnSetSnapToGrid