Graphics::D rawString(constWCHAR,INT,constFont,constRectF&,constStringFormat,constBrush) (gdiplusgraphics.h)

Artículo
01/10/2024

El método Graphics::D rawString dibuja una cadena basada en una fuente, un rectángulo de diseño y un formato.

Sintaxis

Status DrawString(
  const WCHAR        *string,
  INT                length,
  const Font         *font,
  const RectF &      layoutRect,
  const StringFormat *stringFormat,
  const Brush        *brush
);

Parámetros

string

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

length

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.

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.

layoutRect

Referencia a un rectángulo que enlaza la cadena.

stringFormat

Puntero a un objeto StringFormat que especifica información de diseño de texto y manipulaciones de visualización que se aplicarán a la cadena.

brush

Puntero a un objeto Brush que se usa para rellenar la cadena.

Valor devuelto

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 usa el formato especificado para dibujar una cadena en un rectángulo de diseño.

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

   // Create a string.
   WCHAR string[] = L"Sample Text";
   
   // Initialize arguments.
   Font myFont(L"Arial", 16);
   RectF layoutRect(0.0f, 0.0f, 200.0f, 50.0f);
   StringFormat format;
   format.SetAlignment(StringAlignmentCenter);
   SolidBrush blackBrush(Color(255, 0, 0, 0));

   // Draw string.
   graphics.DrawString(
   string,
   11,
   &myFont,
   layoutRect,
   &format,
   &blackBrush);

   // Draw layoutRect.
   graphics.DrawRectangle(&Pen(Color::Black, 3), layoutRect);
}