NAME DtWsmAddCurrentWorkspaceCallback - add a callback to be called when the current workspace changes SYNOPSIS #include <Dt/Wsm.h> DtWsmCBContext DtWsmAddCurrentWorkspaceCallback(Widget widget, DtWsmWsChangeProc ws_change, Pointer client_data); DESCRIPTION The DtWsmAddCurrentWorkspaceCallback() function registers an application function to be called when the CDE workspace manager, dtwm(1), switches to a new workspace. The workspace manager sends the new current workspace name to the DtWsmWsChangeProc callback. The widget argument is a realized widget. The ws_change argument is the procedure to be called when the workspace changes. The client_data argument points to arbitrary client data to be passed back to ws_change. The header defines the DtWsmWsChangeProc callback prototype as follows: typedef void (*DtWsmWsChangeProc)(Widget widget, Atom aWorkspace, Pointer client_data); The widget argument is the ID of the widget to be registered with the callback. The aWorkspace argument is the name of the new current workspace (converted to an X atom). The client_data argument points to the client data to be registered with the callback. RETURN VALUE Upon successful completion, the DtWsmAddCurrentWorkspace- Callback() function returns a workspace callback registra- tion context. APPLICATION USAGE The DtWsmAddCurrentWorkspaceCallback() function returns a registration context that the application must save in order to remove this callback later. DtWsmAddCurrentWorkspace- Callback() requires a window; thus, a gadget is not accept- able for the widget argument. The DtWsmRemoveWorkspaceCall- back(3) function needs a registration context to remove the callback. SEE ALSO DtWsm(5), dtwm(1), DtWsmRemoveWorkspaceCallback(3).
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |