Model-Based Definition and Drawing Tables
This section describes the Creo TOOLKIT functions that can be used to create model-based definition tables and drawing tables.
In Model-Based Definition (MBD) you can create and manage annotations directly in the context of 3D models. Fully annotate your 3D models so that they can be used directly by downstream functions such as manufacturing and inspection, eliminating the need for 2D detailed drawings as an engineering deliverable.
MBD and Drawing Tables
A drawing table is identified by the DHandle ProDwgtable which is typedef to ProModelitem and inherited from ProModelitem. The type field in ProDwgtable has the value PRO_DRAW_TABLE.
A drawing table and model-based definition table is identified by the DHandle ProTable which is typedef to ProModelitem and inherited from ProModelitem. The type field in ProTable has the value PRO_TABLE.
The information required to build a mbd table is contained in an opaque data structure, pro_table_data that has to be allocated and filled before the table can be created.
Selecting Drawing Tables and Cells
Function Introduced:
  • ProSelectionDwgtblcellGet()
    		•
    In order to ask the user to select a table cell, use the option dwg_table as input to ProSelect(), and then use ProSelectionModelitemGet() to acquire the ProDwgtable handle to the table.
    To select a table cell, use the option table_cell and call ProSelectionModelitemGet() to get the table handle, and the special function ProSelectionDwgtblcellGet() that returns the IDs of the selected table segment, column and row. The function ProSelectionDwgtblcellGet() returns row and column values starting from 0. To get the actual values of the rows and the columns, add 1 to the result, so that these can be used in other Creo TOOLKIT functions.
    Creating MBD and Drawing Tables
    Functions Introduced:
  • ProTableDataAlloc()
    		•
  • ProTableDataOriginSet()
    		•
  • ProTableDataRowsSet()
    		•
  • ProTableDataColumnsSet()
    		•
  • ProTableDataFreeAttachSet()
    		•
  • ProTableDataSizetypeSet()
    		•
  • ProTableDataAnnotationPlaneSet
    		•
  • ProTableTextEnter()
    		•
  • ProTableCreate()
    		•
  • ProTableDisplay()
    		•
  • ProDwgtableGrowthdirectionSet()
    		•
    Superseded Functions:
  • ProDwgtabledataAlloc()
    		•
  • ProDwgtabledataOriginSet()
    		•
  • ProDwgtabledataRowsSet()
    		•
  • ProDwgtabledataColumnsSet()
    		•
  • ProDwgtabledataSizetypeSet()
    		•
  • ProDrawingTableCreate()
    		•
  • ProDwgtableTextEnter()
    		•
  • ProDwgtableDisplay()
    		•
    The information required to build a table is contained in an opaque data structure, ProDwgtabledata that has to be allocated and filled before the table can be created.
    ProDwgtabledataAlloc() is deprecated. Use the function ProTableDataAlloc() instead. ProTableDataAlloc() allocates memory for ProTableData structure.
    ProDwgtabledataOriginSet() is deprecated. Use the function ProTableDataOriginSet() instead.
    Use the function ProTableDataOriginSet() to set the origin in the specified ProTableData structure.
    The function ProDwgtabledataRowsSet() is deprecated. Use the function ProTableDataRowsSet() instead.
    The function ProDwgtabledataColumnsSet() is deprecated. Use the function ProTableDataColumnsSet() instead.
    Use the function ProTableDataFreeAttachSet() to set the free attachment in the specified ProTableData structure. The input arguments are:
    •  data
    •  plane
    •  origin
    ProDwgtabledataSizetypeSet() is deprecated. Use the function ProTableDataSizetypeSet() instead.
    Use the function ProTableDataAnnotationPlaneSet() to set the annotation plane for the specified solid table. The input argument data is specified using the ProTableData structure.
    ProDwgtableTextEnter() is deprecated. Use the function ProTableTextEnter() instead
    The function ProTableTextEnter() adds the specified lines of text into the appropriate row and column of the table. The input arguments are as follows:
    •  table—Specify the table using the ProTable object.
    •  column—column number of the cell.
    •  row—row number of the cell.
    •  lines—ProArray of text lines assigned to the table cell
    Note
    One or more lines of text can be written in a cell. If a line of text is too wide for a cell, the text overlaps the neighboring cells.
    ProDrawingTableCreate() is deprecated.
    Use the function ProTableCreate() instead. to create a table on the current sheet or active combination state. The input arguments are as follows:
    •  mdl—model using ProMdl typedef.
    •  table_data—Specify the table data using the ProTableData structure.
    •  display—flag that indicates if the table is to be displayed after creation. If TRUE, the table is displayed, if FALSE, the table is not displayed.
    Use the function ProTableDataSizetypeSet() to set up the size type in the specified ProTableData structure. The input argument size_type is specified using the enumerated data type ProTableSizetype.
    The function ProDwgtableDisplay() is deprecated. Use the function ProTableDisplay() instead.
    The function ProTableDisplay() displays the specified table. The input arguments are as follows:
    •  table—table to be displayed.
    •  state—state to display to. using the ProCombstate object.
    The growth direction of a drawing table determines how a drawing table will expand in terms of rows and columns when repeat regions are added to the table. Use the function ProDwgtableGrowthdirectionSet() to set the growth direction of the table. The growth direction is specified using the enumerated data type, ProDwgtableGrowthdirType and has the following values:
    •  PRODWGTABLEGROWTHDIR_DOWNRIGHT
    •  PRODWGTABLEGROWTHDIR_DOWNLEFT
    •  PRODWGTABLEGROWTHDIR_UPRIGHT
    •  PRODWGTABLEGROWTHDIR_UPLEFT
    Note
    This enumerated data type ProDwgtableGrowthdirType is applicable for Drawing only.
    For more information on the growth direction, see the Creo Parametric Help.
    Modifying MBD or Drawing Tables
    Functions Introduced:
  • ProTableIsFromFormat()
    		•
  • ProTableRowAdd()
    		•
  • ProTableColumnAdd()
    		•
  • ProTableRowHeightGet()
    		•
  • ProTableRowHeightSet()
    		•
  • ProTableColumnWidthGet()
    		•
  • ProTableColumnWidthSet()
    		•
  • ProTableRowDelete()
    		•
  • ProTableColumnDelete()
    		•
  • ProTableRowheightAutoadjustSet()
    		•
  • ProTableRowheightAutoadjustGet()
    		•
  • ProTableDelete()
    		•
  • ProTableErase()
    		•
  • ProTableRotate()
    		•
  • ProTableSave()
    		•
  • ProTableCellIsComment()
    		•
  • ProTableCellNoteGet()
    		•
  • ProTableCellsMerge()
    		•
  • ProTableCellMergeGet()
    		•
  • ProTableCellsRemesh()
    		•
  • ProDwgtableCelltextWrap()
    		•
  • ProDwgtableSave()
    		•
  • ProDwgtableColumnWidthSet()
    		•
  • ProDwgtableRowHeightSet()
    		•
  • ProDwgtableRowheightAutoadjustGet()
    		•
  • ProDwgtableRowheightAutoadjustSet()
    		•
    Superseded Functions:
  • ProDwgtableRowAdd()
    		•
  • ProDwgtableColumnAdd()
    		•
  • ProDwgtableRowDelete()
    		•
  • ProDwgtableColumnDelete()
    		•
  • ProDwgtableCellsMerge()
    		•
  • ProDwgtableCellsRemesh()
    		•
  • ProDwgtableRotate()
    		•
  • ProDwgtableErase()
    		•
  • ProDwgtableDelete()
    		•
    Use the function ProTableIsFromFormat() to determine if the specified table is associated with the format. If the table is associated with the format, the output argument from_format is a ProBoolean PRO_B_TRUE, else it is PRO_B_FALSE.
    Note
    This function is applicable for Drawing only.
    Both ProDwgtableRowAdd() and ProDwgtableColumnAdd() are deprecated. Use the functions ProTableRowAdd() and ProTableColumnAdd() instead.
    Use the function ProTableRowAdd() to add a row to the specified table. The input arguments are as follows:
    •  table—Specify the table.
    •  insert_after_row— row after which the new row is to be added. Row numbers start with 1. Pass the value 0 to insert the new row at the top of the table. To append the row in the last, pass a value less than 0.(any negative value).
    •  display—flag that indicates if the table is to be displayed after creation.
    •  height_in_chars—height of the row in characters. Pass -1 to take value of previous row.
    Note
    The function returns the error PRO_TK_GENERAL_ERROR if you try to insert the row in the middle of the non-template element of a repeat region.
    Use the function ProTableColumnAdd() to add a column to the specified table. The input arguments are as follows:
    •  table—Specify the table.
    •  insert_after_col— column after which the new column is to be added. Column numbers start with 1. Pass the value 0 to insert the new columns at the top of the table. To append the column in the last, pass a value less than 0 (any negative value).
    •  display—flag that indicates if the table is to be displayed after creation.
    •  width_in_chars—width of the column in characters. Pass -1 to take value of previous column.
    Both ProDwgtableRowDelete() and ProDwgtableColumnDelete() are deprecated. Use the functions ProTableRowDelete() and ProTableColumnDelete() instead.
    Use the function ProTableRowDelete() to delete the specified row from the specified table.
    Use the function ProTableColumnDelete() to delete the specified column from the specified table.
    For both the functions ProTableRowDelete() and ProTableColumnDelete(), the input argument display specifies the flag that indicates if the table is to be displayed after creation. If TRUE, the table is displayed, if FALSE, the table is not displayed.
    Use the function ProTableRowHeightGet() to get the row height of the specified table. The input arguments are as follows:
    •  table—Specify the table.
    •  row—row index.
    •  size_type—size type is specified using the enumerated data type ProTableSizetype. If you specify PROTABLESIZE_CHARACTERS, the row_height is rounded down. To avoid this, use PROTABLESIZE_CHARS_TRUE.
    Use the function ProTableRowHeightSet() to set the row height of the specified table. The input arguments are as follows:
    •  table—Specify the table.
    •  row—row index.
    •  row_height—row height.
    •  size_type—size type is specified using the enumerated data type ProTableSizetype If you specify PROTABLESIZE_CHARACTERS, the row_height will be rounded down. To avoid this, use PROTABLESIZE_CHARS_TRUE.
    Use the function ProTableColumnWidthGet() to get the column width of the specified table. The input arguments are as follows:
    •  table—Specify the table.
    •  column—column index. Column indices start at 1.
    •  size_type—size type is specified using the enumerated data type ProTableSizetype If you specify PROTABLESIZE_CHARACTERS, the column_width will be rounded down. To avoid this, use PROTABLESIZE_CHARS_TRUE.
    Use the function ProTableColumnWidthSet() to set the column width of the specified table. The input arguments are as follows:
    •  table—Specify the table.
    •  column—column index. Column indices start at 1.
    •  column_width—column width.
    •  size_type—size type is specified using the enumerated data type ProTableSizetype If you specify PROTABLESIZE_CHARACTERS, the column_width will be rounded down. To avoid this, use PROTABLESIZE_CHARS_TRUE.
    Use the function ProTableDataRowsSet() to set up row properties. The input arguments are as follows:
    •  data—Specify using the ProTableData structure.
    •  n_rows—number of rows. The maximum number of rows that can be specified is 100.
    •  heights—ProArray of row heights
    Use the function ProTableDataColumnsSet() to set up the column properties. The input arguments are as follows:
    •  data—Specify using the ProTableData structure.
    •  n_columns—number of columns. The maximum number of columns that can be specified is 50.
    •  widths—ProArray of column widths.
    •  justifications—ProArray of justifications using the enumerated data type ProHorzJust.
    Use the function ProTableRowheightAutoadjustSet() to set the automatic height adjustment property for a specified row of the specified table. The input arguments are as follows:
    •  table—The reference to the table.
    •  row—Row number for which the property is to be set. Row numbers start with 1.
    •  auto_adjust—Set the property using the enumerated data type ProTableRowheightAutoadjusttype. The valid values are:
    ○  PROTBLROWHEIGHT_AUTOADJUST_TRUE—Sets the property.
    ○  PROTBLROWHEIGHT_AUTOADJUST_FALSE—Unsets the property.
    Use the function ProTableRowheightAutoadjustGet() to get the automatic height adjustment property for a specified row of the specified table. The input arguments are as follows:
    •  table—The reference to the table.
    •  row—Row number for which the property is to be retrieved. Row numbers start with 1.
    •  size_type—size type is specified using the enumerated data type ProTableSizetype. If you specify PROTABLESIZE_CHARACTERS, the row_height is rounded down. To avoid this, use PROTABLESIZE_CHARS_TRUE.
    ○  PROTABLESIZE_CHARACTERS
    ○  PROTABLESIZE_MODEL_UNITS
    ○  PROTABLESIZE_CHARS_TRUE
    The function returns the following output arguments:
    •  auto_adjust—Value for auto adjust property.
    •  height—Auto adjusted height if auto_adjust is PROTBLROWHEIGHT_AUTOADJUST_TRUE. Ignore for PROTBLROWHEIGHT_AUTOADJUST_FALSE.
    The function ProDwgtableDelete() is deprecated. Use the function ProTableDelete() instead.
    Use the function ProTableDelete() to delete the specified table.
    The function ProDwgtableErase() is deprecated. Use the function ProTableErase() instead.
    Use the function ProTableErase to erase the specified table. The input argument state is the combination state to erase from. Pass as NULL for drawing table.
    The function ProDwgtableRotate() is deprecated. Use the function ProTableRotate() instead.
    The function ProTableRotate() rotates the specified table (clockwise) by 90 degree. The function does not perform a display. The input argument display specifies the flag that indicates if the table is to be displayed after creation. If TRUE, the table is displayed, if FALSE, the table is not displayed.
    Use the function ProTableCellIsComment() to determine if the specified cell is a comment cell. The input arguments are as follows:
    •  table—Specify the table.
    •  column—column index. Column indices start at 1.
    •  row—row index. Row indices start at 1.
    The function ProTableCellNoteGet() returns the note identifier for a specified cell of the table.
    The function ProDwgtableCellsMerge() is deprecated. Use the function ProTableCellsMerge() instead.
    The function ProDwgtableCellsRemesh() is deprecated. Use the function ProTableCellsRemesh() instead.
    The function ProTableCellsMerge() takes a rectangular region of cells and merges them into a composite cell. The merged cells, rows, or columns are deleted, and the table's appearance is restored using prodrw_remesh_table_cells().
    Note
    This function is equivalent to the user interface options Drawing, Table, Mod Rows/Col, Merge in Creo Parametric. Limitations in the user interface apply to the function as well. For example, borders of merge cannot intersect the borders of another merge or repeat region.
    The function ProTableCellMergeGet() gets the merge information of a specified cell. The input arguments are:
    •  table—Specify the table using ProTable object.
    •  row—Specify row of the cell. The row indices start at 1.
    •  col—Specify column of the cell. The column indices start at 1.
    The function returns the following output arguments:
    •  is_merge—Returns a PRO_B_TRUE value if the cell is merged using a ProBoolean object.
    •  start_row—Row index for start merge cell. The row indices start at 1.
    •  start_col—Column index for start merge cell. The column indices start at 1.
    •  end_row—Row index for end merge cell. The row indices start at 1.
    •  end_col—Column index for end merge cell. The column indices start at 1.
    The function ProTableCellsRemesh() undoes all merges created in the specified rectangular region.
    The function ProDwgtableCelltextWrap() wraps the text in a cell.
    The function ProDwgtableSave() is deprecated. Use the function ProTableSave() instead.
    Use the function ProTableSave() to save the table in different format. The input arguments are:
    •  table—Reference to the table.
    •  path—Full path of the location in which the table needs to be saved.
    •  table_format—Format of the table defined using the enumerated data type ProTableFormattype.
    •  segment_id—Segment of the table to save, if table_format is PROTABLEFORMAT_CSV or PROTABLEFORMAT_XLSX.
    In Creo Parametric 11.0.0.0, the enumerated data type ProDwgtableFormattype is deprecated. Use the enumerated data type ProTableFormattype instead. The valid values are:
    •  PROTABLEFORMAT_TBL—Specifies the tabular format.
    •  PROTABLEFORMAT_TXT—Specifies the text format.
    •  PROTABLEFORMAT_CSV—Specifies the CSV format.
    •  PROTABLEFORMAT_XLSX—Specifies the XLSX format.
    ProDwgtableColumnWidthSet() and ProDwgtableRowHeightSet() assign the width of a specified column and the height of a specified row, respectively, depending upon the size of the drawing table. The drawing table size given by the enumerated data type ProDwgtableSizetype can be of the following types:
    •  PRODWGTABLESIZE_CHARACTERS—Specifies the size in characters. If the specified value for width of a column or height of a row is a fraction, PRODWGTABLESIZE_CHARACTERS rounds down the fractional value to the nearest whole number. In Creo Parametric 11.0.0.0, PRODWGTABLESIZE_CHARACTERS is deprecated.
    •  PRODWGTABLESIZE_SCREEN—Specifies the size in screen coordinates.
    •  PRODWGTABLESIZE_CHARS_TRUE—Specifies the size in characters. It enables you to specify a fractional value for the width of a column and height of a row.
    To accommodate a wrapped text in a table row, you can use the Creo TOOLKIT functions to automatically adjust the height of the row to accommodate the entire text content. The functions ProDwgtableRowheightAutoadjustGet() and ProDwgtableRowheightAutoadjustSet() get and set the automatic row height adjustment property for a row of a drawing table. These functions use the enumerated type ProDwgtableRowheightAutoadjusttype, which has the following values:
    •  PRODWGTBLROWHEIGHT_AUTOADJUST_FALSE—Specifies that the automatic row height adjustment property is not set.
    •  PRODWGTBLROWHEIGHT_AUTOADJUST_TRUE—Specifies that the automatic row height adjustment property is set.
    •  PRODWGTBLROWHEIGHT_AUTOADJUST_TRUE_LEGACY—Specifies a pre-Creo Parametric 1.0 release behavior. In this behavior, sometimes the row height may be automatically adjusting and sometimes may not be automatically adjusting. To set an explicit row adjustment status use the function ProDwgtableRowheightAutoadjustSet().
    Note
    ○  The value PRODWGTBLROWHEIGHT_AUTOADJUST_TRUE_LEGACY is not applicable to the function ProDwgtableRowheightAutoadjustSet().
    ○  When using the function ProDwgtableRowheightAutoadjustSet() any changes in the height of a row will be seen only after the next regeneration, or a call to the function ProDrawingTablesUpdate().
    Reading MBD or DrawingTables
    Functions Introduced:
  • ProTableOriginGet()
    		•
  • ProTableAnnotationPlaneGet()
    		•
  • ProTableVisit()
    		•
  • ProTableVisitAction()
    		•
  • ProTableFilterAction()
    		•
  • ProTableRowsColumnsCount()
    		•
  • ProTableCelltextGet()
    		•
  • ProTablesCollect()
    		•
  • ProSelectionTableGet()
    		•
  • ProDwgtableInfoGet()
    		•
  • ProDwgtableColumnSizeGet()
    		•
  • ProDwgtableRowSizeGet()
    		•
  • ProDwgtableRetrieve()
    		•
  • ProDwgtableByOriginRetrieve()
    		•
  • ProDwgtableGrowthdirectionGet()
    		•
  • ProTableCellBlankGet()
    		•
  • ProTableBorderStyleGet()
    		•
  • ProTableCellFillColorGet()
    		•
    Superseded Functions:
  • ProDrawingTableVisit()
    		•
  • ProDrawingTablesCollect()
    		•
  • ProDwgtableColumnsCount()
    		•
  • ProDwgtableRowsCount()
    		•
  • ProDwgtableCellNoteGet()
    		•
  • ProDwgtableCelltextGet()
    		•
  • ProDwgtableIsFromFormat()
    		•
    The function ProTableOriginGet() acts on ProTable and returns the placement point which is the top left corner of the table.
    Use the function ProTableAnnotationPlaneGet() to get the annotation plane for the specified solid table. The input argument table is specified using the ProTable object.
    Note
    For drawing, the function ProTableAnnotationPlaneGet() returns an error.
    ProDrawingTableVisit() visits all the tables in a specified drawing; it conforms to the usual standard for visit functions. ProDrawingTablesCollect() is an alternative, and returns an array of ProDwgtable handles for a drawing.
    The functions ProDrawingTableVisit() and ProDrawingTablesCollect() are deprecated. Use the functions ProTableVisit() and ProTablesCollect() instead.
    A table may be divided into several segments, which are numbered sequentially from 0. The function ProDwgtableInfoGet() takes a ProDwgtable and a segment ID as input, and fills a data structure that describes the properties of the table. If the segment does not exist, it returns PRO_TK_NOT_EXIST. The properties of the table are as follows: 
    int rotation;                The number of 90 degree turns
                                clockwise.
double seg_origin[3];        The screen coordinates of the
                               top left corner of the segment.
int nrows;                   The number of rows.
int ncols;                   The number of columns.
double outline[2][3];        The outline of the segment.
double seg_char_height;      The text height used for the
                               segment.
double table_char_height;    The text height used for the
                               drawing.
double char_width;           The character width factor.
    The function ProTableVisit() visits tables in the specified model. The input arguments are as follows:
    •  model—model to visit.
    •  visit_action—visit action using the function ProTableVisitAction().
    •  filter_action—filter action using the function ProTableFilterAction().
    •  data—Specify using the ProTableData structure.
    The function ProTableVisitAction() is the action function called for each drawing entity during the call to the function ProTableVisit().
    The function ProTableFilterAction() is the filter function called for each table entity during the call to the function ProTableVisit().
    The function ProTableRowsColumnsCount() counts the table rows and columns.
    The function ProTableCelltextGet() places the text of the specified table into a string array. The input arguments are as follows:
    •  table—Specify the table.
    •  row—row index. The row indices start at 1.
    •  column—column index. The column indices start at 1.
    •  mode—mode type is specified using the enumerated data type ProTableParamMode. Specify 1 to get the text as displayed. Specify 2 to get the text as shown in the full note editor.
    The output argument lines is the text of the table, specified using the array of ProWstring. Use the function ProWstringproarrayFree() to free this array.
    Use the function ProTablesCollect() to collect all tables in the specified model. The output argument tables is an array of tables specified using the ProTable object. Use the function ProArrayFree() to free the memory allocated by the function ProTablesCollect().
    For a ProSelection representing a cell of a table, the function ProSelectionTableGet() returns the table from which the cell was selected.
    The functions ProDwgtableRowsCount() and ProDwgtableColumnsCount() return the number of rows and columns in a table respectively.
    Both ProDwgtableRowsCount() and ProDwgtableColumnsCount() are deprecated. Use the function ProTableRowsColumnsCount instead.
    The functions ProDwgtableColumnSizeGet() and ProDwgtableRowSizeGet() give the column width and row height for a specified table column and row respectively.
    The text item in each cell of a drawing table is stored as a detail note. If you need to modify the note in some way, for example the style, you can use the ProDtlnote*() functions described in the section on Detail Items. The function ProDwgtableCellNoteGet() returns the handle to the detail note that represents the text in a specified table cell.
    The function ProDwgtableCellNoteGet() is deprecated. Use the function ProTableCellNoteGet() instead.
    The function ProDwgtableCelltextGet() places the text of the table into a string array. ProDwgtableCelltextGet() is deprecated. Use the function ProTableCelltextGet() instead.
    The function ProDwgtableIsFromFormat() indicates whether a table was added to the table as a result of importing a format. The function ProDwgtableIsFromFormat() is deprecated. Use the function ProTableIsFromFormat() instead.
    The function ProDwgtableRetrieve() retrieves a drawing table from a properly formatted Creo Parametric table file, and places it in the specified drawing. It allows you to add a table to a drawing without having to specify all the table properties. This function also supports parameter tables exported in the CSV or TXT format from the Parameters dialog box or using ProParameterTableExport(). Refer to the Core: Parameters section for more information on parameters.
    The input arguments are:
    •  drawing—Specifies the drawing in which the table must be retrieved.
    •  file_name—Specifies the name of the drawing table. You must not mention the extension.
    •  file_path—Specifies the path to the drawing table file. The path must be specified relative to the working directory.
    •  file_version—Species the version of the drawing table that must be retrieved. The version 0, represents the latest version of the drawing table.
    •  position—Specifies the coordinates of the point on the drawing sheet, where the table must be placed. The upper-left corner of the table is placed at this point on the drawing sheet. You must specify the value in screen coordinates.
    •  solid—Specifies the model from which data must be copied into the drawing table. If this argument is passed as NULL, an empty table is created.
    •  simp_rep—Specifies a handle to the simplified representation in a solid, from which data must be copied into the drawing table. If this argument is passed as NULL, and the argument solid is not NULL, then data from the solid model is copied into the drawing table.
    The function ProDwgtableByOriginRetrieve() retrieves a drawing table from a properly formatted Creo Parametric table file, and places it in the specified drawing. The function is similar to function ProDwgtableRetrieve(), except that it positions the origin of the table at the specified point in the drawing. Tables can be created with different origins by specifying the option Direction, in the Insert Table dialog box.
    The function ProDwgtableGrowthdirectionGet() gets the growth direction of the table using the enumerated type ProDwgtableGrowthdirType. For more information on the values of ProDwgtableGrowthdirType, see the section Creating MBD and Drawing Tables.
    Use the function ProTableCellBlankGet() to get the blank border information for the specified cell. The input arguments are:
    •  table—Specify the table of the blank border information using the Protable object.
    •  row—Row of the cell. Row indices start at 1.
    •  col—Column of the cell. Column indices start at 1.
    The output argument blank_flags is a bit mask that provides information about the blank border for the specified cell, and the values are as follows
    •  PROTBLCELL_BLANK_LEFT (1<<0)
    •  PROTBLCELL_BLANK_RIGHT (1<<1)
    •  PROTBLCELL_BLANK_TOP (1<<2)
    •  PROTBLCELL_BLANK_BOTTOM (1<<3)
    Use the function ProTableBorderStyleGet() to get the line style of the table borders. The input argument table is specified using the ProTable object.
    The output arguments are:
    •  line_style—Specifies the line style of the table borders using the ProLinestyle object.
    •  width—Specifies the width of the table borders.
    •  clr—Specifies the color of the table borders using the ProColor objects.
    Use the function ProTableCellFillColorGet() to get the color of the specified cell. The input arguments are:
    •  table—The table specified using the ProTable object.
    •  row—Specifies row of the cell. Row indices start at 1.
    •  col—Specifies column of the cell. Column indices start at 1.
    The output argument color is the color of the given table cell using the ProColor object.
    MBD Table References
    Functions Introduced:
  • ProTableReferencesGet()
    		•
  • ProTableReferenceDelete()
    		•
  • ProTableReferencesAdd()
    		•
    These functions are applicable to MBD tables only.
    Use the function ProTableReferencesGet() to get the table references. The output argument p_refs is a ProArray of references that can be specified using the structure ProAnnotationReference. Use the function ProAnnotationreferencearrayFree() to free the array.
    Use the function ProTableReferenceDelete() to delete the specified table references. The input arguments are as follows:
    •  table—table for which the references need to be deleted.
    •  index_ref—indices of references to be deleted. You can get the existing references using the function ProTableReferencesGet().
    Use the function ProTableReferencesAdd() to add the specified table references. The input arguments are as follows:
    •  table—Table for which the references need to be added.
    •  index_ref —ProArray of references to be added. Only 1 reference from the type PRO_ANNOT_REF_SRF_COLLECTION is allowed.
    Notification Functions
    Creo TOOLKIT notifications are available when a drawing table or a row from a drawing table is deleted. The notification functions are established in a session using the function ProNotificationSet().
  • ProDwgtableDeletePreAction()
    		•
  • ProDwgtableDeletePostAction()
    		•
  • ProDwgtableRowDeletePreAction()
    		•
  • ProDwgtableRowDeletePostAction()
    		•
    The notification function ProDwgtableDeletePreAction() is called before deletion of a drawing table. This function is available by calling ProNotificationSet() with the value of the notify type as PRO_DWGTABLE_DELETE_PRE.
    The notification function ProDwgtableDeletePostAction() is called after deletion of a drawing table. This function is available by calling ProNotificationSet() with the value of the notify type as PRO_DWGTABLE_DELETE_POST.
    The notification function ProDwgtableRowDeletePreAction() is called before the deletion of a row from the selected drawing table. The input arguments for this function are as follows:
    •  table—The table containing the row to be deleted.
    •  i_row—The index of the row to be deleted.
    Note
    The index of the first row is 1.
    This function is available by calling ProNotificationSet() with the value of the notify type as PRO_DWGTABLE_ROW_DELETE_PRE. The specified row is not deleted if the application returns an error from this callback. If the user cancels the deletion, an appropriate message should be displayed, if required.
    The notification function ProDwgtableRowDeletePostAction() is called after the deletion of a row from the selected drawing table. This function is available by calling ProNotificationSet() with the value of the notify type as PRO_DWGTABLE_ROW_DELETE_POST.
    Example 15: Creation of Table Listing Datum Points
    The sample code in the file UgDwgtableExamples.c located at <creo_toolkit_loadpoint>/protk_appls/pt_userguide/ptu_drawing, shows a command that creates a drawing table listing the datum points in a model shown in a drawing view.
    Drawing Table Segments
    Functions Introduced:
  • ProDwgtableSegMove()
    		•
  • ProDwgtableSegCount()
    		•
  • ProDwgtableSegSheetGet()
    		•
  • ProDwgtableSegmentOriginSet()
    		•
    Drawing tables can be constructed with one or more segments. Each segment can be independently placed.
    Note
    For these functions, pass -1 to refer to the only segment of a one-segment table.
    Move a drawing table segment to new screen coordinates with the function ProDwgtableSegMove(). Pass the coordinates of the target position in format x, y, z=0 to this the function. It moves the table segment to the target position.
    Determine the number of segments in a table with the function ProDwgtableSegCount(). Pass the name of the table to the function and it returns the number of table segments.
    Use the function ProDwgtableSegSheetGet() to determine which sheet contains a specified drawing table segment.
    Use the function ProDwgtableSegmentOriginSet() to assign the origin for a specified drawing table segment.
    Repeat Regions
    Functions Introduced:
  • ProDwgtableCellComponentGet()
    		•
  • ProDwgtableCellRefmodelGet()
    		•
  • ProDrawingTablesUpdate()
    		•
    Superseded Functions
  • ProDwgtableCellIsComment()
    		•
    The functions ProDwgtableCellIsComment(), ProDwgtableCellComponentGet(), ProDwgtableCellRefmodelGet(), and ProDrawingTablesUpdate() apply to repeat regions in drawing tables.
    ProDwgtableCellIsComment() indicates whether a cell in a repeat region contains a comment. ProDwgtableCellIsComment() is deprecated. Use the function ProTableCellIsComment() instead.
    ProDwgtableCellComponentGet() returns the full path to the component referenced in a cell in a repeat region of a drawing table. However, this function does not return a valid path if the cell has the attribute NO DUPLICATE or NO DUPLICATE/LEVEL since there is no unique path available. In this case, use ProDwgtableCellRefmodelGet() to return the reference assembly and component referred to by the cell in a repeat region. This function differs fromProDwgtableCellComponentGet() such that it returns reference objects, even if the cell attribute is set to NO DUPLICATE or NO DUPLICATE/LEVEL.
    The function ProDrawingTablesUpdate() updates repeat regions in all tables to account for changes to the model or models. It is equivalent to the Creo Parametric command Table,Repeat Region, or Update. The drawing must be displayed in the current window.
    Note
    You must call the function ProMdlDisplay() to display the drawing before using the function ProDrawingTablesUpdate().