Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |