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 |