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	IACom.h (também requer IACom_i.c)
DLL	IACom.dll

Confira também

IAnalysisRegion

Método IAnalysisRegion::GetBounds

Referência de análise de tinta