Document functions. More...
Data Structures | |
struct | A3DPDFDocumentInformationData |
A3DPDFDocumentInformationData structure. More... | |
struct | A3DPDFButtonData |
Structure to define a button field. More... | |
struct | A3DPDFTextFieldData |
Structure to define a text field. More... | |
struct | A3DPDFCheckBoxData |
Structure to define a check box field. More... | |
struct | A3DPDFRadioButtonData |
Structure to define a radio button field. More... | |
struct | A3DPDFListBoxData |
Structure to define a list box field. More... | |
struct | A3DPDFDropDownListData |
Structure to define a drop down list field (combo box) More... | |
struct | A3DPDFDigitalSignatureData |
Structure to define a digital signature field. More... | |
Modules | |
Bit Field to indicate the document permissions. | |
Functions | |
A3DStatus | A3DPDFDocumentCreateEmpty (A3DPDFDocument **ppDoc) |
Function to create an empty PDF document. More... | |
A3DStatus | A3DPDFDocumentCreateFromPDFFile (const A3DUTF8Char *pcFileName, A3DPDFDocument **ppDoc) |
Function to create a document from a PDF file. More... | |
A3DStatus | A3DPDFDocumentCreateUniquePage (A3DPDFDocument *pDoc, const A3DPDFPageData *pPageData, A3DPDFPage **ppPage) |
This method was deprecated in HOOPS Publish 1.10. Use A3DPDFDocumentAppendNewPage instead. More... | |
A3DStatus | A3DPDFDocumentCreateUniquePage2 (A3DPDFDocument *pDoc, const A3DPDFPageData2 *pPageData, A3DPDFPage **ppPage) |
This function adds a unique page to an empty PDF document. This function can only be used on a file opened with A3DPDFDocumentCreateEmpty. It can't be used on a file which already contains a page. More... | |
A3DStatus | A3DPDFDocumentGetUniquePage (const A3DPDFDocument *pDoc, A3DPDFPage **ppPage) |
Function to get the unique page of the document. More... | |
A3DStatus | A3DPDFDocumentGetNumberPages (const A3DPDFDocument *pDoc, A3DInt32 *piNbPages) |
Function to get the number of pages in the document. More... | |
A3DStatus | A3DPDFDocumentGetPage (const A3DPDFDocument *pDoc, const A3DInt32 iNumPage, A3DPDFPage **ppPage) |
Function to get a page in the document. More... | |
A3DStatus | A3DPDFDocumentRemovePages (const A3DPDFDocument *pDoc, const A3DInt32 iFirstPage, const A3DInt32 iLastPage) |
Function to remove pages in the document. More... | |
A3DStatus | A3DPDFDocumentAppendNewPage (A3DPDFDocument *pDoc, const A3DPDFPageData *pPageData, A3DPDFPage **ppPage) |
Appends a new empty page to a document. More... | |
A3DStatus | A3DPDFDocumentAppendNewPage2 (A3DPDFDocument *pDoc, const A3DPDFPageData2 *pPageData, A3DPDFPage **ppPage) |
Appends a new empty page to a document. More... | |
A3DStatus | A3DPDFDocumentAppendPageFromPDFFile (A3DPDFDocument *pDoc, const A3DUTF8Char *pcFileName, A3DPDFPage **ppPage) |
Superseded by A3DPDFDocumentAppendPageFromPDFFileEx in A3DLIBS 4.3 and later. More... | |
A3DStatus | A3DPDFDocumentAppendPageFromPDFFileEx (A3DPDFDocument *pDoc, const A3DUTF8Char *pcFileName, const A3DBool bRenameFields, A3DPDFPage **ppPage) |
A3DStatus | A3DPDFDocumentSetInformation (A3DPDFDocument *pDoc, const A3DPDFDocumentInformationData *pInformationData) |
Function to set information on the document. These information are visible in the Adobe Reader on the File Properties menu. More... | |
A3DStatus | A3DPDFDocumentSetPassword (A3DPDFDocument *pDoc, const A3DUTF8Char *pcUserPassword, const A3DUTF8Char *pcOwnerPassword) |
Function to add user and owner passwords on a document. More... | |
A3DStatus | A3DPDFDocumentSetDocumentPermissions (A3DPDFDocument *pDoc, int iPermissions) |
Function to set permissions on a document. More... | |
A3DStatus | A3DPDFDocumentAddImageAsIcon (A3DPDFDocument *pDoc, const A3DPDFImage *pImage, const A3DUTF8Char *pcIconName) |
Function to store an image in the PDF file in a way it can be used as an icon for PDF fields. More... | |
A3DStatus | A3DPDFDocumentAddFileAttachment (A3DPDFDocument *pDoc, const A3DUTF8Char *pcFileName, const A3DUTF8Char *pcDescription) |
Function to attach a file to the document. Attachments are visible on the Adobe Reader with the specific navigation pane. In Adobe Reader X version, the Attachments pane can be activated with the menu View / Show/Hide / Navigation Panes / Attachments. More... | |
A3DStatus | A3DPDFDocumentAddJavascriptFromString (A3DPDFDocument *pDoc, const A3DUTF8Char *pcScriptName, const A3DUTF8Char *pcJavascriptString) |
Adds a JavaScript to a document. This JavaScript is launched when the file is opened. More... | |
A3DStatus | A3DPDFDocumentClose (A3DPDFDocument *pDoc) |
Function to close the document and free all memory. More... | |
A3DStatus | A3DPDFDefineViewCarousel (A3DPDFDocument *pDoc, A3DPDFPage *pPage, A3DPDF3DAnnot *pAnnot, A3DAsmModelFile *pModelFile, A3DInt32 iNumberOfButtons, A3DUTF8Char **ppButtonsNames, A3DUTF8Char *pPreviousButtonName, A3DUTF8Char *pNextButtonName, A3DInt32 iNumberOfViews, A3DPDFView **ppViews, A3DPDFImage **ppImages, A3DInt32 iScrollStep) |
Function to create a 'standard' view carousel and position it in the PDF document. The PDF document must contain the buttons for the views and the buttons to go to the next and the previous view. More... | |
A3DStatus | A3DPDFDefineSlideTable (A3DPDFDocument *pDoc, A3DPDFPage *pPage, const A3DInt32 iPosLeft, const A3DInt32 iPosTop, A3DUTF8Char *pcHtmlFrameTable, A3DUTF8Char *pcHtmlFrameStyle, A3DUTF8Char *pPreviousButtonName, A3DUTF8Char *pNextButtonName, A3DInt32 iNbTextRows, A3DInt32 iNbTextCols, A3DPDFTextField ***ppTexts, A3DBool bHasHeader) |
Function to create a slide table. This is a table with a fixed size, and two buttons to scroll the rows of the table. The frame of the table is specified through html definition and printed as-is on the page. Then the text data is populated dynamically from an array of texts specified. The table MUST be of simple shape, with the same number of rows for each columns. Optionally, a header can figure in the table data at first row. The text data defines the text content, as well as text format attributes (font, font size, and text color). All rows must have the same text attributes, so that only the first row of text data is used internally to get the text format. More... | |
A3DStatus | A3DPDFDefineSlideTable2 (A3DPDFDocument *pDoc, A3DPDFPage *pPage, const A3DInt32 iPosLeft, const A3DInt32 iPosTop, A3DUTF8Char *pcHtmlFrameTable, A3DUTF8Char *pcHtmlFrameStyle, A3DInt32 iSliderWidth, A3DInt32 iNbTextRows, A3DInt32 iNbTextCols, A3DPDFTextField ***ppTexts, A3DBool bHasHeader, A3DUTF8Char **ppcSTName) |
Function to create a slide table. This is a table with a fixed size, and a scroll bar to scroll the rows of the table. This function differs from A3DPDFDefineSlideTable in that it uses a scroll bar to scroll the rows instead of previous and next buttons. The frame of the table is specified through html definition and printed as-is on the page. Then the text data is populated dynamically from an array of texts specified. The table MUST be of simple shape, with the same number of rows for each columns. Optionally, a header can figure in the table data at first row. The text data defines the text content, as well as text format attributes (font, font size, and text color). All rows must have the same text attributes, so that only the first row of text data is used internally to get the text format. More... | |
A3DStatus | A3DPDFDocumentSave (A3DPDFDocument *pDoc, const A3DUTF8Char *pcFileName) |
Function to save the PDF document. More... | |
Document functions.
This module describes the functions and structures that allow you to define a PDF Document.
A3DStatus A3DPDFDocumentCreateEmpty | ( | A3DPDFDocument ** | ppDoc | ) |
Function to create an empty PDF document.
This function creates a document with no page. Subsequently, some pages must be added with the append functions A3DPDFDocumentAppendNewPage or A3DPDFDocumentAppendPageFromPDFFile.
[out] | ppDoc | The document created. |
A3DStatus A3DPDFDocumentCreateFromPDFFile | ( | const A3DUTF8Char * | pcFileName, |
A3DPDFDocument ** | ppDoc | ||
) |
Function to create a document from a PDF file.
This function creates a document from a PDF input file. Starting with HOOPS Publish 6.0 the input PDF can contain several pages. Pages can be added to the document with append functions A3DPDFDocumentAppendNewPage or A3DPDFDocumentAppendPageFromPDFFileEx.
[in] | pcFileName | The input file name. |
[out] | ppDoc | The document created. |
A3DStatus A3DPDFDocumentCreateUniquePage | ( | A3DPDFDocument * | pDoc, |
const A3DPDFPageData * | pPageData, | ||
A3DPDFPage ** | ppPage | ||
) |
This method was deprecated in HOOPS Publish 1.10. Use A3DPDFDocumentAppendNewPage instead.
This function adds a unique page to an empty PDF document. This function can only be used on a file opened with A3DPDFDocumentCreateEmpty. It can't be used on a file which already contains a page.
[in,out] | pDoc | The current document on which the new page will be added. |
[in] | pPageData | The page data parameters. |
[out] | ppPage | The newly-created page. |
A3DStatus A3DPDFDocumentCreateUniquePage2 | ( | A3DPDFDocument * | pDoc, |
const A3DPDFPageData2 * | pPageData, | ||
A3DPDFPage ** | ppPage | ||
) |
This function adds a unique page to an empty PDF document. This function can only be used on a file opened with A3DPDFDocumentCreateEmpty. It can't be used on a file which already contains a page.
[in,out] | pDoc | The current document on which the new page will be added. |
[in] | pPageData | The page data parameters. |
[out] | ppPage | The newly-created page. |
A3DStatus A3DPDFDocumentGetUniquePage | ( | const A3DPDFDocument * | pDoc, |
A3DPDFPage ** | ppPage | ||
) |
Function to get the unique page of the document.
This method was deprecated in HOOPS Publish 6.0. Use A3DPDFDocumentGetPage instead.
This function only works on a document which contains a single page. It is designed to be called after A3DPDFDocumentCreateFromPDFFile to get the Page object.
[in] | pDoc | The Document object to work with. |
[out] | ppPage | The Page object. |
A3DStatus A3DPDFDocumentGetNumberPages | ( | const A3DPDFDocument * | pDoc, |
A3DInt32 * | piNbPages | ||
) |
Function to get the number of pages in the document.
[in] | pDoc | The Document object to work with. |
[out] | piNbPages | The number of pages. Remember to subtract 1 from this value if you are going to pass it to a method that takes a zero-based page number. |
A3DStatus A3DPDFDocumentGetPage | ( | const A3DPDFDocument * | pDoc, |
const A3DInt32 | iNumPage, | ||
A3DPDFPage ** | ppPage | ||
) |
Function to get a page in the document.
[in] | pDoc | The Document object to work with. |
[in] | iNumPage | The index of the page. The first page is 0. |
[out] | ppPage | The Page object. |
A3DStatus A3DPDFDocumentRemovePages | ( | const A3DPDFDocument * | pDoc, |
const A3DInt32 | iFirstPage, | ||
const A3DInt32 | iLastPage | ||
) |
Function to remove pages in the document.
[in,out] | pDoc | The Document object to work with. |
[in] | iFirstPage | The index of the first page to remove. The first page is 0. |
[in] | iLastPage | The index of the last page to remove. |
A3DStatus A3DPDFDocumentAppendNewPage | ( | A3DPDFDocument * | pDoc, |
const A3DPDFPageData * | pPageData, | ||
A3DPDFPage ** | ppPage | ||
) |
Appends a new empty page to a document.
The page is added at the end of the document. It is a new page created with the options set in the pPageData argument.
[in,out] | pDoc | The Document object to work with. |
[in] | pPageData | The page parameters. |
[out] | ppPage | The Page object for the new page. |
A3DStatus A3DPDFDocumentAppendNewPage2 | ( | A3DPDFDocument * | pDoc, |
const A3DPDFPageData2 * | pPageData, | ||
A3DPDFPage ** | ppPage | ||
) |
Appends a new empty page to a document.
The page is added at the end of the document. It is a new page created with the options set in the pPageData argument.
[in,out] | pDoc | The Document object to work with. |
[in] | pPageData | The page parameters. |
[out] | ppPage | The Page object for the new page. |
A3DStatus A3DPDFDocumentAppendPageFromPDFFile | ( | A3DPDFDocument * | pDoc, |
const A3DUTF8Char * | pcFileName, | ||
A3DPDFPage ** | ppPage | ||
) |
Superseded by A3DPDFDocumentAppendPageFromPDFFileEx in A3DLIBS 4.3 and later.
Appends new pages from a PDF template to a document. Starting with HOOPS Publish 6.0 the input PDF can contain several pages. The pages are added at the end of the document. All pages are copied from the PDF template file specified with the pcFileName argument. If the imported pages contain form fields with names that already exist on other pages of the document, the function will fail. In this situation, use A3DPDFDocumentAppendPageFromPDFFileEx to rename all form fields of the imported pages.
[in,out] | pDoc | The Document object to work with. |
[in] | pcFileName | The input file name of the PDF template. |
[out] | ppPage | The Page object for the last page inserted. |
A3DStatus A3DPDFDocumentAppendPageFromPDFFileEx | ( | A3DPDFDocument * | pDoc, |
const A3DUTF8Char * | pcFileName, | ||
const A3DBool | bRenameFields, | ||
A3DPDFPage ** | ppPage | ||
) |
Appends new pages from a PDF template to a document, with the possibility to rename all form fields to avoid PDF conflicts. This method supersedes A3DPDFDocumentAppendPageFromPDFFile() in A3DLIBS 4.3 and later. Starting from HOOPS Publish 6.0 the input PDF can contain several pages. The pages are added at the end of the document. All pages are copied from the PDF template file specified with the pcFileName argument. If the imported pages contain form fields with names that already exist on other pages of the document, the function will fail. In this situation, set the bRenameFields parameter to true to rename all form fields of the imported pages. Warning: all references to the renamed form fields have to be modified to reflect the new names. This has to be done for example for JavaScript code that could work with these fields.
[in,out] | pDoc | The Document object to work with. |
[in] | pcFileName | The input file name of the PDF template. |
[in] | bRenameFields | If true, the form fields of the template pages are renamed, appending the position of the pages in the final document to every fields. Note that the index of the first page is 1. For example, a field 'MyTitle' will be renamed 'MyTitle_1" if the page is inserted as the first page of the document. If false, the form fields are not renamed and the function will fail if some fields already exist on the document with the same name. |
[out] | ppPage | The Page object for the last page inserted. |
A3DStatus A3DPDFDocumentSetInformation | ( | A3DPDFDocument * | pDoc, |
const A3DPDFDocumentInformationData * | pInformationData | ||
) |
Function to set information on the document. These information are visible in the Adobe Reader on the File Properties menu.
[in,out] | pDoc | The Document object to work with. |
[in] | pInformationData | The information parameters. |
A3DStatus A3DPDFDocumentSetPassword | ( | A3DPDFDocument * | pDoc, |
const A3DUTF8Char * | pcUserPassword, | ||
const A3DUTF8Char * | pcOwnerPassword | ||
) |
Function to add user and owner passwords on a document.
These passwords are natively supported by Adobe Reader. If a user password is specified, Adobe Reader will ask for a password when opening the document. The owner password is the password used to set document restrictions on the document. It does not restrict the opening of a PDF file, only what can be done once opened. Document restrictions can include printing, changing the document, document assembly, content copying, content copying for accessibility, page extraction, commenting, filling of form fields, signing, and creation of template pages.
[in,out] | pDoc | The Document object to work with. |
[in] | pcUserPassword | The password to protect the document at opening. Also protects against document modification and printing. If an empty string is specified, no user password is required by Adobe Reader or Acrobat. |
[in] | pcOwnerPassword | Lets you require a password when changing the security features of the PDF, not when opening it. If an empty string is specified, no password will be required in Acrobat to change security settings. |
A3DStatus A3DPDFDocumentSetDocumentPermissions | ( | A3DPDFDocument * | pDoc, |
int | iPermissions | ||
) |
Function to set permissions on a document.
[in,out] | pDoc | The Document object to work with. |
[in] | iPermissions | The permissions, composed of bit fields detailed in Bit Field to indicate the document permissions.. |
A3DStatus A3DPDFDocumentAddImageAsIcon | ( | A3DPDFDocument * | pDoc, |
const A3DPDFImage * | pImage, | ||
const A3DUTF8Char * | pcIconName | ||
) |
Function to store an image in the PDF file in a way it can be used as an icon for PDF fields.
var but = this.getField("buttonfieldtopopulate");
var icon = this.getIcon("myicon");
but.buttonSetIcon(icon);
[in,out] | pDoc | The Document object to work with. |
[in] | pcIconName | The icon name that will be used to identify the image. |
[in] | pImage | The image. |
A3DStatus A3DPDFDocumentAddFileAttachment | ( | A3DPDFDocument * | pDoc, |
const A3DUTF8Char * | pcFileName, | ||
const A3DUTF8Char * | pcDescription | ||
) |
Function to attach a file to the document. Attachments are visible on the Adobe Reader with the specific navigation pane. In Adobe Reader X version, the Attachments pane can be activated with the menu View / Show/Hide / Navigation Panes / Attachments.
[in,out] | pDoc | The Document object to work with. |
[in] | pcFileName | The name of the file to attach. |
[in] | pcDescription | The description of the attached file. |
A3DStatus A3DPDFDocumentAddJavascriptFromString | ( | A3DPDFDocument * | pDoc, |
const A3DUTF8Char * | pcScriptName, | ||
const A3DUTF8Char * | pcJavascriptString | ||
) |
Adds a JavaScript to a document. This JavaScript is launched when the file is opened.
[in,out] | pDoc | The Document object to work with. |
[in] | pcScriptName | The name of the script. It is not used by Acrobat but needs to be unique. |
[in] | pcJavascriptString | The string which contains the JavaScript. |
A3DStatus A3DPDFDocumentClose | ( | A3DPDFDocument * | pDoc | ) |
Function to close the document and free all memory.
[in,out] | pDoc | The Document object to work with. |
A3DStatus A3DPDFDefineViewCarousel | ( | A3DPDFDocument * | pDoc, |
A3DPDFPage * | pPage, | ||
A3DPDF3DAnnot * | pAnnot, | ||
A3DAsmModelFile * | pModelFile, | ||
A3DInt32 | iNumberOfButtons, | ||
A3DUTF8Char ** | ppButtonsNames, | ||
A3DUTF8Char * | pPreviousButtonName, | ||
A3DUTF8Char * | pNextButtonName, | ||
A3DInt32 | iNumberOfViews, | ||
A3DPDFView ** | ppViews, | ||
A3DPDFImage ** | ppImages, | ||
A3DInt32 | iScrollStep | ||
) |
Function to create a 'standard' view carousel and position it in the PDF document. The PDF document must contain the buttons for the views and the buttons to go to the next and the previous view.
[in,out] | pDoc | The document which will contain the carousel. |
[in] | pPage | The page where the carousel will be put. |
[in] | pAnnot | The annotation which contains the views of the carousel. |
[in] | pModelFile | The model file corresponding with the annotation. |
[in] | iNumberOfButtons | The number of buttons in the ppButtonsNames array. |
[in] | ppButtonsNames | The names of the view buttons in the pdf file. The size of this array should be iNumberOfButtonsRows*iNumberOfButtonsCols. |
[in] | pPreviousButtonName | The name of the button to press to scroll the carousel to previous views. |
[in] | pNextButtonName | The name of the button to press to scroll the carousel to next views. |
[in] | iNumberOfViews | If equal to 0, all the views of the model file will be used, in the order they are found in the model file. If superior than 0, the number of the views of the next parameter. |
[in] | ppViews | If NULL, all the views of the model file will be used. If not NULL, ppViews must contain the views that will be used for the carousel. |
[in] | ppImages | If NULL, the images are automatically created from the views. If not NULL, ppImages must contain the images that will be used for the views. In that case, the size of the array should be the same as the size of ppViews parameter. |
[in] | iScrollStep | This is the number of buttons icons scrolled. If = iNumberOfButtons, the carousel scrolls the icons by page (all the icons are replaced in the carousel). If = the number of rows, the icons are scrolled by rows. If = the number of columns, the icons are scrolled by columns. If = 1, the carousel scrolls the icons one by one (all the icons are shifted of 1 increment in the carousel). |
A3DStatus A3DPDFDefineSlideTable | ( | A3DPDFDocument * | pDoc, |
A3DPDFPage * | pPage, | ||
const A3DInt32 | iPosLeft, | ||
const A3DInt32 | iPosTop, | ||
A3DUTF8Char * | pcHtmlFrameTable, | ||
A3DUTF8Char * | pcHtmlFrameStyle, | ||
A3DUTF8Char * | pPreviousButtonName, | ||
A3DUTF8Char * | pNextButtonName, | ||
A3DInt32 | iNbTextRows, | ||
A3DInt32 | iNbTextCols, | ||
A3DPDFTextField *** | ppTexts, | ||
A3DBool | bHasHeader | ||
) |
Function to create a slide table. This is a table with a fixed size, and two buttons to scroll the rows of the table. The frame of the table is specified through html definition and printed as-is on the page. Then the text data is populated dynamically from an array of texts specified. The table MUST be of simple shape, with the same number of rows for each columns. Optionally, a header can figure in the table data at first row. The text data defines the text content, as well as text format attributes (font, font size, and text color). All rows must have the same text attributes, so that only the first row of text data is used internally to get the text format.
[in,out] | pDoc | The document which will contain the slide table. |
[in,out] | pPage | The page where the slide table will be put. |
[in] | iPosLeft | The x coordinate of the insertion point of the table. The insertion point is the top left corner of the table. The coordinate origin (0, 0) is the bottom left of the page. The unit is point. |
[in] | iPosTop | The y coordinate of the insertion point of the table. The insertion point is the top left corner of the table. The coordinate origin (0, 0) is the bottom left of the page. The unit is point. |
[in] | pcHtmlFrameTable | String for definition of the frame table in a HTML format. See example definition in Table Module. |
[in] | pcHtmlFrameStyle | String for definition of the frame table style in a CSS format. See example definition in Table Module. |
[in] | pPreviousButtonName | The name of the button to press to go to the previous page. |
[in] | pNextButtonName | The name of the button to press to go to the next page. |
[in] | iNbTextRows | the number of rows in the matrix of text data specified in ppTextData. |
[in] | iNbTextCols | the number of columns in the matrix of text data specified in ppTextData. It should be the same number as of the number of columns specified in the table frame. |
[in] | ppTexts | must contain the text data that will be used to dynamically populate the table. It is a matrix of iNbTextRows*iNbTextCols elements of type (A3DPDFTextField*). These elements should be created with A3DPDFTextFieldCreate. The first row might contain the header for the table. In that case, specify bHasHeader to TRUE, then the first row will not be scrolled and the formatting specific to this row will be applied. The following members of A3DPDFTextFieldData structure are used:
|
[in] | bHasHeader | If true, the table header is described at first row of ppTexts. This row will remain visible and won't be scrolled when pushing the prev/next buttons. If false, the table is considered without header, then the whole rows will be scrolled when pushing the prev/next buttons. |
A3DStatus A3DPDFDefineSlideTable2 | ( | A3DPDFDocument * | pDoc, |
A3DPDFPage * | pPage, | ||
const A3DInt32 | iPosLeft, | ||
const A3DInt32 | iPosTop, | ||
A3DUTF8Char * | pcHtmlFrameTable, | ||
A3DUTF8Char * | pcHtmlFrameStyle, | ||
A3DInt32 | iSliderWidth, | ||
A3DInt32 | iNbTextRows, | ||
A3DInt32 | iNbTextCols, | ||
A3DPDFTextField *** | ppTexts, | ||
A3DBool | bHasHeader, | ||
A3DUTF8Char ** | ppcSTName | ||
) |
Function to create a slide table. This is a table with a fixed size, and a scroll bar to scroll the rows of the table. This function differs from A3DPDFDefineSlideTable in that it uses a scroll bar to scroll the rows instead of previous and next buttons. The frame of the table is specified through html definition and printed as-is on the page. Then the text data is populated dynamically from an array of texts specified. The table MUST be of simple shape, with the same number of rows for each columns. Optionally, a header can figure in the table data at first row. The text data defines the text content, as well as text format attributes (font, font size, and text color). All rows must have the same text attributes, so that only the first row of text data is used internally to get the text format.
[in,out] | pDoc | The document which will contain the slide table. |
[in,out] | pPage | The page where the slide table will be put. |
[in] | iPosLeft | The x coordinate of the insertion point of the table. The insertion point is the top left corner of the table. The coordinate origin (0, 0) is the bottom left of the page. The unit is point. |
[in] | iPosTop | The y coordinate of the insertion point of the table. The insertion point is the top left corner of the table. The coordinate origin (0, 0) is the bottom left of the page. The unit is point. |
[in] | pcHtmlFrameTable | String for definition of the frame table in a HTML format. See example definition in Table Module. |
[in] | pcHtmlFrameStyle | String for definition of the frame table style in a CSS format. See example definition in Table Module. |
[in] | iSliderWidth | The width of the scroll bar (in points). Important: The scrollbar is positioned on the right of the table, outside of the frame. |
[in] | iNbTextRows | the number of rows in the matrix of text data specified in ppTextData. |
[in] | iNbTextCols | the number of columns in the matrix of text data specified in ppTextData. It should be the same number as of the number of columns specified in the table frame. |
[in] | ppTexts | must contain the text data that will be used to dynamically populate the table. It is a matrix of iNbTextRows*iNbTextCols elements of type (A3DPDFTextField*). These elements should be created with A3DPDFTextFieldCreate. The first row might contain the header for the table. In that case, specify bHasHeader to TRUE, then the first row will not be scrolled and the formatting specific to this row will be applied. The following members of A3DPDFTextFieldData structure are used:
|
[in] | bHasHeader | If true, the table header is described at first row of ppTexts. This row will remain visible and won't be scrolled when using the scroll bar. If false, the table is considered without header, then the whole rows will be scrolled when using the scroll bar. |
[out] | ppcSTName | The identifier of the slide table as a string. It can be useful to add Javascript instructions to work on this specific slide table. |
A3DStatus A3DPDFDocumentSave | ( | A3DPDFDocument * | pDoc, |
const A3DUTF8Char * | pcFileName | ||
) |
Function to save the PDF document.
[in] | pDoc | The Document object to save. |
[in] | pcFileName | The file name where to save the document. The path (absolute or relative) must be provided (use ".\\" for the current directory). |