Graphics::D rawString(constWCHAR*,INT,constFont*,constPointF&,constBrush*) (gdiplusgraphics.h)

El método Graphics::D rawString dibuja una cadena basada en una fuente y un origen para la cadena.

Sintaxis

Status DrawString(
  [in]      const WCHAR    *string,
  [in]      INT            length,
  [in]      const Font     *font,
  [in, ref] const PointF & origin,
  [in]      const Brush    *brush
);

Parámetros

[in] string

Tipo: const WCHAR*

Puntero a una cadena de caracteres anchos que se va a dibujar.

[in] length

Tipo: INT

Entero que especifica el número de caracteres de la matriz de cadenas . El parámetro length se puede establecer en –1 si la cadena termina en null.

[in] font

Tipo: const Font*

Puntero a un objeto Font que especifica los atributos de fuente (el nombre de familia, el tamaño y el estilo de la fuente) que se van a usar.

[in, ref] origin

Tipo: const PointF

Referencia a un objeto PointF que especifica el punto inicial de la cadena.

[in] brush

Tipo: pincel* const

Puntero a un objeto Brush que se usa para rellenar 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.

Al usar la API de GDI+, no debe permitir que la aplicación descargue fuentes arbitrarias de orígenes que no son de confianza. El sistema operativo requiere privilegios elevados para asegurarse de que todas las fuentes instaladas son de confianza.

Ejemplos

En el ejemplo siguiente se dibuja una cadena en el origen especificado.

VOID Example_DrawString2(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a string.
   WCHAR string[] = L"Sample Text";

   // Initialize arguments.
   Font myFont(L"Arial", 16);
   PointF origin(0.0f, 0.0f);
   SolidBrush blackBrush(Color(255, 0, 0, 0));

   // Draw string.
   graphics.DrawString(
   string,
   11,
   &myFont,
   origin,
   &blackBrush);
}

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	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll

Consulte también

Fuente

Elementos gráficos

Graphicspath

SolidBrush