Método Pen::GetDashPattern (gdipluspen.h)
El método Pen::GetDashPattern obtiene una matriz de guiones y espacios personalizados establecidos actualmente para este objeto Pen .
Sintaxis
Status GetDashPattern(
[out] REAL *dashArray,
[in] INT count
);
Parámetros
[out] dashArray
Tipo: REAL*
Puntero a una matriz que recibe la longitud de los guiones y los espacios en una línea discontinua personalizada.
[in] count
Tipo: INT
Entero que especifica el número de elementos de la matriz dashArray .
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
Los elementos de la matriz dashArray establecen la longitud de cada guión y espacio en el patrón de guiones. 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 de cada elemento de la matriz y el ancho del objeto Pen .
Ejemplos
En el ejemplo siguiente se crea una matriz de números reales y un objeto Pen , se establece el patrón dash y se dibuja una línea discontinua personalizada. A continuación, el código obtiene el patrón de guiones establecido actualmente para el lápiz.
VOID Example_GetDashPattern(HDC hdc
{
Graphics graphics(hdc);
// Create a custom dashed pen, and use it to draw a line.
REAL dashVals[4] = {5, 2, 15, 4};
Pen pen(Color(255, 0, 0, 0), 5);
pen.SetDashPattern(dashVals, 4);
graphics.DrawLine(&pen, 5, 20, 405, 200);
// Obtain information about the pen.
INT count = 0;
REAL* dashValues = NULL;
count = pen.GetDashPatternCount();
dashValues = new REAL[count];
pen.GetDashPattern(dashValues, count);
for(INT j = 0; j < count; ++j)
{
// Inspect or use the value in dashValues[j].
}
delete [] dashValues;
}
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 (include Gdiplus.h) |
| Library | Gdiplus.lib |
| Archivo DLL | Gdiplus.dll |