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

Artículo
08/24/2023

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

Sintaxis

Status AddString(
  const WCHAR        *string,
  INT                length,
  const FontFamily   *family,
  INT                style,
  REAL               emSize,
  const PointF &     origin,
  const StringFormat *format
);

Parámetros

string

Puntero a una cadena de caracteres anchos.

length

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.

family

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

style

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.

emSize

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

origin

Referencia a un objeto PointF que especifica, en unidades del mundo, la ubicación de la cadena.

format

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

Valor devuelto

Type:Status

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, 
      PointF(50.0f, 50.0f),
      NULL);

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