Método Pen::SetDashStyle (gdipluspen.h)
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 |