Graphics::D rawDriverString-Methode (gdiplusgraphics.h)

Artikel
02/29/2024

Die Graphics::D rawDriverString-Methode zeichnet Zeichen an den angegebenen Positionen. Die -Methode gibt dem Client die vollständige Kontrolle über die Darstellung von Text. Bei der -Methode wird davon ausgegangen, dass der Client bereits das anzuwendende Format und Layout eingerichtet hat.

Syntax

Status DrawDriverString(
  [in] const UINT16 *text,
  [in] INT          length,
  [in] const Font   *font,
  [in] const Brush  *brush,
  [in] const PointF *positions,
  [in] INT          flags,
  [in] const Matrix *matrix
);

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] brush

Typ: const Brush*

Zeiger auf ein Brush-Objekt , das zum Füllen der Zeichenfolge verwendet wird.

[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.

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.

Hinweise

Diese Methode unterstützt die Verarbeitung komplexer Skripts nicht und geht davon aus, dass der Client das gesamte Textlayout auf andere Weise eingerichtet hat. Diese Methode ist nützlich zum Erstellen von menübasierten Elementen, die von Besitzern gezeichnet wurden. Der Client sollte die DrawString Methods-Methode für allgemeine Zwecke verwenden.

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