Metodo IInkRenderer::Measure (msinkaut.h)

Articolo
02/29/2024

Calcola il rettangolo nel contesto di dispositivo che conterrà una raccolta di tratti se i tratti sono stati disegnati con l'oggetto InkRenderer utilizzando il metodo DrawStroke .

Sintassi

HRESULT Measure(
  [in]          IInkStrokes   *Strokes,
  [out, retval] IInkRectangle **Rectangle
);

Parametri

[in] Strokes

Raccolta di tratti da misurare.

[out, retval] Rectangle

Quando termina, questo metodo contiene un puntatore al rettangolo nel contesto del dispositivo che conterrà i tratti se sono stati disegnati con il metodo DrawStroke dell'oggetto InkRenderer . I tratti devono contenere coordinate x e y per calcolare il rettangolo. In caso contrario, il metodo restituisce un rettangolo vuoto.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Un parametro contiene un puntatore non valido.
E_INVALIDARG	Handle di visualizzazione non valido.
E_INK_INCOMPATIBLE_OBJECT	Il parametro strokes non punta a un oggetto valido.
E_INK_MISMATCHED_INK_OBJECT	Il parametro strokes è associato a un oggetto InkDisp diverso.
E_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo .
E_UNEXPECTED	Parametro o tipo di proprietà imprevisto.

Commenti

Questa operazione è accurata solo se si passano gli stessi argomenti sia a Measure che a DrawStroke.

Poiché il rettangolo di selezione è influenzato dalla larghezza della penna, questa larghezza viene ridimensionata in modo appropriato per la trasformazione di visualizzazione di InkRenderer. A tale scopo, la larghezza della penna viene moltiplicata per la radice quadrata del determinante della trasformazione di visualizzazione. L'altezza e la larghezza del rettangolo di selezione vengono espanse di metà di questa quantità in ogni direzione e i lati destro e inferiore vengono incrementati di uno.

Si consideri ad esempio che la larghezza della penna è originariamente 53, la radice quadrata del determinante della trasformazione di visualizzazione è 50 e il rettangolo di selezione è (0, 0, 1000, 1000). La regolazione della larghezza della penna per il rettangolo di selezione in ogni direzione viene calcolata come (53 * 50) / 2 e i lati destro e inferiore vengono incrementati di uno. Il risultato è un rettangolo delimitatore di cui è stato eseguito il rendering (-1325, -1325, 2326, 2326).

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll

Vedi anche

Metodo Draw [Classe InkRenderer]

IInkRenderer

Interfaccia IInkStrokeDisp

Classe InkRenderer

MeasureStroke, metodo

Condividi tramite