
###########################
A3DPDFObjectDataTableCreate
###########################

.. c:function:: A3DStatus A3DPDFObjectDataTableCreate(A3DPDFDocument *pDoc, const A3DPDFDataTableData *pDataTableData, A3DPDFObjectDataTable **ppDataTable)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DPDFObjectDataTableCreate(:c:type:`~A3DPDFDocument`\ \* **pDoc**\ , *const* :c:struct:`~A3DPDFDataTableData`\ \* **pDataTableData**\ , :c:type:`~A3DPDFObjectDataTable`\ \*\* **ppDataTable**\ )
   
   Function to create a Object DataTable.
   
   An Ojbect DataTable is a specific data table that contain objects instead of just text. An Object define a set of properties and related values ; it is formatted as follows : { property1: valueproperty1, property2: valueproperty2, ... }Supported properties are:
   
   
   - caption : the text of the field
   - icon : the icon id to store on the field when the field is defined as image holder (button)
   - actionurl : an url to be launched when the user clicks on the cell
   - actionjs : a javascript code to be launched when the user clicks on the cell
   - actionjscallback : the name of a javascript function stored on the document. This callback function is called when the user clicks on the cell, with the arguments : tablerowindex, tablecolindex, userdata (see actionjscallbackdata)
   - actionjscallbackdata : the third argument provided to the callback function actionjscallback
   
   Properties actionurl, actionjs, or actionjscallback can be used to define an action on a table cell. If an action is defined on a cell: when the user clicks on the cell, the row selected is unhighlighted and the action is launched. If no action is defined on the cell: when the user clicks on the cell, the row selected is highlighted and the datamodel action linked to the row is launched (typically invoking other widgets on the page bound on linked tables).
   
   **Parameters**
   
   
      **pDoc**\ : The Document object to work with.
   
      **pDataTableData**\ : The DataTable parameters.
   
      **ppDataTable**\ : The DataTable object created.
   
   
   **Returns**
   
   
      A3D_SUCCESS in case of success or an error code
   
   




