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

Artigo
08/24/2023

O método Pen::GetDashPattern obtém uma matriz de traços personalizados e espaços atualmente definidos para este objeto Pen .

Sintaxe

Status GetDashPattern(
  [out] REAL *dashArray,
  [in]  INT  count
);

Parâmetros

[out] dashArray

Tipo: REAL*

Ponteiro para uma matriz que recebe o comprimento dos traços e espaços em uma linha tracejada personalizada.

[in] count

Tipo: INT

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

Valor retornado

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

Os elementos na matriz dashArray definem o comprimento de cada traço e espaço no padrão de traço. O primeiro elemento define o comprimento de um traço, o segundo elemento define o comprimento de um espaço, o terceiro elemento define o comprimento de um traço e assim por diante.

O comprimento de cada traço e espaço no padrão de traço é o produto de cada elemento na matriz e a largura do objeto Pen .

Exemplos

O exemplo a seguir cria uma matriz de números reais e um objeto Pen , define o padrão de traço e desenha uma linha tracejada personalizada. Em seguida, o código obtém o padrão de traço definido atualmente para a caneta.

VOID Example_GetDashPattern(HDC hdc
{
   Graphics graphics(hdc);

   // Create a custom dashed pen, and use it to draw a line.
   REAL dashVals[4] = {5, 2, 15, 4};
   Pen pen(Color(255, 0, 0, 0), 5);
   pen.SetDashPattern(dashVals, 4);
   graphics.DrawLine(&pen, 5, 20, 405, 200);

   // Obtain information about the pen.
   INT count = 0;
   REAL* dashValues = NULL;

   count = pen.GetDashPatternCount();
   dashValues = new REAL[count];
   pen.GetDashPattern(dashValues, count);

   for(INT j = 0; j < count; ++j)
   {
      // Inspect or use the value in dashValues[j].
   }
   delete [] dashValues;
}

Requisitos


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