< Home

< Programming Guide

< Supported File Formats

REFERENCE MANUAL

Data Fields
A3DPDFCheckBoxData Struct Reference

Structure to define a check box field. More...

Data Fields

A3DUns16 m_usStructSize
 
A3DUTF8Charm_pcName
 
A3DUTF8Charm_pcTooltip
 
A3DPDFEFormField m_eFormField
 
A3DPDFETextOrientation m_eTextOrientation
 
A3DBool m_bIsReadOnly
 
A3DBool m_bIsRequired
 
A3DBool m_bIsLocked
 
A3DBool m_bHasBorder
 
A3DPDFRgbColorData m_sBorderColor
 
A3DPDFEThicknessBorder m_eThicknessBorder
 
A3DPDFELineStyleBorder m_eLineStyleBorder
 
A3DBool m_bHasFillColor
 
A3DPDFRgbColorData m_sFillColor
 
A3DPDFRgbColorData m_sTextColor
 
A3DUTF8Charm_pcFontName
 
A3DInt32 m_iFontSize
 
A3DUTF8Charm_pcExportValue
 
A3DBool m_bIsCheckedByDefault
 

Detailed Description

Structure to define a check box field.

Version
8.0

Field Documentation

A3DUns16 A3DPDFCheckBoxData::m_usStructSize

Reserved; must be initialized by A3D_INITIALIZE_DATA.

A3DUTF8Char* A3DPDFCheckBoxData::m_pcName

Name of the field (it serves as the field identifier, it should be unique in the document).

A3DUTF8Char* A3DPDFCheckBoxData::m_pcTooltip

Displayed text that the hesitant user may find helpful in filling in the form field. Tooltips appear when the pointer hovers briefly over the form field.

A3DPDFEFormField A3DPDFCheckBoxData::m_eFormField

Specifies whether the form field can be seen, either on screen or in print.

A3DPDFETextOrientation A3DPDFCheckBoxData::m_eTextOrientation

Orientation of the text inside the field.

A3DBool A3DPDFCheckBoxData::m_bIsReadOnly

Defines if the field is editable.

A3DBool A3DPDFCheckBoxData::m_bIsRequired

Defines if the field is required.

A3DBool A3DPDFCheckBoxData::m_bIsLocked

If locked, prevents any further changes to any form field properties (in Acrobat 'Properties' dialog box).

A3DBool A3DPDFCheckBoxData::m_bHasBorder

If true, there is a border around the field.

A3DPDFRgbColorData A3DPDFCheckBoxData::m_sBorderColor

Color of the border of the field (if any).

A3DPDFEThicknessBorder A3DPDFCheckBoxData::m_eThicknessBorder

Thickness of the border.

A3DPDFELineStyleBorder A3DPDFCheckBoxData::m_eLineStyleBorder

Line style of the border.

A3DBool A3DPDFCheckBoxData::m_bHasFillColor

If true, the following field (m_sFillColor) is used.

A3DPDFRgbColorData A3DPDFCheckBoxData::m_sFillColor

Color which the inside of the field will be filled with (if m_bHasFillColor is true).

A3DPDFRgbColorData A3DPDFCheckBoxData::m_sTextColor

Color of the text.

A3DUTF8Char* A3DPDFCheckBoxData::m_pcFontName

Font name of the text. It should be the name of the font as appearing in Acrobat font list, but without spaces, and with style separated with a comma. For example, 'Calibri Bold Italic' should be specified as "Calibri,BoldItalic" ; or 'Century Gothic' should be specified as "CenturyGothic". Also, specific values exist for Adobe default fonts: eTimesRoman is "TiRo" ; eTimesItalic is "TiIt" ; eTimesBold is "TiBo" ; eTimesBoldItalic is "TiBI" ; eHelvetica is "Helv" ; eHelveticaOblique is "HeOb" ; eHelveticaBold is "HeBo" ; eHelveticaBoldOblique is "HeBO" ; eCourier is "Cour" ; eCourierOblique is "CoOb" ; eCourierBold is "CoBo" ; eCourierBoldOblique is "CoBO".

A3DInt32 A3DPDFCheckBoxData::m_iFontSize

Size of the font.

A3DUTF8Char* A3DPDFCheckBoxData::m_pcExportValue

Value used when field data is exported by Acrobat functions.

A3DBool A3DPDFCheckBoxData::m_bIsCheckedByDefault

If true, this check box is selected when the PDF document is opened.