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

Artículo
02/26/2024

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