GraphicsPath::AddString(constWCHAR*,INT,constFontFamily*,INT,REAL,constRect&,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 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 |