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

Artigo
08/24/2023

O método Pen::SetDashPattern define uma matriz de traços e espaços personalizados para esse objeto Pen .

Sintaxe

Status SetDashPattern(
  [in] const REAL *dashArray,
  [in] INT        count
);

Parâmetros

[in] dashArray

Tipo: const REAL*

Ponteiro para uma matriz de números reais que especifica o comprimento dos traços e espaços personalizados. Todos os elementos na matriz devem ser números reais positivos.

[in] count

Tipo: INT

Inteiro que especifica o número de elementos na matriz dashArray . O inteiro deve ser maior que 0 e não maior que o número total de elementos na matriz.

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

Esse método definirá a enumeração DashStyle para este objeto Pen como DashStyleCustom.

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 do valor do elemento na matriz e a largura do objeto Pen .

Exemplos

O exemplo a seguir cria uma matriz de números reais. Em seguida, o código cria um objeto Pen , define o padrão de traço com base na matriz e desenha a linha tracejada personalizada.

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

   // Create and set an array of real numbers.
   REAL dashVals[4] = {
      5.0f,   // dash length 5
      2.0f,   // space length 2
      15.0f,  // dash length 15
      4.0f};  // space length 4

   // Create a Pen object.
   Pen pen(Color(255, 0, 0, 0), 5);

   // Set the dash pattern for the custom dashed line.
   pen.SetDashPattern(dashVals, 4);

   // Draw the custom dashed line.
   graphics.DrawLine(&pen, 5, 20, 405, 200); 
}

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