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

Weitere Informationen

Schriftart

Hotkeyprefix

LOGFONT

RectF

StringAlignment

StringDigitSubstitute

StringFormat

Stringformatflags

Stringtrimming