Metodo IInkStrokes::GetBoundingBox (msinkaut.h)

Articolo
02/29/2024

Ottiene il rettangolo di selezione nelle coordinate dello spazio input penna per tutti i tratti di un oggetto InkDisp , un singolo tratto o un insieme InkStrokes .

Sintassi

HRESULT GetBoundingBox(
  [in, optional] InkBoundingBoxMode BoundingBoxMode,
  [out, retval]  IInkRectangle      **BoundingBox
);

Parametri

[in, optional] BoundingBoxMode

Facoltativo. Specifica le caratteristiche del tratto da utilizzare per calcolare il rettangolo di selezione. Per altre informazioni sull'uso delle caratteristiche del tratto per calcolare un rettangolo di selezione, vedere il tipo di enumerazione BoundingBoxMode .

Il parametro BoundingBoxMode del metodo GetBoundingBox ha un valore predefinito -1, il che significa che tutte le caratteristiche di un tratto vengono utilizzate per specificare il rettangolo di selezione.

[out, retval] BoundingBox

Quando termina, questo metodo contiene un puntatore al rettangolo che definisce il rettangolo di selezione di un oggetto InkDisp , un oggetto IInkStrokeDisp o un insieme InkStrokes .

Nota Per un oggetto IInkStrokeDisp , il rettangolo di selezione restituito è una copia del riquadro dei tratti, pertanto la modifica del rettangolo di selezione restituito non influisce sulla posizione dei tratti.

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_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo .
E_UNEXPECTED	Parametro o tipo di proprietà imprevisto.
REGDB_CLASSNOTREG	L'oggetto InkRectangle non è registrato.

Commenti

Quando il rettangolo di selezione è interessato 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.

Nota In Windows Vista e versioni successive, il metodo GetBoundingBox non tiene conto della larghezza del tratto.

Nota Se la larghezza della penna non è stata impostata in modo esplicito, per impostazione predefinita è 53. È necessario moltiplicare la larghezza della penna per la radice quadrata del determinante per produrre il rettangolo di selezione corretto. L'altezza e la larghezza del rettangolo di selezione vengono espanse per metà di questa quantità in ogni direzione. Si consideri ad esempio che la larghezza della penna è 53, la radice quadrata del determinante è 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

IInkStrokes

Enumerazione InkBoundingBoxMode

Classe InkRectangle

Insieme InkStrokes

Condividi tramite