RexxDW is an external function package that allows a Rexx programmer to write cross platform GUI applications, using a lightweight portable GUI API called Dynamic Windows (dwindows). The fundamental building blocks of a RexxDW program consist of two major components; widgets and event handlers or callbacks. Various widgets are packed into the required layout and events are connected to the widgets to carry out the required behaviour. The structure of a RexxDW program consists of various initialisation; creation of the widgets, packing them, connecting callbacks, and then calling the event loop handler to dispatch the event to the appropriate callbacks. The callbacks are normal Rexx subroutines. There are two event loop handlers depending on whether your Rexx interpreter supports the RexxCallback() API. DW_main() is used for interpreters that have RexxCallback(); DW_main_iteration() is used for those interpretes that don't. All of the functions in RexxDW are based on the same function in dwindows. Some function arguments will differ due to the nature of the Rexx API interface. The format of the function names is dw_(target)_(action)[_(options)]. eg. for tree widgets, functions act on both the tree itself and the tree items within the tree widget, so DW_tree_new() executes the "new" action on the tree widget, DW_tree_item_change() executes the "change" action on the tree item, not the tree. Some dwindows functions are not available in RexxDW, mainly because they are not able to be implemented: dw_icon_load, etc... A number of functions have been added to RexxDW that are not part of dwindows: dw_and, dw_or, dw_radiobutton_set, dw_radiobutton_get,... document dw_exec()?? add DW_container_get_column_type and DW_filesystem_get_column_type can dw_window_maximize() be implemented as dw_window_set_style() with MAXIMIZE attribute set and MINIMIZE attribute unset? no VALUE_CHANGE callback on spinbutton widget document that KEY_PRESS needs to be trapped in toplevel window but BUTTON_PRESS in low-level window (confirm on all platforms) bug in (Windows at least) item_select callback on container. Seems that the callback gets called twice irrespective of whether 0 or 1 is returned from the callback. bug (Windows) with drawing directly to a render window (ie not via a pixmap) (see rexxdw.rexx, Utility TAB) bug dw_listbox_selected() is supposed to return DW_LIT_NONE (-1) but dw_listbox_selected() returns unsigned int Under GTK+ 2.0 or greater, a call to dw_window_set_font() causes an expose event to fire. If dw_window_set_font() is called within the expose callback, you get an infinite loop. Bit of a bugger if your expose event sets different fonts for different lines!!! RexxDW runs on Windows 9x/Me/NT/2k/XP, OS/2 3.0+ and on any Un*x platform that has GTK+ 1.x installed (but works better with GTK+ 2.x). RexxDW lives at href:http://rexxdw.sf.net Dynamic Windows lives at href:http://dwindows.netlabs.org

The following "constants" are defined when RexxDW starts. By default, all constants are stored in an array with the stem preset to !REXXDW.! This can be changed by using the 'CONSTANTPREFIX' value of DW_variable(). If you use "Procedure" on your labels, you MUST "EXPOSE !REXXDW." or the stem you set with DW_variable() will not be visible. To reference the constants defined below, you must prefix them. So the "constant" DW_DESKTOP would be, by default, referenced in your code as !REXXDW.!DW_DESKTOP. DW_variable

MiscellaneousFlags The following is a list of miscellaneous flags. GTK_MAJOR_VERSION - 0 if NOT GTK+ platform, 1 for GTK+ 1.x, 2 for GTK+ 2.x HAVE_REXXCALLBACK - 1 if the interpreter supports RexxCallback() API DW_DESKTOP - the psuedo "window" which is the desktop DIRSEP - the Operating System directory separator PATHSEP - the Operating System path separator

FileDialogFlags The following is a list of the pre-defined flags that are used in a call to DW_file_browse() to determine the dialog type displayted. DW_DIRECTORY_OPEN - a directory selector dialog DW_FILE_OPEN - a file open dialog DW_FILE_SAVE - a file save dialog DW_file_browse

ContainerScrollFlags The following is a list of the pre-defined flags that are used in a call to DW_container_scroll() to indicate the direction of scrolling. DW_SCROLL_UP - scroll up a number of lines DW_SCROLL_DOWN - scroll down a number of lines DW_SCROLL_TOP - scroll to the top of the container DW_SCROLL_BOTTOM - scroll to the bottom of the container DW_container_scroll

TextAttributeFlags The following is a list of the pre-defined flags that are used in a call to DW_window_set_style() to specify the formatting of text within a widget. The following work on all platforms: - DW_DT_LEFT - text is left-aligned - DW_DT_RIGHT - text is right-aligned - DW_DT_CENTER - text is centered - DW_DT_VCENTER - text is centered vertically The following attributes only have an effect on OS/2: - DW_DT_QUERYEXTENT - DW_DT_UNDERSCORE - DW_DT_STRIKEOUT - DW_DT_TEXTATTRS - DW_DT_EXTERNALLEADING - DW_DT_TOP - DW_DT_BOTTOM - DW_DT_HALFTONE - DW_DT_MNEMONIC - DW_DT_WORDBREAK - DW_DT_ERASERECT DW_window_set_style

WindowStyleFlags The following is a list of the pre-defined flags that can be used when creating a new window. Any number of values from "Style Types" can be used plus optionally one value from "Initial State Types" are logically "or"ed together using DW_or(). Style Types: - DW_FCF_TITLEBAR - display titlebar - DW_FCF_SYSMENU - DW_FCF_MENU - DW_FCF_SIZEBORDER - DW_FCF_MINBUTTON - display minimise button - DW_FCF_MAXBUTTON - display maximise button - DW_FCF_MINMAX - DW_FCF_VERTSCROLL - DW_FCF_HORZSCROLL - DW_FCF_DLGBORDER - DW_FCF_BORDER - DW_FCF_SHELLPOSITION - DW_FCF_TASKLIST - DW_FCF_NOBYTEALIGN - DW_FCF_NOMOVEWITHOWNER - DW_FCF_SYSMODAL - DW_FCF_HIDEBUTTON - DW_FCF_HIDEMAX - DW_FCF_AUTOICON Initial State Types: - DW_FCF_MAXIMIZE - start maximised - DW_FCF_MINIMIZE - start minimised DW_window_new

ContainerColumnFlags The following is a list of the pre-defined flags that can be used when creating a container widget. When used in DW_container_setup() or DW_filesystem_setup(), one value from "Column Types", one value from "Alignment" and any value from "Separators" are logically "or"ed together using DW_or(). Column Types: - DW_CFA_BITMAPORICON - the column contains an image - DW_CFA_STRING - the column contains an unstructured string - DW_CFA_ULONG - the column contains an integer - DW_CFA_TIME - the column contains a time in the format Time('N') - DW_CFA_DATE - the column contains a date in the format Date('S') - DW_CFA_STRINGANDICON - the column contains a string and an image (not implemented) Alignment: - DW_CFA_CENTER - the column is centered - DW_CFA_LEFT - the column is left aligned - DW_CFA_RIGHT - the column is right aligned Separators (not applicable on all platforms): - DW_CFA_HORZSEPARATOR - the column has a cell border on the top and bottom - DW_CFA_SEPARATOR - the column has a cell border on the left and right DW_container_setup, DW_filesystem_setup

ContainerQueryFlags The following is a list of the pre-defined flags that can be used when querying a container widget. DW_CRA_ALL - all rows are queried DW_CRA_SELECTED - only rows selected are queried DW_CRA_CURSORED - only the row(s) currently have focus; ie. highlighted DW_container_query_start, DW_container_query_next

MLESearchFlags The following is a list of the pre-defined flags that can be used in the SearchFlags argument in DW_mle_search(). DW_MLE_CASESENSITIVE - search done respecting case DW_mle_search

MLEEditableFlags The following is a list of the pre-defined flags that can be used in the EditableFlags argument in DW_mle_set_editable(). DW_EDITABLE - MLE is editable DW_READONLY - MLE is not editable; ie readonly DW_mle_set_editable

MLEWordWrapFlags The following is a list of the pre-defined flags that can be used in the WordWrapFlags argument in DW_mle_set_word_wrap(). DW_WORD_WRAP - words are wrapped in the MLE DW_DONT_WORD_WRAP - no word wrapping occurs in the MLE DW_mle_set_word_wrap

PointerTypes The following is a list of the pre-defined mouse pointer types used in the Pointer argument in DW_window-set_pointer(). DW_POINTER_DEFAULT - the default pointer shape DW_POINTER_CLOCK - a clock pointer DW_POINTER_ARROW - an arrow pointing to the top left DW_window_set_pointer

Colours The following is a list of the pre-defined colours known to RexxDW. These colour constants are used in functions that require pre-defined colours. DW_CLR_BLACK DW_CLR_DARKRED DW_CLR_DARKGREEN DW_CLR_BROWN DW_CLR_DARKBLUE DW_CLR_DARKPINK DW_CLR_DARKCYAN DW_CLR_PALEGRAY DW_CLR_DARKGRAY DW_CLR_RED DW_CLR_GREEN DW_CLR_YELLOW DW_CLR_BLUE DW_CLR_PINK DW_CLR_CYAN DW_CLR_WHITE DW_CLR_DEFAULT DW_color_background_set, DW_color_foreground_set, DW_color_choose

WidgetOrientation The following constants are used in widgets that require an orientation to be specified. DW_VERT - vertical orientation DW_HORZ - horizontal orientation DW_box_new, DW_groupbox_new, DW_splitbar_new, DW_scrollbar_new

NotebookTabLocation The following constants are used in the TabLocation argument in a call to DW_notebook_new() to specify whether notebook tabs are located at the top or bottom of the window. DW_TAB_TO_TOP - notebook tabs are displayed across the top DW_TAB_TO_BOTTOM - notebook tabs are displayed across the bottom DW_notebook_new

NotebookPageLocation The following constants are used in the PageLocation argument in a call to DW_notebook_page_new() to specify if the page is created in front or behind other pages. DW_PAGE_TO_FRONT - page is created in front of other pages DW_PAGE_TO_BACK - page is created behind other pages DW_notebook_page_new

MenuConstants The following constants are used in a number of menu related function calls. DW_MENU_START - add the item at the start of the menu items DW_MENU_END - add the item at the end of the menu items DW_MENU_CHECKABLE - the menu item is checkable DW_MENU_NOT_CHECKABLE - the menu item is not checkable DW_MENU_SEPARATOR - the string to indicate the menu item is a separator DW_menu_append_item, DW_menu_item_set_check

BoxExpansionFlags The following constants are used in the box packing functions to specify whether the box expand in a horizontal or vertical direction. DW_EXPAND_HORZ - expand the box horizontally DW_DONT_EXPAND_HORZ - don't expand the box horizontal DW_EXPAND_VERT - expand the box vertically DW_DONT_EXPAND_VERT - don't expand the box vertically DW_box_pack_start, DW_box_pack_end

ListboxSelection The following constants are used in the Selection argument to a call to DW_listbox_new(). DW_LB_SINGLE_SELECTION - indicates that only 1 row in the listbox is selectable DW_LB_MULTIPLE_SELECTION - indicates that multiple rows in the listbox are selectable DW_listbox_new

ListboxSelected The following is a list of the pre-defined flags that can be used when setting the State of a listbox or combobox. DW_LB_SELECTED - set the item to be selected DW_LB_UNSELECTED - set the item to NOT be selected DW_listbox_select

ListboxReturn The following is the return value from DW_listbox_selected() or DW_listbox_selected_multi() if no item in the listbox has been selected. DW_LB_NONE - no listbox item selected DW_listbox_selected(), DW_listbox_selected_multi()

WidgetChecked The following constants are used to indicate the state of a widget that can have a boolean state. DW_CHECKED - widget is "on" or set DW_UNCHECKED - widget is "off" or unset DW_checkbox_set, DW_radiobutton_set

ContainerClearFlags The following constants are used in the Redraw argument to a call to DW_container_clear(). DW_REDRAW - redraw the cleared container DW_DONT_REDRAW - don't redraw the cleared container DW_container_new

ContainerSelection The following constants are used in the Selection argument to a call to DW_container_new(). DW_SINGLE_SELECTION - indicates that only 1 row in the container is selectable DW_MULTIPLE_SELECTION - indicates that multiple rows in the container are selectable DW_container_new

RectangleFill The following constants are used in the Fill argument to a call to DW_draw_rect(). DW_FILL - draws a filled rectangle DW_DONT_FILL - draws an outline rectangle 1 pixel in width DW_draw_rect

MessageboxFlags The following constants are used in the Flags argument to a call to DW_messagebox(). Logically "or" one value from Buttons and one value from Icons Buttons: - DW_MB_OK - DW_MB_OKCANCEL - DW_MB_YESNO - DW_MB_YESNOCANCEL Icons: - DW_MB_WARNING - DW_MB_ERROR - DW_MB_INFORMATION - DW_MB_QUESTION DW_messagebox

MessageboxResults The following constants are returned from a call to DW_messagebox(). DW_MB_RETURN_OK DW_MB_RETURN_YES DW_MB_RETURN_NO DW_MB_RETURN_CANCEL DW_messagebox

VirtualKeys The following is a list of the mnemonic key values known to RexxDW. These keys are returned in a KeyPressEvent Callback, in the VirtualKey argument. DW_VK_CANCEL DW_VK_BACK DW_VK_TAB DW_VK_CLEAR DW_VK_RETURN DW_VK_MENU DW_VK_PAUSE DW_VK_CAPITAL DW_VK_ESCAPE DW_VK_SPACE DW_VK_PRIOR DW_VK_NEXT DW_VK_END DW_VK_HOME DW_VK_LEFT DW_VK_UP DW_VK_RIGHT DW_VK_DOWN DW_VK_SELECT DW_VK_PRINT DW_VK_EXECUTE DW_VK_SNAPSHOT DW_VK_INSERT DW_VK_DELETE DW_VK_HELP DW_VK_LWIN DW_VK_RWIN DW_VK_NUMPAD0 DW_VK_NUMPAD1 DW_VK_NUMPAD2 DW_VK_NUMPAD3 DW_VK_NUMPAD4 DW_VK_NUMPAD5 DW_VK_NUMPAD6 DW_VK_NUMPAD7 DW_VK_NUMPAD8 DW_VK_NUMPAD9 DW_VK_MULTIPLY DW_VK_ADD DW_VK_SEPARATOR DW_VK_SUBTRACT DW_VK_DECIMAL DW_VK_DIVIDE DW_VK_F1 DW_VK_F2 DW_VK_F3 DW_VK_F4 DW_VK_F5 DW_VK_F6 DW_VK_F7 DW_VK_F8 DW_VK_F9 DW_VK_F10 DW_VK_F11 DW_VK_F12 DW_VK_F13 DW_VK_F14 DW_VK_F15 DW_VK_F16 DW_VK_F17 DW_VK_F18 DW_VK_F19 DW_VK_F20 DW_VK_F21 DW_VK_F22 DW_VK_F23 DW_VK_F24 DW_VK_NUMLOCK DW_VK_SCROLL DW_VK_LSHIFT DW_VK_RSHIFT DW_VK_LCONTROL DW_VK_RCONTROL DW_VK_LMENU DW_VK_RMENU KeyPressEventCallback

KeyStates The following is a list of the mnemonic key state values known to Rexx/DW. These keys are returned in a KeyPressEvent Callback, in the KeyState argument. DW_KC_CTRL DW_KC_SHIFT DW_KC_ALT KeyPressEventCallback

MouseButtons The following is a list of the mnemonic mouse button values known to RexxDW. These buttons are returned in a ButtonPressEvent Callback, in the Button argument. DW_VK_LBUTTON DW_VK_RBUTTON DW_VK_MBUTTON ButtonPressEventCallback ButtonReleaseEventCallback

Fontnames Font names in Rexx/DW are platform dependent. This section explains how to specify fonts on each of the supported platforms. Windows: Fonts are specifed in the format: 'size.family [Bold] [Italic]' As an example, the following specify various font specifications for 8 point Courier: fixedfont = '8.Courier' italicfont = '8.Courier Italic' boldfont = '8.Courier Bold' bolditalicfont = '8.Courier Bold Italic' GTK+ 2.x: Fonts are specified in the format: 'family [bold] [italic] size' As an example, the following specify various font specifications for 14 point monospace: fixedfont = 'monospace 14' italicfont = 'monospace italic 14' boldfont = 'monospace bold italic 14' bolditalicfont = 'monospace italic 14' GTK+ 1.x: Fonts are specified using full X11 specification. As an example, the following specify various font specifications for 120 courier: fixedfont = '-adobe-courier-medium-r-normal-*-*-120-*-*-m-*-iso8859-1' italicfont = '-adobe-courier-medium-o-normal-*-*-120-*-*-m-*-iso8859-1' boldfont = '-adobe-courier-bold-r-normal-*-*-120-*-*-m-*-iso8859-1' bolditalicfont = '-adobe-courier-bold-o-normal-*-*-120-*-*-m-*-iso8859-1' OS/2: Fonts are specifed in the format: 'size.family [Bold] [Italic]' As an example, the following specify various font specifications for 5 System VIO: fixedfont = '5.System VIO' italicfont = '5.System VIO Italic' boldfont = '5.System VIO Bold' bolditalicfont = '5.System VIO Bold Italic'

Packing One of the most important aspects of laying out widgets in a Rexx/DW program is how packing works. This section explains the Rexx/DW packing mechanism. The above ?????? TODO - horz/vert boxes, pack empty spaces, expand/dont_expand

Callbacks Rexx/DW is an event driven application. What this means is that internally various events occur, such as a key press, a window becoming exposed. Rexx/DW allows you to call an internal Rexx procedure when various events occur. Each widget you create has certain valid events associated with it. As part of your code you associate a particular event with a widget. This is done by calling DW_signal_connect(). This associates an event on a particular widget with an internal Rexx procedure, so that when the particular event occurs on that widget your procedure is executed and certain parameters are passed to it. Details on what parameters are passed is detailed below depending on the type of event. The internal Rexx procedure is called in the context of where DW_main() or DW_main_iteration() is called. This is important when considering what Rexx variables may or may not be in scope. It is probably better to always use PROCEDURE EXPOSE (myglobals) on procedures so you know that any variables you use within your procedure will not affect an others outside without you explicitly listing them. Once you have handled an event in your code, you can return 1 to inform Dynamic Windows that all processing has been handled for the particular event. Dynamic Windows will not execute its default event handling code. If your event handler returns 0, then Dynamic Windows will execute its default event handling code. The values of the supported events are: REXXDW_CONFIGURE_EVENT_CB REXXDW_KEY_PRESS_EVENT_CB REXXDW_BUTTON_PRESS_EVENT_CB REXXDW_BUTTON_RELEASE_EVENT_CB REXXDW_MOTION_NOTIFY_EVENT_CB REXXDW_DELETE_EVENT_CB REXXDW_EXPOSE_EVENT_CB REXXDW_CLICKED_EVENT_CB REXXDW_ITEM_ENTER_EVENT_CB REXXDW_ITEM_CONTEXT_EVENT_CB REXXDW_LIST_SELECT_EVENT_CB REXXDW_ITEM_SELECT_EVENT_CB REXXDW_SET_FOCUS_EVENT_CB REXXDW_VALUE_CHANGED_EVENT_CB REXXDW_SWITCH_PAGE_EVENT_CB REXXDW_COLUMN_CLICK_EVENT_CB With Rexx interpreters that don't provide RexxCallBack() it is not possible to inform Dynamic Windows to execute the default callback functionality after your event handler has executed its code, because the return value is returned to the Rexx program; via DW_main_iteration(), not to Dynamic Windows.

ConfigureEventCallback rcode = ConfigureEventCallback(Window, Width, Height [,UserData[,...]]) Called when a DW_CONFIGURE_EVENT signal fires on a window. This event usually occurs when a window's size is changed. Window - value of the window handle that has been resized Width - the new width of Window in pixels Height - the new height of Window in pixels UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. ... Call dw_signal_connect window, !REXXDW.!DW_CONFIGURE_EVENT, 'configure_cb', , 'fred', 'mary' ... configure_cb: Procedure Expose !REXXDW. Parse Arg win, width, height, var1, var2 Say 'New width:' width 'height:' height 'for Window:' win 'UserVar1:' var1 , 'UserVar2:' var2 Return 1

KeyPressEventCallback rcode = KeyPressEventCallback(Window, ASCIIKey, VirtualKey, KeyState [,UserData[,...]]) Called when a DW_KEY_PRESS_EVENT signal fires on a window. Occurs when the user presses a key. Window - value of the window handle in which the key was pressed ASCIIKey - the Hex representation of the key pressed. If not as ASCII key then the empty string is returned and VirtualKey should be used VirtualKey - the mnemonic key value of the key pressed KeyState - indicates whether SHIFT, CTRL or ALT modifiers are active UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. VirtualKeys KeyStates ... Call dw_signal_connect window, !REXXDW.!DW_KEY_PRESS_EVENT, 'keypress_cb', , 'fred', 'mary' ... keypress_cb: Procedure Expose !REXXDW. Parse Arg win, ascii, virtual, state, var1, var2 Say 'ASCII Key:' ascii 'Virtual Key:' virtual 'State:' state 'UserVar1:' , var1 'UserVar2:' var2 If virtual = !REXXDW.!DW_VK_F1 Then Return 1 Return 1

ButtonPressEventCallback rcode = ButtonPressEventCallback(Window, X, Y, Button [,UserData[,...]]) Called when a DW_BUTTON_PRESS_EVENT signal fires on a window. This occurs when the user clicks a button with the mouse. Window - value of the window handle in which the mouse button was pressed X - the X coordinate where the mouse button was pressed, relative to the top left corner of the Window Y - the Y coordinate where the mouse button was pressed, relative to the top left corner of the Window Button - which mouse button was pressed UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. MouseButtons ... Call dw_signal_connect window, !REXXDW.!DW_BUTTON_PRESS_EVENT, , 'buttonpress_cb', 'fred' ... buttonpress_cb: Parse Arg win, x, y, button, data Say 'Button:' button 'pressed at:' x'/'y 'in Window:' win Return 1

ButtonReleaseEventCallback rcode = ButtonReleaseEventCallback(Window, X, Y, Button [,UserData[,...]]) Called when a DW_BUTTON_RELEASE_EVENT signal fires on a window. This occurs when the user releases a button on the mouse. Window - value of the window handle in which the mouse button was released X - the X coordinate where the mouse button was released, relative to the top left corner of the Window Y - the Y coordinate where the mouse button was released, relative to the top left corner of the Window Button - which mouse button was released UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. MouseButtons ... Call dw_signal_connect window, !REXXDW.!DW_BUTTON_RELEASE_EVENT, , 'buttonrelease_cb', 'fred' ... buttonreleases_cb: Parse Arg win, x, y, button, data Say 'Button:' button 'released at:' x'/'y 'in Window:' win Return 1

MotionNotifyEventCallback rcode = MotionNotifyEventCallback(Window, X, Y, Button [,UserData[,...]]) Called when a DW_MOTION_NOTIFY_EVENT signal fires on a window. This occurs when the user moves the mouse. Window - value of the window handle in which the mouse button was released X - the X coordinate where the mouse button was released, relative to the top left corner of the Window Y - the Y coordinate where the mouse button was released, relative to the top left corner of the Window State - ????????????????? UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. ButtonPressEventCallback ButtonReleaseEventCallback ... Call dw_signal_connect window, !REXXDW.!DW_MOTION_NOTIFY_EVENT, , 'motionnotify_cb', 'fred' ... motionnotify_cb: Parse Arg win, x, y, state, data Say 'Mouse movied to' x'/'y 'in Window:' win 'with state:' state Return 1

DeleteEventCallback rcode = DeleteEventCallback(Window [,UserData[,...]]) Called when a DW_DELETE_EVENT signal fires on a window. This occurs when the user closes the window by clicking the close icon on the window title bar, or when dw_window_destroy() ???? is called on the window. Window - value of the window handle in which the mouse button was released UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. DW_window_destroy ... Call dw_signal_connect window, !REXXDW.!DW_DELETE_EVENT, 'delete_cb', , 'fred' ... delete_cb: Parse Arg win, data Say 'Window:' win 'deleted' Return 1

ExposeEventCallback rcode = ExposeEventCallback(Window, X, Y, Width, Height [,UserData[,...]]) Called when a DW_EXPOSE_EVENT signal fires on a window. This occurs when the window is exposed. Window - value of the window handle in which the mouse button was released X - the top left X coordinate of the exposed area Y - the top left Y coordinate of the exposed area Width - the width of the exposed area Height - the height of the exposed area UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. ... Call dw_signal_connect window, !REXXDW.!DW_EXPOSE_EVENT, 'expose_cb', , 'fred' ... expose_cb: Parse Arg win, x, y, width, height, data Say 'Window:' win 'exposed at' x'/'y 'size:' width'/'height Return 1

ClickedEventCallback rcode = ClickedEventCallback(Window [,UserData[,...]]) Called when a DW_CLICKED_EVENT signal fires on a window. This occurs when the user clicks in the window; usually a button window. Window - value of the window handle that was clicked UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. ... Call dw_signal_connect window, !REXXDW.!DW_CLICKED_EVENT, 'clicked_cb', , 'fred' ... clicked_cb: Parse Arg win, data Say 'Window:' win 'clicked' Return 1

ItemEnterEventCallback rcode = ItemEnterEventCallback(Window, Text [,UserData[,...]]) Called when a DW_ITEM_ENTER_EVENT signal fires on a window. This occurs when the user double-clicks or presses ENTER key in a container window. Window - value of the window handle that was clicked Text - the string set by a call to DW_container_set_row_title() UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. DW_container_set_row_title ... Call dw_signal_connect window, !REXXDW.!DW_ITEM_ENTER_EVENT, 'itementer_cb', , 'fred' ... itementer_cb: Parse Arg win, text, data Say 'Item text' text 'entered in Window:' win 'userdata:' data Return 1

ItemContextEventCallback rcode = ItemContextEventCallback(Window, Text, X, Y, ItemData [,UserData[,...]]) Called when a DW_ITEM_CONTEXT_EVENT signal fires on a window. This occurs when the user clicks the right mouse button in a container or tree window. Window - value of the window handle that was clicked Text - the string set by a call to DW_container_set_row_title() or the third argument ???? to DW_tree_item_change() X - the X coordinate where the mouse button was pressed, relative to the top left corner of the Window Y - the Y coordinate where the mouse button was pressed, relative to the top left corner of the Window ItemData - ???? UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. DW_container_set_row_title, DW_tree_item_change When connecting this signal to a Tree widget, DW_signal_connect() MUST be called BEFORE the Tree is populated. When connecting this signal to a Container widget, DW_signal_connect() MUST be called AFTER the Container is populated. ... Call dw_signal_connect window, !REXXDW.!DW_ITEM_CONTEXT_EVENT, , 'itemcontext_cb', 'fred' ... itemcontext_cb: Parse Arg win, text, x, y, itemdata, userdata Say 'Item text' text 'entered in Window:' win 'at' x'/'y 'userdata:' userdata Return 1

ListSelectEventCallback rcode = ListSelectEventCallback(Window, Item [,UserData[,...]]) Called when a DW_LIST_SELECT_EVENT signal fires on a window. This occurs when the user clicks an entry in a listbox or combobox; ie an item in a list is selected. Window - value of the window handle that was clicked Item - the index of the item in the list that is selected. This index is 0-based. UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. ... Call dw_signal_connect window, !REXXDW.!DW_LIST_SELECT_EVENT, , 'listselect_cb', 'fred' ... listselect_cb: Parse Arg win, item, userdata Say 'Item number' item 'selected in Window:' win 'userdata:' userdata Return 1

ItemSelectEventCallback rcode = ItemSelectEventCallback(Window, Item, Text, Itemdata [,UserData[,...]]) Called when a DW_ITEM_SELECT_EVENT signal fires on a window. This occurs when the user clicks the left button on an item in a container or tree window. selected. Window - value of the window handle that was clicked Item - the index of the item in the list that is selected. This index is 0-based. Text - the string set by a call to DW_container_set_row_title() or the second argument to DW_tree_insert() ItemData - the string set by a the fifth argument to a call to DW_tree_insert() UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. When connecting this signal to a Tree widget, DW_signal_connect() MUST be called BEFORE the Tree is populated otherwise the signal will never fire. When connecting this signal to a Container widget, DW_signal_connect() MUST be called AFTER the Container is populated. ... Call dw_signal_connect window, !REXXDW.!DW_ITEM_SELECT_EVENT, , 'itemselect_cb', 'fred' ... itemselect_cb: Parse Arg win, item, text, userdata Say 'Item number' item 'selected in Window:' win 'text is:' text , 'userdata:' userdata Return 1

SetFocusEventCallback rcode = SetFocusEventCallback(Window [,UserData[,...]]) Called when a DW_SET_FOCUS_EVENT signal fires on a window. This occurs when the user gives focus to a window, either by clicking the left button in the window or by tabbing to the window. selected. Window - value of the window handle that was clicked UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. ... Call dw_signal_connect window, !REXXDW.!DW_SET_FOCUS_EVENT, 'setfocus_cb', , 'fred' ... setfocus_cb: Parse Arg win, userdata Say 'Window:' win 'now has focus userdata:' userdata Return 1

ValueChangedEventCallback rcode = ValueChangedEventCallback(Window, Value [,UserData[,...]]) Called when a DW_VALUE_CHANGED_EVENT signal fires on a window. This occurs when the user adjusts a scrollbar, or a slider control. Window - value of the window handle that was clicked Value - the new value of the top of the scrollbar thumb in units defined by DW_scrollbar_set_range() UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. DW_scrollbar_set_range, DW_slider_set_pos ... Call dw_signal_connect window, !REXXDW.!DW_VALUE_CHANGED_EVENT, , 'valuechanged_cb', 'fred' ... valuechanged_cb: Parse Arg win, val, userdata Say 'The top of the scrollbar thumb is now' val 'in Window:' win , 'userdata:' userdata Return 1

SwitchPageEventCallback rcode = SwitchPageEventCallback(Window, Page [,UserData[,...]]) Called when a DW_SWITCH_PAGE_EVENT signal fires on a window. This occurs when the user clicks on a tab in a notebook. Window - value of the window handle that was clicked Page - the index of the page of the notebook selected. Page numbers are 0 based. UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. ... Call dw_signal_connect window, !REXXDW.!DW_SWITCH_PAGE_EVENT, , 'switchpage_cb', 'fred' ... switchpage_cb: Parse Arg win, page, userdata Say 'Page' page 'of Window:' win 'selected. userdata:' userdata Return 1

ColumnClickEventCallback rcode = ColumnClickEventCallback(Window, Column [,UserData[,...]]) Called when a DW_COLUMN_CLICK_EVENT signal fires on a window. This occurs when the user clicks on a column heading of a container window. selected. Window - value of the window handle that was clicked Column - the index of the column of the container selected. Column numbers are 0 based. UserData - following optional values that the user supplied when the signal event was connected Return 1 to ensure that the default callback is not called. Return 0 to enable the default callback to be called. ... Call dw_signal_connect window, !REXXDW.!DW_COLUMN_CLICK_EVENT, , 'columnclick_cb', 'fred' ... columnclick_cb: Parse Arg win, column, userdata Say 'Column' column 'of Window:' win 'selected. userdata:' userdata Return 1

TimerEventCallback rcode = TimerEventCallback([UserData[,...]]) Called when a generic timer goes off. This occurs after the period specified by DW_timer_connect(). selected. UserData - optional values that the user supplied when the signal event was connected Return 1 to ensure that the timer is rearmed. Return 0 to ensure that the timer is not rearmed. The return code from the function called as a result of the timer firing determines whether the timer continues to fire after the specified period. DW_timer_connect ... Call dw_timer_connect window, 5000, 'timer_cb', 'fred' ... timer_cb: Parse Arg userdata Say 'Our timer went off after 5 seconds' 'userdata:' userdata Return 1

The following external functions comprise Rexx/DW.

Widgets are the fundamental display items in RexxDW. RexxDW supports a range of widgets to enable a rich GUI interface for your Rexx programs. RexxDW supports all common widget types as follows: box button checkbox/radiobutton container/filesystem dialog rendering entryfield listbox/combobox menu multiline edit notebook percent scrollbar slider spinbutton splitbar text tree window

Boxes are used to layout the GUI display. Widgets are packed into a box to position that widget. A box can be horizontal or vertical, which determines the arrangement of the widgets packed into the box. So to arrange two widgets side-by-side, you would create a horizontal box, your two widgets, and pack those two widgets into the box and they appear beside each other.

DW_box_new win = dw_box_new( Orientation ) Creates a new generic box window. A box is the basic widget for arranging the location and position of other widgets. Orientation- !REXXDW.!DW_VERT to indicate a vertical box !REXXDW.!DW_HORZ to indicate a horizontal box A window identifier. DW_groupbox_new, WidgetOrientation The orientation of a box determines the orientation of the widgets that are packed into this box. Creating a horizontal box and packing two buttons into it will result in the two buttons being placed side by side. ... box = dw_box_new( !REXXDW.!DW_VERT ) Call dw_box_pack_start win, box, 0, 0, !REXXDW.!DW_EXPAND_HORZ, , !REXXDW.!DW_EXPAND_VERT, 0

DW_groupbox_new win = dw_groupbox_new( Orientation, Title ) Creates a new generic groupbox window. A box is the basic widget for arranging the location and position of other widgets. The difference between a box and a groupbox is that a groupbox contains a border and a Title in the top left corner. Orientation- !REXXDW.!DW_VERT to indicate a vertical box !REXXDW.!DW_HORZ to indicate a horizontal box Title - the text to display as the box title A window identifier. DW_box_new, WidgetOrientation The orientation of a box determines the orientation of the widgets that are packed into this box. Creating a horizontal box and packing two buttons into it will result in the two buttons being placed side by side. ... box = dw_groupbox_new( !REXXDW.!DW_VERT, 'Editor' ) Call dw_box_pack_start win, box, 0, 0, !REXXDW.!DW_EXPAND_HORZ, , !REXXDW.!DW_EXPAND_VERT, 0

DW_box_pack_start dw_box_pack_start( ParentBox, BoxToPack, BoxWidth, BoxHeight, HorzExpand, VertExpand, Padding ) Packs the BoxToPack at the start of the ParentBox; ie at the left of a horizontal ParentBox, or the top of a vertical ParentBox. The height and width of the box can be specified as is the ability to allow the box to expand horizontally or vertically. ParentBox - the box into which the BoxToPack is packed BoxToPack - the box that requires packing BoxWidth - the initial width of the box in pixels BoxHeight - the initial height of the box in pixels HorzExpand - indicate if the box can be expanded horizontally. Specify either !REXXDW.!DW_EXPAND_HORZ or !REXXDW.!DW_DONT_EXPAND_HORZ VertExpand - indicate if the box can be expanded vertically. Specify either !REXXDW.!DW_EXPAND_VERT or !REXXDW.!DW_DONT_EXPAND_VERT Padding - The number of pixels of padding to add around all sides of BoxToPack No return result. DW_box_pack_end The BoxToPack argument can be 0, which will result in empty space being packed. ... button = dw_bitmapbutton_new_from_file( 'Quit', 0, 'quit' ) Call dw_box_pack_start win, button, 0, 32, !REXXDW.!DW_EXPAND_HORZ, , !REXXDW.!DW_DONT_EXPAND_VERT, 0

DW_box_pack_end dw_box_pack_end( ParentBox, BoxToPack, BoxWidth, BoxHeight, HorzExpand, VertExpand, Padding ) Packs the BoxToPack at the end of the ParentBox; ie at the right of a horizontal ParentBox, or the bottom of a vertical ParentBox. The height and width of the box can be specified as is the ability to allow the box to expand horizontally or vertically. ParentBox - the box into which the BoxToPack is packed BoxToPack - the box that requires packing BoxWidth - the initial width of the box in pixels BoxHeight - the initial height of the box in pixels HorzExpand - indicate if the box can be expanded horizontally. Specify either !REXXDW.!DW_EXPAND_HORZ or !REXXDW.!DW_DONT_EXPAND_HORZ VertExpand - indicate if the box can be expanded vertically. Specify either !REXXDW.!DW_EXPAND_VERT or !REXXDW.!DW_DONT_EXPAND_VERT Padding - The number of pixels of padding to add around all sides of BoxToPack No return result. DW_box_pack_start The BoxToPack argument can be 0, which will result in empty space being packed. ... button = dw_bitmapbutton_new_from_file( 'Quit', 0, 'quit' ) Call dw_box_pack_end win, button, 0, 32, !REXXDW.!DW_EXPAND_HORZ, , !REXXDW.!DW_DONT_EXPAND_VERT, 0

Buttons enable an action to be carried out by the user clicking the left mouse button on the widget. RexxDW supports two types of button; plain text buttons and bitmap buttons.

DW_button_new win = dw_button_new( ButtonText, Id ) Creates a new text button. A button is a widget which contains text and can be clicked to execute some action. ButtonText - the text to display in the button Id - a numeric identifier used to identify the window A window identifier. DW_bitmapbutton_new_from_file ... button = dw_button_new( "Quit", 10 )

DW_bitmapbutton_new_from_file win = dw_bitmapbutton_new_from_file( BubbleText, Id, Filename ) Creates a new button window using a bitmap image. BubbleText - the text to display when the mouse is over the button Id - a numeric identifier used to identify the window Filename - the name of a file containing a valid bitmap image (.BMP, or .XPM) A window identifier. DW_button_new ... button = dw_bitmapbutton_new_from_file( 'Quit', 0, 'quit' ) Call dw_box_pack_start win, button, 32, 32, !REXXDW.!DW_DONT_EXPAND_HORZ, , !REXXDW.!DW_DONT_EXPAND_VERT, 0

The Calendar widget displays a month calendar from which the user can select a date.

DW_calendar_new win = dw_calendar_new( Id ) Creates a new calendar. A calendar is a widget which allows the user to select a date. Id - a numeric identifier used to identify the window A window identifier. DW_calendar_get_date, DW_calendar_set_date On OS/2 this is a dummy text widget. On GTK, only 1 month is ever displayed. On Windows, more than 1 month is displayed depending on whether the widget is packed with expanding on. ... calendar = dw_calendar_new( 10 )

DW_calendar_get_date date = dw_calendar_get_date( Win ) Gets the selected date of the widget. Win - the window identifier returned from DW_calendar_new() The date selected in Rexx's DATE('S') format. DW_calendar_new, DW_calendar_set_date ... calendar = dw_calendar_new( 10 ) ... date = dw_calendar_get_date( calendar )

DW_calendar_set_date dw_calendar_set_date( Win, Date ) Sets the date for the widget. Win - the window identifier returned from DW_calendar_new() Date - the date to set the widget to. Must be in Rexx DATE( 'S' ) format. None DW_calendar_new, DW_calendar_get_date ... calendar = dw_calendar_new( 10 ) ... date = dw_calendar_set_date( calendar, Date( 'S' ) )

Checkboxes provide a simple mechanism for a user to indicate a boolean value response. Radiobuttons provide the user with a means to choose from a list of options.

DW_checkbox_new win = dw_checkbox_new( CheckboxText, Id ) Creates a new checkbox. A checkbox is a widget that allows for a boolean value to be set. It contains text to describe the boolean value being set. CheckboxText - the text to display next to the checkbox Id - a numeric identifier used to identify the window A window identifier. DW_checkbox_get, DW_checkbox_set ... checkbox = dw_checkbox_new( "Allow user to delete", 0 )

DW_radiobutton_new win = dw_radiobutton_new( ButtonText, Id ) Creates a new radiobutton. A radiobutton is a widget that allows for one of a number of values to be set. It contains text to describe the value being set. A number of radiobuttons are created together with one of them set at any point in time. ButtonText - the text to display next to the radiobutton Id - a numeric identifier used to identify the window A window identifier. DW_checkbox_new, DW_groupbox_new For radiobuttons to work properly, all radiobuttons that are to be grouped together MUST be packed into the same groupbox and they MUST have a unique Id within the groupbox. langs = 'Rexx Perl Tcl C COBOL' groupbox = dw_groupbox_new( !REXXDW.!DW_VERT, 0, 'Favourite Language' ) Do i = 1 To Words( langs ) rb.i = dw_radiobutton_new( Word( langs, i ), i*10 ) Call dw_box_pack_start groupbox, rb.i, 150, 15, !REXXDW.!DW_EXPAND_HORZ, , !REXXDW.!DW_DONT_EXPAND_VERT, 0 End Call dw_radiobutton_set rb.1, !REXXDW.!DW_CHECKED

DW_checkbox_set dw_checkbox_set( Win, State ) Sets the state of the specified checkbox. Win - the window identifier returned from DW_checkbox_new() State - the initial state of the checkbox; !REXXDW.!DW_CHECKED or !REXXDW.!DW_UNCHECKED No return result. DW_checkbox_new, DW_checkbox_get, WidgetChecked ... checkbox = dw_checkbox_new( "Allow access", 0 ) Call dw_checkbox_set( checkbox, !REXXDW.!DW_CHECKED )

DW_radiobutton_set dw_radiobutton_set( Win, State ) Sets the state of the radiobutton to checked or not. Win - the window identifier returned from DW_radiobutton_new() State - set to DW_CHECKED or DW_UNCHECKED No return result. DW_radiobutton_get langs = 'Rexx Perl Tcl C COBOL' groupbox = dw_groupbox_new( !REXXDW.!DW_VERT, 0, 'Favourite Language' ) Do i = 1 To Words( langs ) rb.i = dw_radiobutton_new( Word( langs, i ), i*10 ) Call dw_box_pack_start groupbox, rb.i, 150, 15, !REXXDW.!DW_EXPAND_HORZ, , !REXXDW.!DW_DONT_EXPAND_VERT, 0 End Call dw_radiobutton_set rb.1, !REXXDW.!DW_CHECKED

DW_checkbox_get win = dw_checkbox_get( Win ) Queries the state of the specified checkbox. Win - the window identifier returned from DW_checkbox_new() 1 if the checkbox is checked, 0 if not checked. DW_checkbox_new, DW_checkbox_set ... checkbox = dw_checkbox_new( "Allow access", 0 ) ... rc = dw_checkbox_get( checkbox ) cb_result = 'Unchecked Checked' Say 'Allow access checkbox' Word( cb_result, rc+1 )

DW_radiobutton_get boolean = dw_radiobutton_get( Win ) Determines if a radiobutton has been checked or not. Win - the window identifier returned from DW_radiobutton_new() 1 if the radiobutton is checked, 0 if unchecked DW_radiobutton_set langs = 'Rexx Perl Tcl C COBOL' groupbox = dw_groupbox_new( !REXXDW.!DW_VERT, 0, 'Favourite Language' ) Do i = 1 To Words( langs ) rb.i = dw_radiobutton_new( Word( langs, i ), i*10 ) Call dw_box_pack_start groupbox, rb.i, 150, 15, !REXXDW.!DW_EXPAND_HORZ, , !REXXDW.!DW_DONT_EXPAND_VERT, 0 End Call dw_radiobutton_set rb.1, !REXXDW.!DW_CHECKED ... Do i = 1 To Words( langs ) If dw_radiobutton_get( rb.i ) Then Do Say 'Your favourite language is' Word( langs, i ) Leave End End

These widgets provide a two-dimensional display of read-only data. Data are displayed in rows and columns, with automatically created scrollbars to display the complete set of data. Columns can be resized by the user at runtime. A Filesystem is the same as a normal Container, except that the first column consists of a column of string and icon items, which usually displays a filename. All DW_container*() functions (for which there is no specific "Filename" equivalent) also works with a "Filename" widget.

DW_container_new win = dw_container_new( Id, Selection ) Creates a new container. A container is a widget that provides a grid of cells with column headings. Id - a numeric identifier used to identify the window Selection - !REXXDW.!DW_SINGLE_SELECTION indicates that only 1 row in the container is selectable !REXXDW.!DW_MULTIPLE_SELECTION indicates that multiple rowsin the container are selectable A window identifier. ContainerSelection ... container = dw_container_new( 1, !REXXDW.!DW_SINGLE_SELECTION )

DW_container_alloc alloc = dw_container_alloc( Win, RowCount ) Allocates working memory for a container window. Win - the window identifier returned from DW_container_new() RowCount - the number of rows of data that the container will initially contain An identifier for the working memory. DW_container_new, DW_container_clear After a container window is created, you need to allocate memory for the initial number of rows that the container will contain. This call does that and must be called after creating the container. The allocated memory will be freed when the container is destroyed and by a call to DW_container_clear(). ... container = dw_container_new( 1, !REXXDW.!DW_SINGLE_SELECTION ) alloc = dw_container_alloc( container, 10 ) ...

DW_container_setup dw_container_setup( Win, FlagsArray, TitlesArray[,Separator] ) Defines properties for the columns in a container. Win - the window identifier returned from DW_container_new() FlagsArray - an array containing column flags TitlesArray- an array containing column heading titles Separator - An optional flag under OS/2 ????? No return result. DW_container_change_item, DW_filesystem_setup, ContainerColumnFlags The FlagsArray is a Rexx stem variable name, including a trailing period. The 0th compound variable (eg Flags.0) contains a count of the number of items in the array. Each item in the array can contain a combination of the values described in ContainerColumnFlags. ... flags.0 = 2 flags.1 = dw_or( !REXXDW.!DW_CFA_STRINGANDICON, !REXXDW.!DW_CFA_LEFT, , !REXXDW.!DW_CFA_SEPARATOR, !REXXDW.!DW_CFA_HORZSEPARATOR ) flags.2 = dw_or( !REXXDW.!DW_CFA_STRING, !REXXDW.!DW_CFA_LEFT, , !REXXDW.!DW_CFA_SEPARATOR, !REXXDW.!DW_CFA_HORZSEPARATOR ) titles.0 = 2 titles.1 = 'Title' titles.2 = 'Command' ... container = dw_container_new( 1, !REXXDW.!DW_MULTIPLE_SELECTION ) Call dw_container_setup container, 'flags.', 'titles.', 0 alloc = dw_container_alloc( container, numrows ) ... Do i = 1 To numrows Call dw_container_set_item container, alloc, 0, i-1, title.i, icon.i Call dw_container_set_item container, alloc, 1, i-1, command.i Call dw_container_set_row_title alloc, i-1, "Row"i End

DW_filesystem_setup dw_filesystem_setup( Win, FlagsArray, TitlesArray, Separator ) Defines properties for the columns in a filesystem container. Win - the window identifier returned from DW_container_new() FlagsArray - an array containing column flags TitlesArray- an array containing column heading titles No return result. DW_filesystem_change_item, DW_container_setup, ContainerColumnFlags The FlagsArray is a Rexx stem variable name, including a trailing period. The 0th compound variable (eg Flags.0) contains a count of the number of items in the array. Each item in the array can contain a combination of the values described in ContainerColumnFlags. ... flags.0 = 2 flags.1 = dw_or( !REXXDW.!DW_CFA_STRINGANDICON, !REXXDW.!DW_CFA_LEFT, , !REXXDW.!DW_CFA_SEPARATOR, !REXXDW.!DW_CFA_HORZSEPARATOR ) flags.2 = dw_or( !REXXDW.!DW_CFA_STRING, !REXXDW.!DW_CFA_LEFT, , !REXXDW.!DW_CFA_SEPARATOR, !REXXDW.!DW_CFA_HORZSEPARATOR ) titles.0 = 2 titles.1 = 'Title' titles.2 = 'Command' ... container = dw_container_new( 1, !REXXDW.!DW_MULTIPLE_SELECTION ) alloc = dw_container_alloc( container, numrows ) Call dw_filesystem_setup container, 'flags.', 'titles.' ... normalfileicon = dw_icon_load_from_file( '/home/mark/normalfile' ) Do i = 1 To numrows Call dw_filesystem_set_file container, alloc, '/home/mark/myfile', myicon Call dw_filesystem_set_item container, alloc, 0, i-1, title.i, icon.i Call dw_filesystem_set_item container, alloc, 1, i-1, command.i Call dw_container_set_row_title alloc, i-1, "Row"i End

DW_container_set_item dw_container_set_item( Win, Memory, Column, Row, Data [,Data2] ) Adds the initial data into a cell of a container. Win - the window identifier returned from DW_container_new() Memory - the memory identifier returned by a call to DW_container_alloc() Column - the column of the data to be changed, 0 based Row - the row of the data to be changed, 0 based Data - the new data value for the cell Data2 - extra data for the cell if the column type is !REXXDW.!DW_CFA_STRINGANDICON (not implemented yet) No return result. DW_container_change_item, DW_container_setup, ContainerColumnFlags DW_filesystem_change_item, DW_filesystem_set_item The Data (and Data2) arguments must match the data type of the column when defined in the call to DW_container_setup(). ... flags.0 = 2 flags.1 = dw_or( !REXXDW.!DW_CFA_STRINGANDICON, !REXXDW.!DW_CFA_LEFT, , !REXXDW.!DW_CFA_SEPARATOR, !REXXDW.!DW_CFA_HORZSEPARATOR ) flags.2 = dw_or( !REXXDW.!DW_CFA_STRING, !REXXDW.!DW_CFA_LEFT, , !REXXDW.!DW_CFA_SEPARATOR, !REXXDW.!DW_CFA_HORZSEPARATOR ) titles.0 = 2 titles.1 = 'Title' titles.2 = 'Command' ... container = dw_container_new( 1, !REXXDW.!DW_MULTIPLE_SELECTION ) alloc = dw_container_alloc( container, numrows ) Call dw_container_setup container, 'flags.', 'titles.', 0 ... Do i = 1 To numrows Call dw_container_set_item container, alloc, 0, i-1, title.i, icon.i Call dw_container_set_item container, alloc, 1, i-1, command.i Call dw_container_set_row_title alloc, i-1, "Row"i End

DW_filesystem_set_file dw_filesystem_set_file( Win, Memory, Row, Filename, Icon ) Adds the data in the first cell of a filesystem container. Win - the window identifier returned from DW_container_new() Memory - the memory identifier returned by a call to DW_container_alloc() Row - the row of the data to be changed, 0 based Filename - the new filename for the cell Icon - the icon identifier returned from DW_icon_load_from_file() to be the new icon for the cell No return result. DW_filesystem_change_file, DW_filesystem_set_item ... normalfileicon = dw_icon_load_from_file( '/home/mark/normalfile' ) container = dw_container_new( 1, !REXXDW.!DW_SINGLE_SELECTION ) alloc = dw_container_alloc( container, 10 ) ... Call dw_filesystem_set_file container, alloc, 10, '/home/mark/newfile.txt', , normalfileicon

DW_filesystem_set_item dw_filesystem_set_item( Win, Memory, Column, Row, Data [,Data2] ) Adds the initial data into a cell of a filesystem container. Win - the window identifier returned from DW_container_new() Memory - the memory identifier returned by a call to DW_container_alloc() Column - the column of the data to be changed, 0 based Row - the row of the data to be changed, 0 based Data - the new data value for the cell Data2 - extra data for the cell if the column type is !REXXDW.!DW_CFA_STRINGANDICON (not implemented yet) No return result. DW_container_change_item, DW_container_setup, ContainerColumnFlags DW_filesystem_change_item, DW_container_set_item The Data (and Data2) arguments must match the data type of the column when defined in the call to DW_container_setup(). ... flags.0 = 2 flags.1 = dw_or( !REXXDW.!DW_CFA_STRINGANDICON, !REXXDW.!DW_CFA_LEFT, , !REXXDW.!DW_CFA_SEPARATOR, !REXXDW.!DW_CFA_HORZSEPARATOR ) flags.2 = dw_or( !REXXDW.!DW_CFA_STRING, !REXXDW.!DW_CFA_LEFT, , !REXXDW.!DW_CFA_SEPARATOR, !REXXDW.!DW_CFA_HORZSEPARATOR ) titles.0 = 2 titles.1 = 'Title' titles.2 = 'Command' ... container = dw_container_new( 1, !REXXDW.!DW_MULTIPLE_SELECTION ) alloc = dw_container_alloc( container, numrows ) Call dw_filesystem_setup container, 'flags.', 'titles.', 0 ... Do i = 1 To numrows Call dw_filesystem_set_file container, alloc, i-1, fname.i, icon.i Call dw_filesystem_set_item container, alloc, 0, i-1, title.i, icon.i Call dw_filesystem_set_item container, alloc, 1, i-1, command.i Call dw_container_set_row_title alloc, i-1, "Row"i End

DW_container_change_item dw_container_change_item( Win, Column, Row, Data [,Data2] ) Changes the data in a cell of a container. Win - the window identifier returned from DW_container_new() Column - the column of the data to be changed, 0 based Row - the row of the data to be changed, 0 based Data - the new data value for the cell Data2 - extra data for the cell if the column type is !REXXDW.!DW_CFA_STRINGANDICON (not implemented yet) No return result. DW_container_set_item The Data (and Data2) arguments must match the data type of the column when defined in the call to DW_container_setup(). ... container = dw_container_new( 1, !REXXDW.!DW_SINGLE_SELECTION ) ... Call dw_container_change_item container, 0, 10, 'New string data'

DW_filesystem_change_file dw_filesystem_change_file( Win, Row, Filename, Icon ) Changes the data in the first cell of a filesystem container. Win - the window identifier returned from DW_container_new() Row - the row of the data to be changed, 0 based Filename - the new filename for the cell Icon - the icon identifier returned from DW_icon_load_from_file() to be the new icon for the cell No return result. DW_filesystem_change_item, DW_filesystem_set_file ... normalfileicon = dw_icon_load_from_file( '/home/mark/normalfile' ) ... container = dw_container_new( 1, !REXXDW.!DW_SINGLE_SELECTION ) ... Call dw_filesystem_change_file container, 10, '/home/mark/newfile.txt', , normalfileicon

DW_filesystem_change_item dw_filesystem_change_item( Win, Column, Row, Data [,Data2] ) Changes the data in a cell of a container. Win - the window identifier returned from DW_container_new() Column - the column of the data to be changed, 0 based Row - the row of the data to be changed, 0 based Data - the new data value for the cell Data2 - extra data for the cell if the column type is !REXXDW.!DW_CFA_STRINGANDICON (not implemented yet) No return result. DW_container_set_item The Data (and Data2) arguments must match the data type of the column when defined in the call to DW_container_setup(). ... container = dw_container_new( 1, !REXXDW.!DW_SINGLE_SELECTION ) ... Call dw_filesystem_change_item container, 0, 10, 'New string data'

DW_container_insert dw_container_insert( Win, Memory, RowCount ) Inserts the allocated memory into the container. Win - the window identifier returned from DW_container_new() Memory - the memory identifier returned by a call to DW_container_alloc() RowCount - the number of rows of data that the container will initially contain No return result. DW_container_new, DW_container_alloc ... container = dw_container_new( 1, !REXXDW.!DW_SINGLE_SELECTION ) alloc = dw_container_alloc( container, numrows ) ... Call dw_container_insert container, alloc, numrows

DW_container_set_row_title dw_container_set_row_title( Memory, Row, TitleText ) Assigns a textual string for the specified Row. Used to identify this row in other container functions