Метод 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 Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера |
Ни одна версия не поддерживается |
| Заголовок |
|
| DLL |
|