IInkStrokes::GetBoundingBox-Methode (msinkaut.h)

Artikel
03/04/2024

Ruft das Begrenzungsfeld in Freihandraumkoordinaten für alle Striche in einem InkDisp-Objekt , einer einzelnen Striche oder einer InkStrokes-Auflistung ab.

Syntax

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

Parameter

[in, optional] BoundingBoxMode

Optional. Gibt die Strichmerkmale an, die zum Berechnen des Begrenzungsrahmens verwendet werden sollen. Weitere Informationen zur Verwendung von Strichmerkmalen zum Berechnen eines Begrenzungsrahmens finden Sie im Enumerationstyp BoundingBoxMode .

Der BoundingBoxMode-Parameter der GetBoundingBox-Methode weist den Standardwert -1 auf. Dies bedeutet, dass alle Merkmale eines Strichs verwendet werden, um das Begrenzungsfeld anzugeben.

[out, retval] BoundingBox

Wenn diese Methode zurückgibt, enthält einen Zeiger auf das Rechteck, das das begrenzungsfeld eines InkDisp-Objekts , eines IInkStrokeDisp-Objekts oder einer InkStrokes-Auflistung definiert.

Hinweis Bei einem IInkStrokeDisp-Objekt ist das zurückgegebene Begrenzungsfeld eine Kopie des Begrenzungsrahmens für Striche, sodass sich das Ändern des zurückgegebenen Begrenzungsrahmens nicht auf die Position der Striche auswirkt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_UNEXPECTED	Unerwarteter Parameter oder Eigenschaftstyp.
REGDB_CLASSNOTREG	Das InkRectangle-Objekt ist nicht registriert.

Hinweise

Wenn das begrenzungsfeld von der Stiftbreite beeinflusst wird, wird diese Breite für die Transformation der Ansicht des InkRenderers entsprechend skaliert. Dazu wird die Stiftbreite mit der Quadratwurzel der Determinante der Ansichtstransformation multipliziert.

Hinweis In Windows Vista und höheren Versionen berücksichtigt die GetBoundingBox-Methode nicht die Breite des Strichs.

Hinweis Wenn Sie die Stiftbreite nicht explizit festgelegt haben, ist sie standardmäßig 53. Sie müssen die Stiftbreite mit der Quadratwurzel der Determinante multiplizieren, um das richtige Begrenzungsfeld zu erhalten. Die Höhe und Breite des Begrenzungsrahmens werden in jeder Richtung um die Hälfte dieses Betrags erweitert. Nehmen Sie beispielsweise an, dass die Stiftbreite 53, die Quadratwurzel der Determinante 50 und das umgebende Feld (0, 0, 1000, 1000) ist. Die Anpassung der Stiftbreite an das Begrenzungsfeld in jeder Richtung wird als (53 * 50) / 2 berechnet, und die rechte und untere Seite werden um eins erhöht. Dies führt zu einem gerenderten Begrenzungsrahmen von (-1325, -1325, 2326, 2326).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll

Weitere Informationen

IInkStrokes

InkBoundingBoxMode-Enumeration

InkRectangle-Klasse

InkStrokes-Sammlung

Freigeben über