Método Pen::SetDashStyle (gdipluspen.h)

Artículo
02/29/2024

El método Pen::SetDashStyle establece el estilo de guión para este objeto Pen .

Sintaxis

Status SetDashStyle(
  [in] DashStyle dashStyle
);

Parámetros

[in] dashStyle

Tipo: DashStyle

Elemento de la enumeración DashStyle que especifica el estilo de guion para este objeto Pen .

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

La longitud de los guiones de una línea discontinua depende del estilo de guión y del ancho del objeto Pen . La longitud del espacio que separa dos guiones en una línea discontinua es igual al ancho del objeto Pen .

Ejemplos

En el ejemplo siguiente se crea un objeto Pen , se establece el estilo de guión y se dibuja una línea. A continuación, el código restablece el estilo de guión, dibuja una segunda línea, restablece el estilo de guion de nuevo y dibuja una tercera línea.

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

   // Create a Pen object.
   Pen pen(Color(255, 0, 0, 255), 15);

   // Set the dash style for the pen, and draw a dashed line.
   pen.SetDashStyle(DashStyleDash);
   graphics.DrawLine(&pen, 0, 50, 400, 150);

   // Reset the dash style for the pen, and draw a second line.
   pen.SetDashStyle(DashStyleDot);
   graphics.DrawLine(&pen, 0, 80, 400, 180); 

   // Reset the dash style for the pen, and draw a third line.
   pen.SetDashStyle(DashStyleDashDot);
   graphics.DrawLine(&pen, 0, 110, 400, 210); 
}

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