Metodo StringFormat::GenericDefault (gdiplusstringformat.h)

Articolo
08/24/2023

Il metodo StringFormat::GenericDefault crea un oggetto StringFormat generico e predefinito.

Sintassi

const StringFormat * GenericDefault();

Valore restituito

Tipo: StringFormat*

Questo metodo restituisce un puntatore al nuovo oggetto StringFormat .

Commenti

Un oggetto StringFormat generico predefinito presenta le caratteristiche seguenti:

Non vengono impostati flag di formato stringa.
L'allineamento dei caratteri e l'allineamento della riga sono impostati su StringAlignmentNear.
L'ID lingua è impostato su lingua neutrale, il che significa che viene utilizzata la lingua corrente associata al thread chiamante.
La sostituzione delle cifre di stringa è impostata su StringDigitSubstituteUser.
Il prefisso della chiave di scelta rapida è impostato su HotkeyPrefixNone.
Il numero di tabulazioni è impostato su zero.
Il ritaglio di stringhe è impostato su StringTrimmingCharacter.

Esempio

Nell'esempio seguente viene creato un oggetto StringFormat generico e predefinito e quindi lo usa per disegnare una stringa formattata. Il codice disegna anche il rettangolo di layout della stringa.

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);
}

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusstringformat.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll