Metodo IInkStrokeDisp::GetBoundingBox (msinkaut.h)

Articolo
08/25/2023

Recupera le coordinate dello spazio penna per tutti i tratti in 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 usare per calcolare il rettangolo di selezione. Il valore predefinito è -1, che indica che tutte le caratteristiche di un tratto vengono usate per specificare 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 .

[out, retval] Rectangle

Quando questo metodo restituisce, 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 , la casella di selezione restituita è una copia del rettangolo di selezione dei tratti, quindi la modifica del riquadro 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 in base alla radice quadrata della trasformazione della visualizzazione.

Nota In Windows Vista e versioni successive, il metodo GetBoundingBox non prende in considerazione la larghezza del tratto.

Nota Se non è stata impostata in modo esplicito la larghezza della penna, è 53 per impostazione predefinita. È necessario moltiplicare la larghezza della penna in base alla radice quadrata del determinante per restituire 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 nel rettangolo di selezione in ogni direzione viene calcolata come (53 * 50) / 2 e i lati destro e inferiore vengono incrementati per uno. In questo modo viene restituito un rettangolo di selezione di (-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

Interfaccia IInkStrokeDisp

Enumerazione InkBoundingBoxMode

Classe InkRectangle

Condividi tramite