Método IAnalysisRegion::GetRegionScans
Recupera uma matriz de retângulos que define a área de IAnalysisRegion.
Sintaxe
HRESULT GetRegionScans(
[out] ULONG *pulCount,
[out] RECT **pRegionScans
);
Parâmetros
-
pulCount [out]
-
O número de retângulos retornados em pRegionScans.
-
pRegionScans [out]
-
Um ponteiro para uma matriz de retângulos que define a área de IAnalysisRegion.
Valor retornado
Para obter uma descrição dos valores retornados, consulte Classes e interfaces – Análise de tinta.
Comentários
Se pRegionScans for passado como NULL, o método GetRegionScans retornará S_OK e o número de retângulos será retornado em pulCount.
Cuidado
Para evitar uma perda de memória, use CoTaskMemFree para liberar a memória de *pRegionScans quando você não precisar mais das informações.
Os limites dos retângulos estão em coordenadas de espaço à tinta.
A união dos retângulos retornados representa a área de IAnalysisRegion.
Exemplos
O exemplo a seguir mostra como obter os retângulos que definem a área de IAnalysisRegionregion e como obter apenas o número de retâ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 | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP Tablet PC Edition [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Nenhum compatível |
| Cabeçalho |
|
| DLL |
|