set_drawing_object_paramsT_set_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParamsset_drawing_object_params (Operator)
Name
set_drawing_object_paramsT_set_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParamsset_drawing_object_params — Setzen der Parameterwerte eines Zeichenobjekts.
Signatur
Beschreibung
set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParamsSetDrawingObjectParamsset_drawing_object_params setzt die Parameter GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name
des Zeichenobjekts DrawIDDrawIDDrawIDDrawIDdrawIDdraw_id auf die Werte in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value.
Je nach Typ des Zeichenobjekts können folgende Parameter gesetzt werden:
- circle:
-
'row'"row""row""row""row""row": Zeilenkoordinate des Mittelpunkts.
'column'"column""column""column""column""column": Spaltenkoordinate des Mittelpunkts.
'radius'"radius""radius""radius""radius""radius": Radius des Kreises.
- circle_sector:
-
'row'"row""row""row""row""row": Zeilenkoordinate des Mittelpunkts.
'column'"column""column""column""column""column": Spaltenkoordinate des Mittelpunkts.
'radius'"radius""radius""radius""radius""radius": Radius des Kreissektors.
'start_angle'"start_angle""start_angle""start_angle""start_angle""start_angle": Anfangswinkel des Kreisbogens.
'end_angle'"end_angle""end_angle""end_angle""end_angle""end_angle": Endwinkel des Kreisbogens.
- ellipse:
-
'row'"row""row""row""row""row": Zeilenkoordinate des Mittelpunkts.
'column'"column""column""column""column""column": Spaltenkoordinate des Mittelpunkts.
'phi'"phi""phi""phi""phi""phi": Orientierung der ersten Halbachse im Bogenmaß.
'radius1'"radius1""radius1""radius1""radius1""radius1": Länge der ersten Halbachse der Ellipse.
'radius2'"radius2""radius2""radius2""radius2""radius2": Länge der zweiten Halbachse der Ellipse.
- ellipse_sector:
-
'row'"row""row""row""row""row": Zeilenkoordinate des Mittelpunkts.
'column'"column""column""column""column""column": Spaltenkoordinate des Mittelpunkts.
'phi'"phi""phi""phi""phi""phi": Orientierung der ersten Halbachse im Bogenmaß.
'radius1'"radius1""radius1""radius1""radius1""radius1": Länge der ersten Halbachse.
'radius2'"radius2""radius2""radius2""radius2""radius2": Länge der zweiten Halbachse.
'start_angle'"start_angle""start_angle""start_angle""start_angle""start_angle": Anfangswinkel des Ellipsenbogens.
'end_angle'"end_angle""end_angle""end_angle""end_angle""end_angle": Endwinkel des Ellipsenbogens.
- rectangle1:
-
'row1'"row1""row1""row1""row1""row1": Zeilenkoordinate des linken oberen Eckpunkts.
'column1'"column1""column1""column1""column1""column1": Spaltenkoordinate des linken oberen Eckpunkts.
'row2'"row2""row2""row2""row2""row2": Zeilenkoordinate des rechten oberen Eckpunkts.
'column2'"column2""column2""column2""column2""column2": Spaltenkoordinate des rechten oberen Eckpunkts.
- rectangle2:
-
'row'"row""row""row""row""row": Zeilenkoordinate des Mittelpunkts des Rechtecks.
'column'"column""column""column""column""column": Spaltenkoordinate des Mittelpunkts des Rechtecks.
'phi'"phi""phi""phi""phi""phi": Orientierung der ersten Halbachse im Bogenmaß.
'length1'"length1""length1""length1""length1""length1": Länge der ersten Halbachse.
'length2'"length2""length2""length2""length2""length2": Länge der zweiten Halbachse.
- line:
-
'row1'"row1""row1""row1""row1""row1": Zeilenkoordinate des ersten Linienpunkts.
'column1'"column1""column1""column1""column1""column1": Spaltenkoordinate des ersten Linienpunkts.
'row2'"row2""row2""row2""row2""row2": Zeilenkoordinate des zweiten Linienpunkts.
'column2'"column2""column2""column2""column2""column2": Spaltenkoordinate des zweiten Linienpunkts.
- xld:
-
'row'"row""row""row""row""row": Zeilenkoordinaten der Konturpunkte.
'column'"column""column""column""column""column": Spaltenkoordinaten der Konturpunkte.
Es ist möglich, entweder nur die Zeilen- oder Spaltenkoordinaten
zu setzen oder beide zur gleichen Zeit. Im ersten Fall muss die
Anzahl der Werte in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value der Anzahl der vorhandenen
Konturpunkte entsprechen. Im zweiten Fall werden alle vorhandenen
Konturpunkte verworfen und durch neue ersetzt. Die neuen Koordinaten
werden in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value in folgender Reihenfolge übergeben:
[Row_0, Row_1, ..., Row_n, Column_0, Column_1, ... Column_n].
- text:
-
'row'"row""row""row""row""row": Zeilenkoordinate der Textposition.
'column'"column""column""column""column""column": Spaltenkoordinate der Textposition.
'string'"string""string""string""string""string": Textstring, der angezeigt wird.
Es gibt zusätzliche Attribute, die das Aussehen des Zeichenobjekts modellieren.
Je nach Typ des Zeichenobjekts können die folgenden Attribute gesetzt werden:
-
Zeichenobjekte vom Typ 'text':
- 'color'"color""color""color""color""color":
-
Setzt die Farbe eines Text-Zeichenobjekts. Die Farbe kann entweder mit ihrem
Namen angegeben werden, z.B. 'green', oder als RGB Wert, z.B. '#ffb529'.
Siehe set_colorset_colorSetColorSetColorSetColorset_color für mehr Informationen.
- 'font'"font""font""font""font""font":
Setzt den Font eines Text-Zeichenobjekts. Eine Liste aller verfügbaren Fonts
kann mit dem Operator query_fontquery_fontQueryFontQueryFontQueryFontquery_font abgerufen werden.
Siehe set_fontset_fontSetFontSetFontSetFontset_font für mehr Informationen.
-
Zeichenobjekte vom Typ 'circle', 'circle_sector', 'ellipse', 'ellipse_sector', 'rectangle1', 'rectangle1', 'xld', 'line':
- 'color'"color""color""color""color""color":
-
Setzt die Farbe eines Text-Zeichenobjekts. Die Farbe kann entweder mit ihrem
Namen, z.B. 'green', angegeben werden, oder als RGB Wert, z.B. '#ffb529'.
Siehe set_colorset_colorSetColorSetColorSetColorset_color für mehr Informationen.
- 'line_style'"line_style""line_style""line_style""line_style""line_style":
-
Setzt den Linienstil des Zeichenobjekts. Dieses Attribut benötigt
mindestens zwei Attributwerte in Form eines Tupels.
mindestens zwei Attributwerte in Form eines Tupels.
Der erste Wert definiert die Länge des sichtbaren Linienstücks und
der zweite Wert definiert die Länge des nicht sichtbaren
Linienstücks. Siehe set_line_styleset_line_styleSetLineStyleSetLineStyleSetLineStyleset_line_style für mehr Details.
Da die Länge des Eingabetupels variieren kann, darf 'line_style'"line_style""line_style""line_style""line_style""line_style"
nicht mit anderen Parametern oder Attributen in einem Aufruf
kombiniert werden. Ansonsten wird eine Fehlerbehandlung durchgeführt.
- 'line_width'"line_width""line_width""line_width""line_width""line_width":
-
Setzt die Linienbreite des Zeichenobjekts in Pixel.
Siehe set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidthset_line_width für mehr Informationen.
Wenn mehr als ein Parameter gesetzt werden soll, müssen diese als
Tupel in GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value übergeben werden.
Wenn das Zeichenobjekt aktuell an ein Fenster gehängt ist, wird dieses
beim Aufruf von set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParamsSetDrawingObjectParamsset_drawing_object_params aktualisiert.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
DrawIDDrawIDDrawIDDrawIDdrawIDdraw_id (input_control) drawing_object → HDrawingObject, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Zeichenobjekts.
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Namen der Parameter des Zeichenobjekts.
Werteliste: 'color'"color""color""color""color""color", 'column'"column""column""column""column""column", 'column1'"column1""column1""column1""column1""column1", 'column2'"column2""column2""column2""column2""column2", 'end_angle'"end_angle""end_angle""end_angle""end_angle""end_angle", 'font'"font""font""font""font""font", 'length1'"length1""length1""length1""length1""length1", 'length2'"length2""length2""length2""length2""length2", 'line_style'"line_style""line_style""line_style""line_style""line_style", 'line_width'"line_width""line_width""line_width""line_width""line_width", 'phi'"phi""phi""phi""phi""phi", 'radius'"radius""radius""radius""radius""radius", 'radius1'"radius1""radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2""radius2", 'row'"row""row""row""row""row", 'row1'"row1""row1""row1""row1""row1", 'row2'"row2""row2""row2""row2""row2", 'start_angle'"start_angle""start_angle""start_angle""start_angle""start_angle", 'string'"string""string""string""string""string"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control) attribute.name(-array) → HTupleMaybeSequence[Union[float, int, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Werte der Parameter.
Ergebnis
get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParamsGetDrawingObjectParamsget_drawing_object_params gibt 2 (H_MSG_TRUE) zurück, falls die DrawIDDrawIDDrawIDDrawIDdrawIDdraw_id,
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value gültig sind.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
create_drawing_object_rectangle1create_drawing_object_rectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1create_drawing_object_rectangle1,
create_drawing_object_rectangle2create_drawing_object_rectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2create_drawing_object_rectangle2,
create_drawing_object_ellipsecreate_drawing_object_ellipseCreateDrawingObjectEllipseCreateDrawingObjectEllipseCreateDrawingObjectEllipsecreate_drawing_object_ellipse,
create_drawing_object_circlecreate_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircleCreateDrawingObjectCirclecreate_drawing_object_circle,
create_drawing_object_linecreate_drawing_object_lineCreateDrawingObjectLineCreateDrawingObjectLineCreateDrawingObjectLinecreate_drawing_object_line,
create_drawing_object_ellipse_sectorcreate_drawing_object_ellipse_sectorCreateDrawingObjectEllipseSectorCreateDrawingObjectEllipseSectorCreateDrawingObjectEllipseSectorcreate_drawing_object_ellipse_sector,
create_drawing_object_circle_sectorcreate_drawing_object_circle_sectorCreateDrawingObjectCircleSectorCreateDrawingObjectCircleSectorCreateDrawingObjectCircleSectorcreate_drawing_object_circle_sector,
create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXldCreateDrawingObjectXldcreate_drawing_object_xld,
attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindowattach_drawing_object_to_window
Nachfolger
get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParamsGetDrawingObjectParamsget_drawing_object_params,
attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindowattach_drawing_object_to_window,
get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconicGetDrawingObjectIconicget_drawing_object_iconic
Siehe auch
attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindowattach_drawing_object_to_window,
get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconicGetDrawingObjectIconicget_drawing_object_iconic,
set_drawing_object_callbackset_drawing_object_callbackSetDrawingObjectCallbackSetDrawingObjectCallbackSetDrawingObjectCallbackset_drawing_object_callback
Modul
Foundation