Graphics::D rawDriverString-Methode (gdiplusgraphics.h)
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 |