Metodo IInkDisp::GetBoundingBox (msinkaut.h)

Articolo
08/24/2023

Recupera i rettangoli delimitatore 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      **Rectangle
);

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 valore predefinito è -1 (IBBM_DEFAULT), il che significa che tutte le caratteristiche di un tratto vengono utilizzate per specificare il rettangolo di selezione.

[out, retval] Rectangle

Quando termina, questo metodo contiene il 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


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

IInkDisp

Enumerazione InkBoundingBoxMode

Classe InkDisp

Classe InkRectangle

Condividi tramite