Método Pen::SetDashOffset (gdipluspen.h)
El método Pen::SetDashOffset establece la distancia desde el inicio de la línea hasta el inicio del primer guión en una línea discontinua.
Sintaxis
Status SetDashOffset(
[in] REAL dashOffset
);
Parámetros
[in] dashOffset
Tipo: REAL
Número real que especifica el número de veces que se van a desplazar los espacios en una línea discontinua. Cada desplazamiento es igual a la longitud de un espacio en la línea discontinua.
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
Un valor dashOffset positivo desplaza el primer guión hacia delante a lo largo de la ruta de acceso y un valor dashOffset negativo desplaza el inicio de la ruta hacia delante a lo largo del primer guión.
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 establece el valor de desplazamiento del lápiz y dibuja una segunda línea.
VOID Example_SetDashOffset(HDC hdc)
{
Graphics graphics(hdc);
// Create a Pen object, set the dash style, and draw a line.
Pen pen(Color(255, 0, 0, 255), 15);
pen.SetDashStyle(DashStyleDash);
graphics.DrawLine(&pen, 0, 50, 400, 50);
// Set the dash offset value for the pen, and draw a second line.
pen.SetDashOffset(10);
graphics.DrawLine(&pen, 0, 80, 400, 80);
}
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 (incluya Gdiplus.h) |
Library | Gdiplus.lib |
Archivo DLL | Gdiplus.dll |