Graphics::MeasureDriverString-Methode (gdiplusgraphics.h)

Artikel
02/26/2024

Die Graphics::MeasureDriverString-Methode misst das Begrenzungsfeld für die angegebenen Zeichen und die entsprechenden Positionen.

Syntax

Status MeasureDriverString(
  [in]  const UINT16 *text,
  [in]  INT          length,
  [in]  const Font   *font,
  [in]  const PointF *positions,
  [in]  INT          flags,
  [in]  const Matrix *matrix,
  [out] RectF        *boundingBox
);

Parameter

[in] text

Typ: const UINT16*

Zeiger auf ein Array von 16-Bit-Werten. Wenn das Flag DriverStringOptionsCmapLookup festgelegt ist, gibt jeder Wert ein Unicode-Zeichen an, das angezeigt werden soll. Andernfalls gibt jeder Wert einen Index für eine Schriftart an, die ein anzuzeigende Zeichen definiert.

[in] length

Typ: INT

Eine ganze Zahl, die die Anzahl der Werte im Textarray angibt. Der length-Parameter kann auf –1 festgelegt werden, wenn die Zeichenfolge null beendet ist.

[in] font

Typ: const Font*

Zeiger auf ein Font-Objekt , das den Familiennamen, die Größe und den Stil der Schriftart angibt, die auf die Zeichenfolge angewendet werden soll.

[in] positions

Typ: const PointF*

Wenn das Flag DriverStringOptionsRealizedAdvance festgelegt ist, ist positions ein Zeiger auf ein PointF-Objekt , das die Position der ersten Glyphe angibt. Andernfalls handelt es sich bei Positionen um ein Array von PointF-Objekten , von denen jedes den Ursprung einer einzelnen Glyphe angibt.

[in] flags

Typ: INT

Ganzzahl, die die Optionen für die Darstellung der Zeichenfolge angibt. Dieser Wert muss ein Element der DriverStringOptions-Enumeration oder das Ergebnis eines bitweisen OR sein, das auf mindestens zwei dieser Elemente angewendet wird.

[in] matrix

Typ: const Matrix*

Zeiger auf ein Matrix-Objekt , das die Transformationsmatrix angibt, die auf jeden Wert im Textarray angewendet werden soll.

[out] boundingBox

Typ: RectF*

Zeiger auf ein RectF-Objekt , das das Rechteck empfängt, das die Zeichenfolge umgibt.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusgraphics.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll