IAnalysisRegion::GetRegionScans メソッド
IAnalysisRegion の領域を定義する四角形の配列を取得します。
構文
HRESULT GetRegionScans(
[out] ULONG *pulCount,
[out] RECT **pRegionScans
);
パラメーター
-
pulCount [out]
-
pRegionScans で返される四角形の数。
-
pRegionScans [out]
-
IAnalysisRegion の領域を定義する四角形の配列へのポインター。
戻り値
戻り値の説明については、「 クラスとインターフェイス - インク分析」を参照してください。
解説
pRegionScans が NULL として渡された場合、GetRegionScans メソッドは S_OKを返し、四角形の数は pulCount で返されます。
注意事項
メモリ リークを回避するには、 CoTaskMemFree を使用して、情報が不要になったときに *pRegionScans からメモリを解放します。
四角形の境界は、インク空間座標内にあります。
返される四角形の和集合は、 IAnalysisRegion の領域を表します。
例
次の例は、 IAnalysisRegion の領域を定義する四角形を取得する方法と、 region 四角形の数のみを取得する方法を示しています。
// Get the count and the rectangles.
ULONG count = 0;
RECT* rects = 0;
region->GetRegionScans(&count, &rects);
// Use rects
::CoTaskMemFree(rects);
// GetRegionScans just gets the count and returns S_OK
ULONG number = 0;
region->GetRegionScans(&number, NULL);
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| ヘッダー |
|
| [DLL] |
|