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

Artículo
08/24/2023

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