StringFormat::GenericDefault-Methode (gdiplusstringformat.h)
Die StringFormat::GenericDefault-Methode erstellt ein generisches StringFormat-Standardobjekt .
Syntax
const StringFormat * GenericDefault();
Rückgabewert
Typ: StringFormat*
Diese Methode gibt einen Zeiger auf das neue StringFormat-Objekt zurück.
Hinweise
Ein generisches StringFormat-Standardobjekt weist die folgenden Merkmale auf:
- Es sind keine Zeichenfolgenformatflags festgelegt.
- Zeichenausrichtung und Linienausrichtung sind auf StringAlignmentNear festgelegt.
- Die Sprach-ID ist auf neutrale Sprache festgelegt, was bedeutet, dass die aktuelle Sprache verwendet wird, die dem aufrufenden Thread zugeordnet ist.
- Die Zeichenfolgenersetzung ist auf StringDigitSubstituteUser festgelegt.
- Das Präfix für hot key ist auf HotkeyPrefixNone festgelegt.
- Die Anzahl der Tabstopps ist auf 0 festgelegt.
- Das Kürzen von Zeichenfolgen ist auf StringTrimmingCharacter festgelegt.
Beispiele
Im folgenden Beispiel wird ein generisches StringFormat-Standardobjekt erstellt und anschließend zum Zeichnen einer formatierten Zeichenfolge verwendet. Der Code zeichnet auch das Layoutrechteck der Zeichenfolge.
VOID Example_GenericDefault(HDC hdc)
{
Graphics graphics(hdc);
SolidBrush solidBrush(Color(255, 255, 0, 0));
FontFamily fontFamily(L"Times New Roman");
Font font(&fontFamily, 12, FontStyleRegular, UnitPoint);
// Create a generic StringFormat object.
const StringFormat* pStringFormat = StringFormat::GenericDefault();
// Use the generic StringFormat object in a call to DrawString.
graphics.DrawString(
L"This text was formatted by a generic StringFormat object.",
57, // string length
&font,
RectF(30, 30, 100, 120),
pStringFormat,
&solidBrush);
// Draw the rectangle that encloses the text.
Pen pen(Color(255, 255, 0, 0));
graphics.DrawRectangle(&pen, 30, 30, 100, 120);
}
Anforderungen
| 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 | gdiplusstringformat.h (include Gdiplus.h) |
| Bibliothek | Gdiplus.lib |
| DLL | Gdiplus.dll |