Drawing Table Segments
Functions Introduced:
Superseded Functions:
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.
The function
ProDwgtableSegMove() will be deprecated in a future release of
Creo. Use the function
ProTableSegMove() instead.
This function moves a table segment and optionally displays it in the new position. The input arguments are as follows:
• p_table—Specifies the table of the ProTable object that contains the segment to move.
• segment—Specifies the ID of the segment to move. Pass PRO_VALUE_UNUSED for a single segment table.
• new_pos—Specifies the new origin position for the table of an object as a ProVector object.
◦ For drawing tables, use world units.
◦ For model tables on a regular annotation plane, use model units with values relative to the model coordinate system.
◦ For flat to screen table, use screen coordinates with values set to 1000 x 843.
• display— Specifies the enumerated ProBoolean value that determines whether to show the table in the new 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.
The function
ProDwgtableSegCount() will be deprecated in a future release of
Creo. Use the function
ProTableSegCount() instead. It determines the number of segments in a table. 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.
The function
ProDwgtableSegSheetGet() will be deprecated in a future release of
Creo. Use the function
ProTableSegSheetGet() instead. It determines which sheet contains a specified table segment. Pass the name of the table and segment ID to the function.
Use the function
ProDwgtableSegCharheightGet() to determine the default character height for a drawing table segment, in world units.
Use the function
ProDwgtableSegCharheightSet() to change the default character height for a drawing table segment to a new value in world units.
Use the function
ProDwgtableCharheightGet() to determine the default character height for the table as a whole, which is not used directly in text, but instead will be the default character height for any newly created segment.
Use the function
ProDwgtableCharheightSet() to change the default character height for the table as a whole, to be used in any newly created segment.
Use the function
ProDwgtableSegmentOriginSet() to assign the origin for a specified drawing table segment.
Use the function
ProTableSegExtentsGet() to retrieve the starting and ending rows and columns of a particular table segment. The input arguments are as follows:
• p_table—Specifies the table of the ProTable object.
• segment_id—Specifies the ID of the segment. Pass PRO_VALUE_UNUSED for a single segment table.
The output arguments are as follows:
• first_row—Specifies the first row in the table segment. Pass NULL if you do not need this value.
• last_row—Specifies the last row in the table segment. Pass NULL if you do not need this value.
• first_column—Specifies the first column in the table segment. Pass NULL if you do not need this value.
• last_column—Specifies the last column in the table segment. Pass NULL if you do not need this value.
|
Note:
|
Row and column numbers range from 1 to the total number of rows and columns in the table.
|