NAME DtWsmAddWorkspaceModifiedCallback - add a callback to be called when any workspace is changed SYNOPSIS #include <Dt/Wsm.h> DtWsmCBContext DtWsmAddWorkspaceModifiedCallback(Widget widget, DtWsmWsModifiedProc ws_change, Pointer client_data); DESCRIPTION The DtWsmAddWorkspaceModifiedCallback() function works with the CDE workspace manager, dtwm(1), and registers a function to be called when a workspace is added, deleted or modified. The widget argument is a realized widget. The ws_change argument is the procedure to be called when a workspace is modified. The client_data argument points to arbitrary client data to be passed back to ws_change. The header defines the DtWsmWsModifiedProc callback proto- type as follows: typedef void (*DtWsmWsModifiedProc)(Widget widget, Atom aWorkspace, DtWsmWsReason reason, 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 reason argument is a type of modification: DtWSM_REASON_ADD A new workspace was added. DtWSM_REASON_BACKDROP The backdrop for the workspace changed. DtWSM_REASON_CURRENT A different workspace was made the current workspace. DtWSM_REASON_DELETE A workspace was deleted. DtWSM_REASON_TITLE The workspace title changed. The client_data argument points to the client data to be registered with the callback. RETURN VALUE Upon successful completion, the DtWsmAddWorkspaceModified- Callback() function returns a workspace callback registra- tion context. APPLICATION USAGE The DtWsmAddWorkspaceModifiedCallback() function returns a registration context that the application must save in order to remove this callback later. DtWsmAddWorkspaceModifiedCallback() requires a window; thus, a gadget is not acceptable for the widget argument. The DtWsmRemoveWorkspaceCallback(3) function needs a regis- tration context to remove the callback. SEE ALSO DtWsm(5), dtwm(1), DtWsmGetWorkspaceInfo(3), DtWsmGetWorkspaceList(3), DtWsmRemoveWorkspaceCallback(3).
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |