Método IAnalysisRegion::GetRegionScans
Recupera una matriz de rectángulos que define el área de IAnalysisRegion.
Sintaxis
HRESULT GetRegionScans(
[out] ULONG *pulCount,
[out] RECT **pRegionScans
);
Parámetros
-
pulCount [out]
-
Número de rectángulos devueltos en pRegionScans.
-
pRegionScans [out]
-
Puntero a una matriz de rectángulos que define el área del IAnalysisRegion.
Valor devuelto
Para obtener una descripción de los valores devueltos, vea Clases e interfaces : análisis de entrada de lápiz.
Observaciones
Si pRegionScans se pasa como NULL, el método GetRegionScans devuelve S_OK y el número de rectángulos se devuelve en pulCount.
Precaución
Para evitar una fuga de memoria, use CoTaskMemFree para liberar la memoria de *pRegionScans cuando ya no necesite la información.
Los límites de los rectángulos están en coordenadas de espacio de tinta.
La unión de los rectángulos devueltos representa el área del IAnalysisRegion.
Ejemplos
En el ejemplo siguiente se muestra cómo obtener los rectángulos que definen el área de IAnalysisRegionregion y cómo obtener solo el número de rectángulos.
// 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);
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP Tablet PC Edition [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
No se admite ninguno |
| Encabezado |
|
| Archivo DLL |
|