DrawShapedText

Text

Descrição

Esta página descreve DrawShapedText no PDFlibPas no âmbito do tópico "Text". Os nomes de API, parâmetros, nomes de classe, nomes de ficheiros e literais são mantidos exactamente como aparecem na biblioteca Delphi e nos pontos de entrada DLL.

Reveja a sintaxe, os parâmetros e os valores de retorno antes de invocar a função.

Sintaxe

Delphi

Function TPDFlib.DrawShapedText(XPos, YPos: Double; Const FontName: WideString; Size: Double; Const Text: WideString; Options: Integer): Integer;

Parâmetros

XPos/YPos posicionam o texto em unidades de página. FontName nomeia um tipo de letra instalado (por exemplo, Arial). Size é o tamanho do texto em pontos. Text é a cadeia de caracteres a moldar e desenhar. O bit 0 de Options selecciona uma direcção de parágrafo base da direita para a esquerda; defina-o para texto árabe ou hebraico.

Valores de Retorno

Devolve 1 em caso de sucesso; 0 quando o motor de modelação não está disponível, o tipo de letra não está instalado ou Text está vazio.

Observações

O texto é moldado pelo motor de modelação do sistema antes de ser desenhado, de modo a que as letras árabes assumam as suas formas correctas inicial, medial, final ou isolada; as ligaduras obrigatórias, como lam-alef, são aplicadas e as sequências da direita para a esquerda são apresentadas na ordem visual correcta. Os glifos moldados são escritos por índice de glifo através de um tipo de letra Type0 (Identity-H) complementar, o que permite que as formas sem código de carácter próprio sejam renderizadas correctamente. É criado um tipo de letra complementar por tipo de letra e reutilizado em chamadas subsequentes no mesmo documento. Quando o documento é guardado, o programa de tipo de letra incorporado é subdividido para incluir apenas os glifos apresentados no documento, com larguras reais por glifo e um mapa ToUnicode que traduz cada glifo moldado de volta aos seus caracteres de origem — de modo a que o texto copiado ou extraído do resultado devolva a cadeia de caracteres original, incluindo ligaduras. O posicionamento é exacto: cada avanço de glifo do motor de modelação é escrito no fluxo de conteúdo, de modo a que o esquema impresso corresponda à medição moldada de GetShapedTextWidth.