< Home

< Programming Guide

< Supported File Formats

REFERENCE MANUAL

Data Structures | Enumerations | Functions
Text Module

Adds text lines in the page. More...

Data Structures

struct  A3DPDFTextData
 A3DPDFTextData structure. More...
 
struct  A3DPDFTextDataEx
 A3DPDFTextDataEx structure. More...
 

Enumerations

enum  A3DPDFEFontName {
  kA3DPDFFontTimesRoman =0, kA3DPDFFontTimesItalic, kA3DPDFFontTimesBold, kA3DPDFFontTimesBoldItalic,
  kA3DPDFFontHelvetica, kA3DPDFFontHelveticaOblique, kA3DPDFFontHelveticaBold, kA3DPDFFontHelveticaBoldOblique,
  kA3DPDFFontCourier, kA3DPDFFontCourierOblique, kA3DPDFFontCourierBold, kA3DPDFFontCourierBoldOblique
}
 Different predefined fonts. More...
 
enum  A3DPDFELanguage {
  kA3DPDFASCII, kA3DPDFEastEuropeanRoman, kA3DPDFCyrillic, kA3DPDFGreek,
  kA3DPDFTurkish, kA3DPDFHebrew, kA3DPDFArabic, kA3DPDFBaltic,
  kA3DPDFChineseTraditional, kA3DPDFChineseSimplified, kA3DPDFJapanese, kA3DPDFKorean
}
 Languages supported for text strings. More...
 

Functions

A3DStatus A3DPDFTextCreate (A3DPDFDocument *pDoc, const A3DPDFTextData *pTextData, A3DPDFText **ppText)
 Function to create a text object. More...
 
A3DStatus A3DPDFTextCreateEx (A3DPDFDocument *pDoc, const A3DPDFTextDataEx *pTextDataEx, A3DPDFText **ppText)
 Function to create a text object with extended fonts and languages. More...
 

Detailed Description

Adds text lines in the page.

This module describes the functions and structures that allow you to add Text lines in the page.

Enumeration Type Documentation

Different predefined fonts.

These fonts are automatically supported by default by Adobe Reader. Nothing specific is required to display these fonts.

Version
4.1
Enumerator
kA3DPDFFontTimesRoman 

Adobe standard Times font, with a normal face.

kA3DPDFFontTimesItalic 

Adobe standard Times font, with a italic face.

kA3DPDFFontTimesBold 

Adobe standard Times font, with a bold face.

kA3DPDFFontTimesBoldItalic 

Adobe standard Times font, with a bold-italic face.

kA3DPDFFontHelvetica 

Adobe standard Helvetica font, with a normal face.

kA3DPDFFontHelveticaOblique 

Adobe standard Helvetica font, with a italic face.

kA3DPDFFontHelveticaBold 

Adobe standard Helvetica font, with a bold face.

kA3DPDFFontHelveticaBoldOblique 

Adobe standard Helvetica font, with a bold-italic face.

kA3DPDFFontCourier 

Adobe standard Courier font, with a normal face.

kA3DPDFFontCourierOblique 

Adobe standard Courier font, with a italic face.

kA3DPDFFontCourierBold 

Adobe standard Courier font, with a bold face.

kA3DPDFFontCourierBoldOblique 

Adobe standard Courier font, with a bold-italic face.

Languages supported for text strings.

Version
5.0
Enumerator
kA3DPDFASCII 

ASCII.

kA3DPDFEastEuropeanRoman 

East European Roman.

kA3DPDFCyrillic 

Cyrillic.

kA3DPDFGreek 

Greek.

kA3DPDFTurkish 

Turkish.

kA3DPDFHebrew 

Hebrew.

kA3DPDFArabic 

Arabic.

kA3DPDFBaltic 

Baltic.

kA3DPDFChineseTraditional 

Traditional Chinese.

kA3DPDFChineseSimplified 

Simplified Chinese.

kA3DPDFJapanese 

Japanese.

kA3DPDFKorean 

Korean.

Function Documentation

A3DStatus A3DPDFTextCreate ( A3DPDFDocument pDoc,
const A3DPDFTextData pTextData,
A3DPDFText **  ppText 
)

Function to create a text object.

The text object is primarily created with this function, and it should be positioned on the page with the function A3DPDFPageInsertText.

Parameters
[in,out]pDocThe Document object to work with.
[in]pTextDataThe text parameters.
[out]ppTextThe Text object created.
Returns
A3D_SUCCESS
Version
4.1
A3DStatus A3DPDFTextCreateEx ( A3DPDFDocument pDoc,
const A3DPDFTextDataEx pTextDataEx,
A3DPDFText **  ppText 
)

Function to create a text object with extended fonts and languages.

The text object is primarily created with this function, and it should be positioned on the page with the function A3DPDFPageInsertText. If the font can't be found in the directory C:\Windows\Fonts, then the function returns an A3DPDF_CANNOT_FIND_FONT (-1000016) error. WARNING: the initialization function A3DPDFInitializePDFLibAndResourceDirectory must be called before using this function.

Parameters
[in]pDocThe Document object to work with.
[in]pTextDataExThe text parameters.
[out]ppTextThe Text object created.
Returns
A3D_SUCCESS
Version
5.0