GraphicsPath::AddString(constWCHAR,INT,constFontFamily,INT,REAL,constRect&,constStringFormat*) (gdipluspath.h)

Artículo
02/29/2024

El método GraphicsPath::AddString agrega el esquema de una cadena a esta ruta de acceso.

Sintaxis

Status AddString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const FontFamily   *family,
  [in]      INT                style,
  [in]      REAL               emSize,
  [in, ref] const Rect &       layoutRect,
  [in]      const StringFormat *format
);

Parámetros

[in] string

Tipo: const WCHAR*

Puntero a una cadena de caracteres anchos.

[in] length

Tipo: INT

Entero que especifica el número de caracteres que se van a mostrar. Si el parámetro de cadena apunta a una cadena terminada en NULL, este parámetro se puede establecer en –1.

[in] family

Tipo: const FontFamily*

Puntero a un objeto FontFamily que especifica la familia de fuentes de la cadena.

[in] style

Tipo: INT

Entero que especifica el estilo del tipo de letra. Este valor debe ser un elemento de la enumeración FontStyle o el resultado de un OR bit a bit aplicado a dos o más de estos elementos. Por ejemplo, FontStyleBold | FontStyleUnderline | FontStyleStrikeout establece el estilo como una combinación de los tres estilos.

[in] emSize

Tipo: REAL

Número real que especifica el tamaño em, en unidades del mundo, de los caracteres de cadena.

[in, ref] layoutRect

Tipo: const Rect

Referencia a un objeto Rect que especifica, en unidades del mundo, el rectángulo delimitador de la cadena.

[in] format

Tipo: const StringFormat*

Puntero a un objeto StringFormat que especifica información de diseño (alineación, recorte, tabulaciones y similares) para la cadena.

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Tenga en cuenta que GDI+ no admite fuentes PostScript ni fuentes OpenType que no tienen esquemas TrueType.

Ejemplos

En el ejemplo siguiente se crea una ruta de acceso de objeto GraphicsPath, se agrega una cadena terminada en NULL a la ruta de acceso y, a continuación, se dibuja la ruta de acceso.

VOID Example_AddString(HDC hdc)
{
   Graphics graphics(hdc);
   FontFamily fontFamily(L"Times New Roman");
   GraphicsPath path;

   path.AddString(
      L"Hello World", 
      -1,                 // NULL-terminated string
      &fontFamily, 
      FontStyleRegular, 
      48, 
      Rect(50, 50, 150, 100),
      NULL);

   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdipluspath.h (incluya Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll