DrawShapedText

Testo

Descrizione

Questa pagina descrive DrawShapedText in PDFlibPas nell'area "Testo". I nomi di API, parametri, classi, file e valori letterali restano invariati per corrispondere alla libreria Delphi e agli entry point DLL.

Controllare sintassi, parametri e valori restituiti prima di chiamare la funzione.

Sintassi

Delphi

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

Parametri

XPos/YPos posizionano il testo in unità di pagina. FontName indica un tipo di carattere installato (ad esempio Arial). Size è la dimensione del testo in punti. Text è la stringa da formare e disegnare. Il bit 0 di Options seleziona una direzione del paragrafo base da destra a sinistra; impostarlo per il testo arabo o ebraico.

Valori restituiti

Restituisce 1 in caso di successo; 0 quando il motore di formazione non è disponibile, il tipo di carattere non è installato, o Text è vuoto.

Note

Il testo viene formato con il motore di formazione di sistema prima del disegno, quindi le lettere arabe assumono le forme iniziali, mediali, finali o isolate corrette, le legature obbligatorie come lam-alef vengono applicate e le sequenze da destra a sinistra risultano nell'ordine visivo corretto. I glifi formati vengono scritti per indice glifo tramite un font companion di tipo Type0 (Identity-H), il che consente alle forme prive di codice carattere proprio di essere visualizzate correttamente. Un font companion viene creato per ogni tipo di carattere e riutilizzato nelle chiamate successive dello stesso documento. Quando il documento viene salvato, il programma di font incorporato viene sottogruppo ai soli glifi mostrati dal documento, con larghezze reali per glifo e una mappa ToUnicode che traduce ogni glifo formato nei caratteri sorgente corrispondenti — quindi il testo copiato o estratto dall'output restituisce la stringa originale, incluse le legature. Il posizionamento è esatto: ogni avanzamento di glifo del motore di formazione viene scritto nel flusso di contenuto, quindi il layout stampato corrisponde alla misura formata da GetShapedTextWidth.