set_iconset_iconSetIconSetIcon (Operator)

Name

set_iconset_iconSetIconSetIcon — Setzen eines Icons für die Regionenausgabe.

set_iconset_iconSetIconSetIconSetIcon setzt ein Icon, das bei der Ausgabe von Regionen (disp_regiondisp_regionDispRegionDispRegionDispRegion) im Schwerpunkt der Region dargestellt werden soll. Die Verwendung dieses Icons wird durch set_shapeset_shapeSetShapeSetShapeSetShape aktiviert.

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

IconIconIconIconicon (input_object) region → object

Icon für Schwerpunkt.

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control) window → (integer)

Fenster-Handle.

Beispiel (C)

/* draw a region and an icon */
draw_region(&Region,WindowHandle) ;
draw_region(&Icon,WindowHandle) ;
set_icon(Icon) ;
set_shape(WindowHandle,"icon") ;
disp_region(Region,WindowHandle) ;

Ergebnis

set_iconset_iconSetIconSetIconSetIcon liefert den Wert 2 (H_MSG_TRUE), falls genau eine Region übergeben wird. Ansonsten wird eine Fehlerbehandlung durchgeführt