|
StdGUI Window Functions |
|
WINDOW *create_window(char *p_title, int p_x, int p_y, int p_width, int p_height, int p_flags, int p_mode, ...); int delete_window(WINDOW *p_win); int get_window_info(WINDOW *p_win, char **p_title, int *p_x, int *p_y, int *p_width, int *p_height, int *p_flags, int *p_visible); int show_window(WINDOW *p_win); int hide_window(WINDOW *p_win); |
|
The create_window() function creates a new window. By default the new window is immediately displayed, if you want the window to be hidden when it is created, use the WIN_HIDDEN flag in the p_flags parameter. The create_window() function can take multiple, extended parameters defining properties (p_mode =SET_PROP) or user data items (p_mode =SET_USER_DATA) on the window, the list of properties is terminated with a DONE value, similar to the extended parameters on the start_gui() function. The delete_window() function destroys a window that was created by the create_window() function. The get_window_info() function returns basic information about the window: the window’s title (p_title), position (p_x,p_y), size (p_width,p_height), flags (p_flags) and whether or not the window is currently visible (p_visible). The show_window() and hide_window() functions show and hide a window. |
|
DIRTY − indicates if the window contents have been modified or need to be saved. TITLE − the title of the window (shown in the title bar). XPOS, YPOS and POSITION − the position of the window, either individually or as an array of two items. WIDTH, HEIGHT and SIZE − the size of the window, either individually or as an array of two items. |
|
The create_window() function returns a valid pointer to a window structure on success, NULL on failure. The delete_window(), get_window_info(), show_window() and hide_window() functions all return zero (0) on success, non-zero on failure. |
|
Jeffrey Dutky |