Método Pen::SetDashPattern (gdipluspen.h)
El método Pen::SetDashPattern establece una matriz de guiones y espacios personalizados para este objeto Pen .
Sintaxis
Status SetDashPattern(
[in] const REAL *dashArray,
[in] INT count
);
Parámetros
[in] dashArray
Tipo: const REAL*
Puntero a una matriz de números reales que especifica la longitud de los guiones y espacios personalizados. Todos los elementos de la matriz deben ser números reales positivos.
[in] count
Tipo: INT
Entero que especifica el número de elementos de la matriz dashArray . El entero debe ser mayor que 0 y no mayor que el número total de elementos de la matriz.
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
Este método establecerá la enumeración DashStyle para este objeto Pen en DashStyleCustom.
Los elementos de la matriz dashArray establecen la longitud de cada guión y espacio en el patrón dash. El primer elemento establece la longitud de un guión, el segundo elemento establece la longitud de un espacio, el tercer elemento establece la longitud de un guión, etc.
La longitud de cada guión y espacio en el patrón dash es el producto del valor del elemento en la matriz y el ancho del objeto Pen .
Ejemplos
En el ejemplo siguiente se crea una matriz de números reales. A continuación, el código crea un objeto Pen , establece el patrón dash basado en la matriz y, a continuación, dibuja la línea discontinua personalizada.
VOID Example_SetDashPattern(HDC hdc)
{
Graphics graphics(hdc);
// Create and set an array of real numbers.
REAL dashVals[4] = {
5.0f, // dash length 5
2.0f, // space length 2
15.0f, // dash length 15
4.0f}; // space length 4
// Create a Pen object.
Pen pen(Color(255, 0, 0, 0), 5);
// Set the dash pattern for the custom dashed line.
pen.SetDashPattern(dashVals, 4);
// Draw the custom dashed line.
graphics.DrawLine(&pen, 5, 20, 405, 200);
}
Requisitos
| 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 |