Metodo IAnalysisRegion::GetRegionScans
Recupera una matrice di rettangoli che definisce l'area di IAnalysisRegion.
Sintassi
HRESULT GetRegionScans(
[out] ULONG *pulCount,
[out] RECT **pRegionScans
);
Parametri
-
pulCount [out]
-
Numero di rettangoli restituiti in pRegionScans.
-
pRegionScans [out]
-
Puntatore a una matrice di rettangoli che definisce l'area di IAnalysisRegion.
Valore restituito
Per una descrizione dei valori restituiti, vedere Classi e interfacce - Analisi input penna.
Commenti
Se pRegionScans viene passato come NULL, il metodo GetRegionScans restituisce S_OK e il numero di rettangoli viene restituito in pulCount.
Attenzione
Per evitare una perdita di memoria, usare CoTaskMemFree per rilasciare la memoria da *pRegionScans quando non sono più necessarie le informazioni.
I limiti dei rettangoli sono coordinate dello spazio input penna.
L'unione dei rettangoli restituiti rappresenta l'area di IAnalysisRegion.
Esempio
Nell'esempio seguente viene illustrato come ottenere i rettangoli che definiscono l'area di IAnalysisRegionregion e come ottenere solo il numero di rettangoli.
// 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);
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP Tablet PC Edition [solo app desktop] |
| Server minimo supportato |
Nessuno supportato |
| Intestazione |
|
| DLL |
|