procedure CreatePath(X, Y: Single; FillMode: TPdfFillMode = fmNone; FillColor: TColor = clBlack; FillAlpha: Byte = $FF; Stroke: Boolean = True; StrokeColor: TColor = clBlack; StrokeAlpha: Byte = $FF; StrokeWidth: Single = 1.0; LineCap: TPdfLineCap = lcDefault; LineJoin: TPdfLineJoin = ljDefault; BlendMode: TPdfBlendMode = bmDefault);
| FillMode | TPdfFillMode. Regra de preenchimento para o interior do caminho: fmNone (sem preenchimento), fmAlternate (regra par-ímpar) ou fmWinding (regra de enrolamento diferente de zero). O padrão é fmNone. |
| FillColor | TColor. Cor de preenchimento aplicada quando FillMode não é fmNone. O padrão é clBlack. |
| FillAlpha | Byte. Opacidade do preenchimento, onde $00 é totalmente transparente e $FF é totalmente opaco. O padrão é $FF. |
| Stroke | Boolean. Quando True, o contorno do caminho é desenhado usando StrokeColor, StrokeAlpha e StrokeWidth. O padrão é True. |
| StrokeColor | TColor. Cor do contorno do caminho. O padrão é clBlack. |
| StrokeAlpha | Byte. Opacidade do traço, onde $00 é totalmente transparente e $FF é totalmente opaco. O padrão é $FF. |
| StrokeWidth | Single. Largura da linha de traço em unidades de usuário de PDF (pontos). O padrão é 1.0. |
| LineCap | TPdfLineCap. Estilo aplicado às extremidades abertas do caminho: lcDefault, lcButt, lcRound ou lcProjectingSquare. O padrão é lcDefault. |
| LineJoin | TPdfLineJoin. Estilo aplicado às junções de segmentos do caminho: ljDefault, ljMiter, ljRound ou ljBevel. O padrão é ljDefault. |
| BlendMode | TPdfBlendMode. Modo de mesclagem de composição para o objeto de caminho. O padrão é bmDefault, que compõe como bmNormal. |
procedure CreatePath(X, Y, Width, Height: Single; FillMode: TPdfFillMode = fmNone; FillColor: TColor = clBlack; FillAlpha: Byte = $FF; Stroke: Boolean = True; StrokeColor: TColor = clBlack; StrokeAlpha: Byte = $FF; StrokeWidth: Single = 1.0; LineCap: TPdfLineCap = lcDefault; LineJoin: TPdfLineJoin = ljDefault; BlendMode: TPdfBlendMode = bmDefault);
| FillMode | TPdfFillMode. Regra de preenchimento para o interior do retângulo. O padrão é fmNone. |
| FillColor | TColor. Cor de preenchimento do retângulo. O padrão é clBlack. |
| FillAlpha | Byte. Opacidade do preenchimento ($00–$FF). O padrão é $FF. |
| Stroke | Boolean. Quando True, o contorno do retângulo é desenhado. O padrão é True. |
| StrokeColor | TColor. Cor do contorno do retângulo. O padrão é clBlack. |
| StrokeAlpha | Byte. Opacidade do traço ($00–$FF). O padrão é $FF. |
| StrokeWidth | Single. Largura do traço do contorno em pontos. O padrão é 1.0. |
| LineCap | TPdfLineCap. Estilo de terminação de linha para os cantos do retângulo. O padrão é lcDefault. |
| LineJoin | TPdfLineJoin. Estilo de junção de linha para os cantos do retângulo. O padrão é ljDefault. |
| BlendMode | TPdfBlendMode. Modo de mesclagem de composição. O padrão é bmDefault. |
CreatePath inicia a construção de um novo objeto de caminho vetorial. Deve ser chamado antes de qualquer um dos métodos de construção de caminho (MoveTo, LineTo, BezierTo, ClosePath), e a sequência deve ser concluída com uma chamada a AddPath para confirmar o caminho na página atual.
Duas sobrecargas estão disponíveis. A forma com duas coordenadas CreatePath(X, Y, ...) inicializa um caminho vazio com seu ponto atual em (X, Y); você então constrói a forma livremente usando os métodos de segmento de caminho. A forma com quatro coordenadas CreatePath(X, Y, Width, Height, ...) cria diretamente um caminho retangular fechado — nenhuma chamada adicional de segmento é necessária antes de AddPath.
Todas as propriedades visuais do caminho — cor e regra de preenchimento, cor do traço, largura, opacidade, terminação de linha, junção de linha e modo de mesclagem — são definidas no momento da criação por meio dos parâmetros opcionais. Os valores padrão produzem um contorno preto traçado de 1 ponto sem preenchimento.
Somente um caminho pode estar em construção por vez. Chamar CreatePath novamente antes de AddPath descarta o caminho pendente anterior.
// Draw a filled blue triangle with a 2-pt black outline
Pdf1.NewPage(595, 842);
Pdf1.CreatePath(100, 100, fmWinding, clBlue, $FF, True, clBlack, $FF, 2.0);
Pdf1.LineTo(200, 300);
Pdf1.LineTo(300, 100);
Pdf1.ClosePath;
Pdf1.AddPath;
// Draw a red filled rectangle using the 4-coordinate overload
Pdf1.CreatePath(50, 400, 200, 80, fmWinding, clRed);
Pdf1.AddPath;