Compartir a través de


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

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 RectF &      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 RectF

Referencia a un objeto RectF 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 realiza 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, 
      RectF(50.0f, 50.0f, 150.0f, 100.0f),
      NULL);

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

Requisitos

   
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

Consulte también

Métodos AddString

Recorte con una región

Crear y dibujar trazados

Creación de un degradado de trazado

Fuente

FontFamily

FontStyle

Graphicspath

RectF

StringFormat

Uso de texto y fuentes