StringFormat：：GenericDefault 方法 (gdiplusstringformat.h)

项目
08/24/2023

StringFormat：：GenericDefault 方法创建一个泛型的默认 StringFormat 对象。

语法

const StringFormat * GenericDefault();

返回值

类型： StringFormat*

此方法返回指向新 StringFormat 对象的指针。

注解

泛型默认 StringFormat 对象具有以下特征：

未设置字符串格式标志。
字符对齐和行对齐设置为 StringAlignmentNear。
语言 ID 设置为非特定语言，这意味着使用与调用线程关联的当前语言。
字符串数字替换设置为 StringDigitSubstituteUser。
热键前缀设置为 HotkeyPrefixNone。
制表位数设置为零。
字符串剪裁设置为 StringTrimmingCharacter。

示例

下面的示例创建一个泛型的默认 StringFormat 对象，然后使用它绘制格式化字符串。该代码还会绘制字符串的布局矩形。

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

要求


最低受支持的客户端	Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	gdiplusstringformat.h (包括 Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll