dwindows: template/dw.c comparison

comparison template/dw.c @ 1010:9af693aafa93

Attempt at implmenting dw_window_get_font on OS/2. Also some more formatting cleanups in the template.

author	bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date	Sat, 14 May 2011 06:40:27 +0000
parents	f046a2712b38
children	b58032a619b9

comparison

equal deleted inserted replaced

-:f1256b32fd22
+:9af693aafa93
 * Parameters:
 *          handle: Handle to the scrollbox to be queried.
 *          orient: The vertical or horizontal scrollbar.
 * Returns:
 *       The vertical or horizontal range of the scrollbox.
 */
 int API dw_scrollbox_get_range(HWND handle, int orient)
 {
 return 0;
 }
 * Parameters:
 *       text: The default text to be in the entryfield widget.
 *       id: An ID to be used with dw_window_from_id() or 0L.
 * Returns:
 *       A handle to an entryfield window or NULL on failure.
 */
 HWND API dw_entryfield_new(char *text, ULONG cid)
 {
 return 0;
 }
 /*
 * Create a new spinbutton window (widget) to be packed.
 * Parameters:
 *       text: The text to be display by the static text widget.
 *       id: An ID to be used with dw_window_from_id() or 0L.
 * Returns:
 *       A handle to a spinbutton window or NULL on failure.
 */
 HWND API dw_spinbutton_new(char *text, ULONG cid)
 {
 return 0;
 }
 * Returns the current value of the spinbutton.
 * Parameters:
 *          handle: Handle to the spinbutton to be queried.
 * Returns:
 *       Number value displayed in the spinbutton.
 */
 long API dw_spinbutton_get_pos(HWND handle)
 {
 return 0;
 }
 /*
 * Returns the listbox's item count.
 * Parameters:
 *          handle: Handle to the listbox to be counted.
 * Returns:
 *       The number of items in the listbox.
 */
 int API dw_listbox_count(HWND handle)
 {
 return 0;
 }
 /*
 * Create a new Combobox window (widget) to be packed.
 * Parameters:
 *       text: The default text to be in the combpbox widget.
 *       id: An ID to be used with dw_window_from_id() or 0L.
 * Returns:
 *       A handle to a combobox window or NULL on failure.
 */
 HWND API dw_combobox_new(char *text, ULONG cid)
 {
 return 0;
 }
 /*
 * Create a new Multiline Editbox window (widget) to be packed.
 * Parameters:
 *       id: An ID to be used with dw_window_from_id() or 0L.
 * Returns:
 *       A handle to a MLE window or NULL on failure.
 */
 HWND API dw_mle_new(ULONG cid)
 {
 return 0;
 }
 * Parameters:
 *          handle: Handle to the MLE to be cleared.
 *          text: Text to search for.
 *          point: Start point of search.
 *          flags: Search specific flags.
 * Returns:
 *       Position in buffer or DW_ERROR_UNKNOWN (-1) on error.
 */
 int API dw_mle_search(HWND handle, char *text, int point, unsigned long flags)
 {
 return DW_ERROR_UNKNOWN;
 }
 /*
 * Create a new status text window (widget) to be packed.
 * Parameters:
 *       text: The text to be display by the static text widget.
 *       id: An ID to be used with dw_window_from_id() or 0L.
 * Returns:
 *       A handle to a status text window or NULL on failure.
 */
 HWND API dw_status_text_new(char *text, ULONG cid)
 {
 return 0;
 }
 /*
 * Create a tree object to be packed.
 * Parameters:
 *       id: An ID to be used for getting the resource from the
 *           resource file.
 * Returns:
 *       A handle to a tree window or NULL on failure.
 */
 HWND API dw_tree_new(ULONG cid)
 {
 return 0;
 }
 *       flags: If this parameter is DW_CRA_SELECTED it will only
 *              return items that are currently selected.  Otherwise
 *              it will return all records in the container.
 * Returns:
 *       Pointer to data associated with first entry or NULL on error.
 */
 char * API dw_container_query_start(HWND handle, unsigned long flags)
 {
 return NULL;
 }
 *       flags: If this parameter is DW_CRA_SELECTED it will only
 *              return items that are currently selected.  Otherwise
 *              it will return all records in the container.
 * Returns:
 *       Pointer to data associated with next entry or NULL on error or completion.
 */
 char * API dw_container_query_next(HWND handle, unsigned long flags)
 {
 return NULL;
 }
 * Obtains an icon from a file.
 * Parameters:
 *       filename: Name of the file, omit extention to have
 *                 DW pick the appropriate file extension.
 *                 (ICO on OS/2 or Windows, XPM on Unix)
 * Returns:
 *       Handle to the created icon or NULL on error.
 */
 HICN API dw_icon_load_from_file(char *filename)
 {
 return 0;
 }
 * Parameters:
 *       data: Data for the icon (ICO on OS/2 or Windows, XPM on Unix, PNG on Mac)
 *       len: Length of the passed in data.
 * Returns:
 *       Handle to the created icon or NULL on error.
 */
 HICN API dw_icon_load_from_data(char *data, int len)
 {
 return 0;
 }
 /*
 * Create a menu object to be popped up.
 * Parameters:
 *       id: An ID to be used associated with this menu.
 * Returns:
 *       Handle to the created menu or NULL on error.
 */
 HMENUI API dw_menu_new(ULONG cid)
 {
 return 0;
 }
 /*
 * Create a menubar on a window.
 * Parameters:
 *       location: Handle of a window frame to be attached to.
 * Returns:
 *       Handle to the created menu bar or NULL on error.
 */
 HMENUI API dw_menubar_new(HWND location)
 {
 return 0;
 }
 *       owner: The Owner's window handle or HWND_DESKTOP.
 *       title: The Window title.
 *       flStyle: Style flags.
 * Returns:
 *       Handle to the created window or NULL on error.
 */
 HWND API dw_window_new(HWND hwndOwner, char *title, ULONG flStyle)
 {
 return 0;
 }
 * Sets the colors used by a specified window (widget) handle.
 * Parameters:
 *          handle: The window (widget) handle.
 *          fore: Foreground color in DW_RGB format or a default color index.
 *          back: Background color in DW_RGB format or a default color index.
 * Returns:
 *       DW_ERROR_NONE (0) on success.
 */
 int API dw_window_set_color(HWND handle, ULONG fore, ULONG back)
 {
 return DW_ERROR_GENERAL;
 }
 /*
 * Destroys a window and all of it's children.
 * Parameters:
 *           handle: The window handle to destroy.
 * Returns:
 *       DW_ERROR_NONE (0) on success.
 */
 int API dw_window_destroy(HWND handle)
 {
 return DW_ERROR_GENERAL;
 }
 /* Open a shared library and return a handle.
 * Parameters:
 *         name: Base name of the shared library.
 *         handle: Pointer to a module handle,
 *                 will be filled in with the handle.
 * Returns:
 *       DW_ERROR_NONE (0) on success.
 */
 int dw_module_load(char *name, HMOD *handle)
 {
 return DW_ERROR_UNKNOWN;
 /* Resets the event semaphore so threads who call wait
 * on this semaphore will block.
 * Parameters:
 *         eve: Handle to the semaphore obtained by
 *              an get or new call.
 * Returns:
 *       DW_ERROR_NONE (0) on success.
 */
 int dw_named_event_reset(HEV eve)
 {
 return DW_ERROR_GENERAL;
 }
 * Parameters:
 *         eve: Handle to the semaphore obtained by
 *              an get or new call.
 * Returns:
 *       DW_ERROR_NONE (0) on success.
 */
 int dw_named_event_post(HEV eve)
 {
 return DW_ERROR_GENERAL;
 }
 /* Release this semaphore, if there are no more open
 * handles on this semaphore the semaphore will be destroyed.
 * Parameters:
 *         eve: Handle to the semaphore obtained by
 *              an get or new call.
 * Returns:
 *       DW_ERROR_NONE (0) on success.
 */
 int dw_named_event_close(HEV eve)
 {
 return DW_ERROR_UNKNOWN;
 }
 *         dest: A pointer to a pointer to receive the memory address.
 *         size: Size in bytes of the shared memory region to allocate.
 *         name: A string pointer to a unique memory name.
 * Returns:
 *       Handle to shared memory or NULL on error.
 */
 HSHM dw_named_memory_new(void **dest, int size, char *name)
 {
 return NULL;
 }
 *       dest: A pointer to a pointer to receive the memory address.
 *       size: Size in bytes of the shared memory region to requested.
 *       name: A string pointer to a unique memory name.
 * Returns:
 *       Handle to shared memory or NULL on error.
 */
 HSHM dw_named_memory_get(void **dest, int size, char *name)
 {
 return NULL;
 }
 * Parameters:
 *       handle: Handle obtained from dw_named_memory_new().
 *       ptr: The memory address aquired with dw_named_memory_new().
 * Returns:
 *       DW_ERROR_NONE (0) on success or DW_ERROR_UNKNOWN (-1) on error.
 */
 int dw_named_memory_free(HSHM handle, void *ptr)
 {
 int rc = DW_ERROR_UNKNOWN;
 return rc;
 * Creates a new thread with a starting point of func.
 * Parameters:
 *       func: Function which will be run in the new thread.
 *       data: Parameter(s) passed to the function.
 *       stack: Stack size of new thread (OS/2 and Windows only).
 * Returns:
 *       Thread ID on success or DW_ERROR_UNKNOWN (-1) on error.
 */
 DWTID dw_thread_new(void *func, void *data, int stack)
 {
 return (DWTID)DW_ERROR_UNKNOWN;
 }
 * Loads a web browser pointed at the given URL.
 * Parameters:
 *       url: Uniform resource locator.
 * Returns:
 *       DW_ERROR_NONE (0) on success.
 */
 int dw_browse(char *url)
 {
 return DW_ERROR_GENERAL;
 }

Mercurial > dwindows

comparison template/dw.c @ 1010:9af693aafa93