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