DrawShapedText

Tekst

Beskrivelse

Denne side beskriver DrawShapedText i PDFlibPas under emnet “Tekst”. API-navne, parametre, klassenavne, filnavne og literaler bevares nøjagtigt som de fremgår af Delphi-biblioteket og DLL-indgangspunkterne.

Gennemgå syntaks, parametre og returværdier, før du kalder funktionen.

Syntaks

Delphi

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

Parametre

XPos/YPos placerer teksten i sideenheder. FontName angiver en installeret skrifttype (f.eks. Arial). Size er tekststørrelsen i punkter. Text er den streng, der skal formes og tegnes. Bit 0 i Options vælger en højre-til-venstre basisafsnitsretning; sæt dette for arabisk eller hebraisk tekst.

Returværdi

Returnerer 1 ved succes; 0 når formgivningsmotoren ikke er tilgængelig, skrifttypen ikke er installeret, eller Text er tom.

Bemærkninger

Teksten formes med systemets formgivningsmotor inden tegning, så arabiske bogstaver antager deres korrekte ord-indledende, mellemste, afsluttende eller isolerede former, obligatoriske ligaturer som lam-alef anvendes, og højre-til-venstre-forløb vises i den korrekte visuelle rækkefølge. De formede glyffer skrives via glyf-indeks gennem et ledsagende Type0 (Identity-H)-skrifttype, hvilket giver former uden eget tegnkode mulighed for at renderes korrekt. Ét ledsagende skrifttype oprettes per skrifttype og genbruges ved efterfølgende kald i samme dokument. Når dokumentet gemmes, indlejres skrifttyperogrammet som et undersæt bestående kun af de glyffer, dokumentet viser, med reelle per-glyf-bredder og et ToUnicode-kort, der oversætter hver formet glyf tilbage til dens kildetegn — så tekst kopieret eller udtrukket fra outputtet returnerer den originale streng, inklusiv ligaturer. Placering er præcis: hvert glyf-fremskridt fra formgivningsmotoren skrives ind i indholdsstrømmen, så det udskrevne layout svarer til den formede måling fra GetShapedTextWidth.