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

El método Pen::GetCompoundArray obtiene la matriz compuesta establecida actualmente para este objeto Pen .

Sintaxis

Status GetCompoundArray(
  [out] REAL *compoundArray,
  [in]  INT  count
);

Parámetros

[out] compoundArray

Tipo: REAL*

Puntero a una matriz que recibe la matriz compuesta.

[in] count

Tipo: INT

Entero que especifica el número de elementos de la matriz compoundArray .

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 una matriz compuesta contiene los valores 0.0, 0.2, 0.7 y 1.0 y que el lápiz tiene un ancho de 100. Al usar el lápiz para dibujar, obtendrá dos líneas paralelas. La primera línea tiene un ancho de 20, el espacio entre las dos líneas tiene un ancho de 50 y la segunda línea tiene un ancho de 30.

Para un ejemplo más complejo, supongamos que una matriz compuesta contiene los valores 0.0, 0.2, 0.3, 0.6, 0.85 y 1.0 y que el lápiz tiene un ancho de 100. Cuando use el lápiz para dibujar, obtendrá tres líneas paralelas. Los anchos de las tres líneas son 20, 30 y 15 respectivamente. Los anchos de los dos espacios entre las líneas son 10 y 25 respectivamente.

Ejemplos

En el ejemplo siguiente se obtiene la matriz compuesta de un objeto Pen . Suponiendo que se ha establecido una matriz compuesta para este objeto Pen , el código obtiene las entradas que se han establecido para este lápiz.

INT count = pen.GetCompoundCount();
REAL * distances = new REAL[count];
Status stat = pen.GetCompoundArray(distances, count);

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 (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll

Consulte también

Lápiz

Pen::SetCompoundArray

Lápices, líneas y rectángulos