X11workbench Toolkit
1.0
|
Modules | |
Definitions | |
Structures | |
Typedefs | |
typedef struct s_DIALOG_WINDOW | DIALOG_WINDOW |
DIALOG_WINDOW structure, an extension of WBDialogWindow. More... | |
typedef struct s_WB_DIALOG_ENTRY | WBDialogEntry |
Structure identifying one of the controls that appears on a dialog window. More... | |
typedef struct s_WB_DIALOG_WINDOW | WBDialogWindow |
Structure identifying a dialog (frame) window. More... | |
Functions | |
void | DLGAssignOwner (WBDialogWindow *pDlg, Window wIDOwner) |
Assign owning window to dialog. More... | |
void | DLGRecalcLayout (Window wID) |
Force re-calculation of dialog window (and control) layout. More... | |
int | DLGPixelHeight (WBDialogWindow *pDlg, int iHeight) |
Height of a single dialog unit (in pixels) More... | |
int | DLGPixelWidth (WBDialogWindow *pDlg, int iWidth) |
Width of a single dialog unit (in pixels) More... | |
void | DLGSetUserCallback (WBDialogWindow *pDLG, WBWinEvent pCallBack) |
Assign the callback function for a dialog window. More... | |
int | DLGProcessHotKey (WBDialogWindow *pDLG, XEvent *pEvent) |
return non-zero if a hot-key was processed and no further processing should be done. Otherwise returns zero. | |
static __inline__ WBDialogWindow * | DLGGetDialogWindowStruct (Window wID) |
Returns a pointer to the dialog window's WBDialogWindow structure. More... | |
void * | DLGGetDialogWindowUserData (Window wID) |
Returns a pointer to the dialog window's 'user data' assigned at create time. More... | |
void | DLGDestroyDialogWindow (Window wID) |
Destroy a modeless dialog window via its window ID. More... | |
void | DLGDestroyDialogWindow2 (WBDialogWindow *pDialogWindow) |
Destroy a modeless dialog window via a pointer to its WBDialogWindow structure. More... | |
Window | DLGGetDialogControl (WBDialogWindow *pDialog, int iControlID) |
returns the Window ID of a member control of the dialog window using the 'control ID' More... | |
WBDialogEntry * | DLGGetDialogControlEntry (WBDialogWindow *pDialog, Window idControl) |
returns a pointer to the WBDialogEntry for a member control using the control's Window ID More... | |
Window | DLGGetFirstDialogControl (WBDialogWindow *pDialog) |
Return the Window ID of the FIRST dialog control within the 'tab order'. More... | |
Window | DLGGetNextDialogControl (WBDialogWindow *pDialog, Window idControl) |
Return the Window ID of the NEXT dialog control within the 'tab order', based on the specified control window ID. More... | |
Window | DLGGetPrevDialogControl (WBDialogWindow *pDialog, Window idControl) |
Return the Window ID of the PREVIOUS dialog control within the 'tab order', based on the specified control window ID. More... | |
static __inline__ void | DLGNotifyDlg (WBDialogWindow *pDLG, Atom aNotify, long lData0, long lData1, long lData2, long lData3, long lData4) |
Notify dialog window by calling the window's own callback function directly with an event. More... | |
static __inline__ void | DLGNotifyDlgAsync (WBDialogWindow *pDLG, Atom aNotify, long lData0, long lData1, long lData2, long lData3, long lData4) |
Notify dialog window by posting an event that will ASYNCHRONOUSLY be sent to the dialog window's callback function. More... | |
Dialog Frame Windows are specialized frame windows that normally execute as MODAL windows ( see WBShowModal() and WBEndModal() ).
A lot of specialized processing needs to be done for a proper dialog window, including all of the hot keys necessary to change focus and activate 'default' buttons and controls. Additionally, it is often desirable to create a dialog window 'on the fly' from a resource that can be language-dependent or content-dependent (or both). For this reason the Dialog portion of the X11 Work Bench Toolkit API supports dialog window creation from a text resource, using registered identifier names within the resource text.
DIALOG_WINDOW structure, an extension of WBDialogWindow.
Dialog 'owner' window structure, kept internally as part of a link list. This structure keeps track of the child (control) windows and global properties. See also WB_DIALOG_PROP and WBDialogPropList.
Structure identifying one of the controls that appears on a dialog window.
Public members of the structure that identifies a dialog control. This structure identifies one of the controls that appears on a dialog window. Each control will uniquely map to one of these structures.
Structure identifying a dialog (frame) window.
This structure identifies the dialog (frame) window. The public members are documented in this file. Private members store information that is only accessible using the API functions (such as an array of WBDialogEntry structures).
void DLGAssignOwner | ( | WBDialogWindow * | pDlg, |
Window | wIDOwner | ||
) |
Assign owning window to dialog.
The 'owning' window defines the window that the dialog belongs to such that when the dialog is destroyed (and currently has focus) this window will automatically be raised and assigned the input focus. This is NOT the same as the parent window!
Header File: dialog_window.h
Definition at line 555 of file dialog_window.c.
void DLGDestroyDialogWindow | ( | Window | wID | ) |
Destroy a modeless dialog window via its window ID.
Use this function to destroy a modeless dialog window using the window ID of the dialog (frame) window. This also causes the 'WBDialogWindow' structure to be destroyed. Use caution if you retained a pointer to it.
Header File: dialog_window.h
Definition at line 565 of file dialog_window.c.
void DLGDestroyDialogWindow2 | ( | WBDialogWindow * | pDialogWindow | ) |
Destroy a modeless dialog window via a pointer to its WBDialogWindow structure.
Use this function to destroy a modeless dialog window using the WBDialogWindow for the dialog (frame) window. This also causes the 'WBDialogWindow' structure to be destroyed. Use caution if you retained a pointer to it, to avoid re-using the (now) invalid pointer.
Header File: dialog_window.h
Definition at line 570 of file dialog_window.c.
Window DLGGetDialogControl | ( | WBDialogWindow * | pDialog, |
int | iControlID | ||
) |
returns the Window ID of a member control of the dialog window using the 'control ID'
To obtain the Window ID of a member control, using the control's ID, call this function.
Header File: dialog_window.h
Definition at line 1382 of file dialog_window.c.
WBDialogEntry* DLGGetDialogControlEntry | ( | WBDialogWindow * | pDialog, |
Window | idControl | ||
) |
returns a pointer to the WBDialogEntry for a member control using the control's Window ID
This is usually the preferred method of obtaining information about a dialog control. Call this function to obtain a pointer to the WBDialogEntry for a control, passing the WBDialogWindow pointer and the window ID. The return value from DLGGetDialogControl() can be passed directly as the control's Window ID.
Header File: dialog_window.h
Definition at line 1401 of file dialog_window.c.
|
static |
Returns a pointer to the dialog window's WBDialogWindow structure.
Use this function to obtain a pointer to the WBDialogWindow structure for the dialog (frame) window.
Header File: dialog_window.h
Definition at line 511 of file dialog_window.h.
void* DLGGetDialogWindowUserData | ( | Window | wID | ) |
Returns a pointer to the dialog window's 'user data' assigned at create time.
Use this function to obtain a pointer to the 'user data' for the dialog (frame) window. This function returns NULL if there is no WBDialogWindow structure associated with the window, or if there is no user data assigned.
Header File: dialog_window.h
Definition at line 1370 of file dialog_window.c.
Window DLGGetFirstDialogControl | ( | WBDialogWindow * | pDialog | ) |
Return the Window ID of the FIRST dialog control within the 'tab order'.
Each dialog window has what can be called a 'tab order' in which the FIRST control listed in the resource is the FIRST control in the tab order, the next control listed in the resource is the NEXT control, and so on. Tab order has nothing to do with the control's position within the dialog window. It is solely dependent on its order in the resource.
Header File: dialog_window.h
Definition at line 1420 of file dialog_window.c.
Window DLGGetNextDialogControl | ( | WBDialogWindow * | pDialog, |
Window | idControl | ||
) |
Return the Window ID of the NEXT dialog control within the 'tab order', based on the specified control window ID.
Each dialog window has what can be called a 'tab order' in which the FIRST control listed in the resource is the FIRST control in the tab order, the next control listed in the resource is the NEXT control, and so on. Tab order has nothing to do with the control's position within the dialog window. It is solely dependent on its order in the resource.
If the specified control ID is the LAST one, this function returns the FIRST dialog control's window ID
Header File: dialog_window.h
Definition at line 1430 of file dialog_window.c.
Window DLGGetPrevDialogControl | ( | WBDialogWindow * | pDialog, |
Window | idControl | ||
) |
Return the Window ID of the PREVIOUS dialog control within the 'tab order', based on the specified control window ID.
Each dialog window has what can be called a 'tab order' in which the FIRST control listed in the resource is the FIRST control in the tab order, the next control listed in the resource is the NEXT control, and so on. Tab order has nothing to do with the control's position within the dialog window. It is solely dependent on its order in the resource.
If the specified control ID is the FIRST one, this function returns the LAST dialog control's window ID
Header File: dialog_window.h
Definition at line 1454 of file dialog_window.c.
|
static |
Notify dialog window by calling the window's own callback function directly with an event.
Use this function when immediate notification is needed, and there is no possibility of a blocking call, recursion, or invalid state as a result of the event processing.
Header File: dialog_window.h
Definition at line 640 of file dialog_window.h.
|
static |
Notify dialog window by posting an event that will ASYNCHRONOUSLY be sent to the dialog window's callback function.
Use this function whenever immediate notification is NOT needed, or if there is a possibility of a blocking call, recursion, or invalid state as a result of a direct call to the window's callback function.
Header File: dialog_window.h
Definition at line 675 of file dialog_window.h.
int DLGPixelHeight | ( | WBDialogWindow * | pDlg, |
int | iHeight | ||
) |
Height of a single dialog unit (in pixels)
Return the height of a dialog unit, in pixels. Currently hard-coded to '1'
Header File: dialog_window.h
Definition at line 180 of file dialog_window.c.
int DLGPixelWidth | ( | WBDialogWindow * | pDlg, |
int | iWidth | ||
) |
Width of a single dialog unit (in pixels)
Return the width of a dialog unit, in pixels. Currently hard-coded to '1'
Header File: dialog_window.h
Definition at line 185 of file dialog_window.c.
void DLGRecalcLayout | ( | Window | wID | ) |
Force re-calculation of dialog window (and control) layout.
Forcing re-calculation of the layout implies that size, position, and content information is to be re-evaluated and updated, as needed, in an implementation-specific manner.
Header File: dialog_window.h
Definition at line 1363 of file dialog_window.c.
void DLGSetUserCallback | ( | WBDialogWindow * | pDLG, |
WBWinEvent | pCallBack | ||
) |
Assign the callback function for a dialog window.
The dialog's callback function is similar to that of a regular window, except that any events that are NOT handled (function returns zero) will be processed by a special 'default handler' that deals with the specific nuances associated with dialog windows. As a result it is important to be careful when processing certain kinds of events. When in doubt, return zero anyway.
NOTE: not all events will pass through the callback. Some are handled solely by the dialog window default processing
Header File: dialog_window.h
Definition at line 618 of file dialog_window.c.