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

O método Pen::GetCompoundArray obtém a matriz composta definida atualmente para este objeto Pen .

Sintaxe

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

Parâmetros

[out] compoundArray

Tipo: REAL*

Ponteiro para uma matriz que recebe a matriz composta.

[in] count

Tipo: INT

Inteiro que especifica o número de elementos na matriz compoundArray .

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Suponha que uma matriz composta contenha os valores 0,0, 0,2, 0,7 e 1,0 e que a caneta tenha uma largura de 100. Ao usar a caneta para desenhar, você obtém duas linhas paralelas. A primeira linha tem uma largura de 20, o espaço entre as duas linhas tem uma largura de 50 e a segunda linha tem uma largura de 30.

Para um exemplo mais complexo, suponha que uma matriz composta contenha os valores 0,0, 0,2, 0,3, 0,6, 0,85 e 1,0 e que a caneta tenha uma largura de 100. Ao usar a caneta para desenhar, você obtém três linhas paralelas. As larguras das três linhas são 20, 30 e 15, respectivamente. As larguras dos dois espaços entre as linhas são 10 e 25, respectivamente.

Exemplos

O exemplo a seguir obtém a matriz composta para um objeto Pen . Supondo que uma matriz composta tenha sido definida para esse objeto Pen , o código obtém as entradas que foram definidas para esta caneta.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdipluspen.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll

Confira também

Caneta

Pen::SetCompoundArray

Canetas, linhas e retângulos