Método Pen::SetCompoundArray (gdipluspen.h)
El método Pen::SetCompoundArray establece la matriz compuesta para este objeto Pen .
Sintaxis
Status SetCompoundArray(
[in] const REAL *compoundArray,
[in] INT count
);
Parámetros
[in] compoundArray
Tipo: const REAL*
Puntero a una matriz de números reales que especifica la matriz compuesta. Los elementos de la matriz deben estar en orden ascendente, no menor que cero y no mayor que 1.
[in] count
Tipo: INT
Entero par positivo que especifica el número de elementos de la matriz compoundArray . El entero no debe ser mayor que el número de elementos de la matriz compuesta.
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
Supongamos que desea que un lápiz dibuje dos líneas paralelas donde el ancho de la primera línea sea el 20 por ciento del ancho del lápiz, el ancho del espacio que separa las dos líneas es el 50 por ciento del ancho del lápiz y el ancho de la segunda línea es el 30 por ciento del ancho del lápiz. Empiece por crear un objeto Pen y una matriz de números reales. A continuación, puede establecer la matriz compuesta pasando la matriz con los valores 0.0, 0.2, 0.7 y 1.0 al método Pen::SetCompoundArray del objeto Pen .
Si establece la alineación de un objeto Pen en PenAlignmentInset, no puede usar ese lápiz para dibujar líneas compuestas.
Ejemplos
En el ejemplo siguiente se crea un objeto Pen y se establece la matriz compuesta para el lápiz. A continuación, el código dibuja una línea mediante el objeto Pen .
VOID Example_SetCompoundArray(HDC hdc)
{
Graphics graphics(hdc);
// Create an array of real numbers and a Pen object.
REAL compVals[6] = {0.0f, 0.2f, 0.5f, 0.7f, 0.9f, 1.0f};
Pen pen(Color(255, 0, 0, 255), 30);
// Set the compound array of the pen.
pen.SetCompoundArray(compVals, 6);
// Draw a line with the pen.
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 (include Gdiplus.h) |
| Library | Gdiplus.lib |
| Archivo DLL | Gdiplus.dll |