set_drawing_object_paramsT_set_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParams (Operator)

Name

set_drawing_object_paramsT_set_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParams — Set the parameters of a drawing object.

Signature

set_drawing_object_params( : : DrawID, GenParamName, GenParamValue : )

Herror T_set_drawing_object_params(const Htuple DrawID, const Htuple GenParamName, const Htuple GenParamValue)

void SetDrawingObjectParams(const HTuple& DrawID, const HTuple& GenParamName, const HTuple& GenParamValue)

void HDrawingObject::SetDrawingObjectParams(const HTuple& GenParamName, const HTuple& GenParamValue) const

void HDrawingObject::SetDrawingObjectParams(const HString& GenParamName, double GenParamValue) const

void HDrawingObject::SetDrawingObjectParams(const char* GenParamName, double GenParamValue) const

void HDrawingObject::SetDrawingObjectParams(const wchar_t* GenParamName, double GenParamValue) const   (Windows only)

static void HOperatorSet.SetDrawingObjectParams(HTuple drawID, HTuple genParamName, HTuple genParamValue)

void HDrawingObject.SetDrawingObjectParams(HTuple genParamName, HTuple genParamValue)

void HDrawingObject.SetDrawingObjectParams(string genParamName, double genParamValue)

Description

set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParamsSetDrawingObjectParams is used to set the parameters GenParamNameGenParamNameGenParamNameGenParamNamegenParamName of the drawing object DrawIDDrawIDDrawIDDrawIDdrawID to the values specified in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue.

Depending on the type of the drawing object the following parameters can be set for the different types of drawing object:

circle:

'row'"row""row""row""row": Row coordinate of the center of the circle.

'column'"column""column""column""column": Column coordinate of the center of the circle.

'radius'"radius""radius""radius""radius": Radius of the circle.

circle_sector:

'row'"row""row""row""row": Row coordinate of the center.

'column'"column""column""column""column": Column coordinate of the center.

'radius'"radius""radius""radius""radius": Radius of the circle.

'start_angle'"start_angle""start_angle""start_angle""start_angle": Start angle of the circle arc.

'end_angle'"end_angle""end_angle""end_angle""end_angle": End angle of the circle arc.

ellipse:

'row'"row""row""row""row": Row coordinate of the center of the ellipse.

'column'"column""column""column""column": Column coordinate of the center of the ellipse.

'phi'"phi""phi""phi""phi": Orientation of the first half axis in radians.

'radius1'"radius1""radius1""radius1""radius1": Length of the first half axis.

'radius2'"radius2""radius2""radius2""radius2": Length of the second half axis.

ellipse_sector:

'row'"row""row""row""row": Row coordinate of the center of the ellipse sector.

'column'"column""column""column""column": Column coordinate of the center of the ellipse sector.

'phi'"phi""phi""phi""phi": Orientation of the first half axis in radians.

'radius1'"radius1""radius1""radius1""radius1": Length of the first half axis.

'radius2'"radius2""radius2""radius2""radius2": Length of the second half axis.

'start_angle'"start_angle""start_angle""start_angle""start_angle": Starting angle of the ellipse arc.

'end_angle'"end_angle""end_angle""end_angle""end_angle": End angle of the ellipse arc.

rectangle1:

'row1'"row1""row1""row1""row1": Row coordinate of the upper left corner.

'column1'"column1""column1""column1""column1": Column coordinate of the upper left corner.

'row2'"row2""row2""row2""row2": Row coordinate of the lower right corner.

'column2'"column2""column2""column2""column2": Column coordinate of the lower right corner.

rectangle2:

'row'"row""row""row""row": Row coordinate of the center of the rectangle.

'column'"column""column""column""column": Column coordinate of the center of the rectangle.

'phi'"phi""phi""phi""phi": Orientation of the first half axis in radians.

'length1'"length1""length1""length1""length1": Length of the first half axis.

'length2'"length2""length2""length2""length2": Length of the second half axis.

line:

'row1'"row1""row1""row1""row1": Row coordinate of the first line point.

'column1'"column1""column1""column1""column1": Column coordinate of the first line point.

'row2'"row2""row2""row2""row2": Row coordinate of the second line point.

'column2'"column2""column2""column2""column2": Column coordinate of the second line point.

xld:

'row'"row""row""row""row": Row coordinates of the contour points.

'column'"column""column""column""column": Column coordinates of the contour points.

It is possible to either set only the row or column coordinates of the contour points, or both at the same time. In the first case, the number of elements in the input tuple must be the same as the number of points in the contour. In the second case, all existing contour points are discarded and replaced by new ones. The new coordinates are specified in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue in the following order: [Row_0, Row_1, ..., Row_n, Column_0, Column_1, ... Column_n].

text:

'row'"row""row""row""row": Row coordinate of the text position.

'column'"column""column""column""column": Column coordinate of the text position.

'string'"string""string""string""string": Text string to be displayed.

In addition, there is an additional number of attributes that model the appearance of the drawing object in the window it is attached to. Depending on the type of the drawing object the following attributes can be set.

If more than one parameter shall be set, they have to be passed as a tuple in GenParamNameGenParamNameGenParamNameGenParamNamegenParamName containing the name of the parameters. The corresponding values have to be passed as a tuple in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue.

If the drawing object is currently attached to a window, this window is redrawn for each call of set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParamsSetDrawingObjectParams.

Execution Information

Parameters

DrawIDDrawIDDrawIDDrawIDdrawID (input_control)  drawing_object HDrawingObject, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the drawing object.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  attribute.name(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Parameter names of the drawing object.

List of values: 'color'"color""color""color""color", 'column'"column""column""column""column", 'column1'"column1""column1""column1""column1", 'column2'"column2""column2""column2""column2", 'end_angle'"end_angle""end_angle""end_angle""end_angle", 'font'"font""font""font""font", 'length1'"length1""length1""length1""length1", 'length2'"length2""length2""length2""length2", 'line_style'"line_style""line_style""line_style""line_style", 'line_width'"line_width""line_width""line_width""line_width", 'phi'"phi""phi""phi""phi", 'radius'"radius""radius""radius""radius", 'radius1'"radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2", 'row'"row""row""row""row", 'row1'"row1""row1""row1""row1", 'row2'"row2""row2""row2""row2", 'start_angle'"start_angle""start_angle""start_angle""start_angle", 'string'"string""string""string""string"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control)  attribute.name(-array) HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Parameter values.

Result

set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParamsSetDrawingObjectParams returns 2 (H_MSG_TRUE), if the DrawIDDrawIDDrawIDDrawIDdrawID is valid, and the pairs of names and values of the tuples GenParamNameGenParamNameGenParamNameGenParamNamegenParamName and GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue are coherent with the corresponding drawing object type. Otherwise an exception is raised.

Possible Predecessors

create_drawing_object_rectangle1create_drawing_object_rectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1, create_drawing_object_rectangle2create_drawing_object_rectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2, create_drawing_object_ellipsecreate_drawing_object_ellipseCreateDrawingObjectEllipseCreateDrawingObjectEllipseCreateDrawingObjectEllipse, create_drawing_object_circlecreate_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircleCreateDrawingObjectCircle, create_drawing_object_linecreate_drawing_object_lineCreateDrawingObjectLineCreateDrawingObjectLineCreateDrawingObjectLine, create_drawing_object_ellipse_sectorcreate_drawing_object_ellipse_sectorCreateDrawingObjectEllipseSectorCreateDrawingObjectEllipseSectorCreateDrawingObjectEllipseSector, create_drawing_object_circle_sectorcreate_drawing_object_circle_sectorCreateDrawingObjectCircleSectorCreateDrawingObjectCircleSectorCreateDrawingObjectCircleSector, create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXldCreateDrawingObjectXld, attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindow

Possible Successors

get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParamsGetDrawingObjectParams, attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindow, get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconicGetDrawingObjectIconic

See also

attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindow, get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconicGetDrawingObjectIconic, set_drawing_object_callbackset_drawing_object_callbackSetDrawingObjectCallbackSetDrawingObjectCallbackSetDrawingObjectCallback

Module

Foundation