Condividi tramite


Metodo IInkStrokeDisp::GetBoundingBox (msinkaut.h)

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