comparison os2/dw.c @ 2088:94ea915bd917

Win: Initial implementation of notifications on Windows. Currently using WinToast. Update readme regarding WinToast support and in-source comments regarding the API. Fix missing "API" calling conventions on OS/2 and Windows.
author bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date Fri, 05 Jun 2020 16:27:00 +0000
parents 24875681eec5
children cdb94c6fd611
comparison
equal deleted inserted replaced
2087:082d743f3214 2088:94ea915bd917
12404 * or NULL if it fails or notifications are not supported by the system. 12404 * or NULL if it fails or notifications are not supported by the system.
12405 * Remarks: 12405 * Remarks:
12406 * This will create a system notification that will show in the notifaction panel 12406 * This will create a system notification that will show in the notifaction panel
12407 * on supported systems, which may be clicked to perform another task. 12407 * on supported systems, which may be clicked to perform another task.
12408 */ 12408 */
12409 HWND dw_notification_new(const char *title, HPIXMAP pixmap, const char *description, ...) 12409 HWND API dw_notification_new(const char *title, HPIXMAP pixmap, const char *description, ...)
12410 { 12410 {
12411 return NULL; 12411 return NULL;
12412 } 12412 }
12413 12413
12414 /* 12414 /*
12416 * Parameters: 12416 * Parameters:
12417 * notification: The handle to the notification returned by dw_notification_new(). 12417 * notification: The handle to the notification returned by dw_notification_new().
12418 * Returns: 12418 * Returns:
12419 * DW_ERROR_NONE on success, DW_ERROR_UNKNOWN on error or not supported. 12419 * DW_ERROR_NONE on success, DW_ERROR_UNKNOWN on error or not supported.
12420 */ 12420 */
12421 int dw_notification_send(HWND notification) 12421 int API dw_notification_send(HWND notification)
12422 { 12422 {
12423 return DW_ERROR_UNKNOWN; 12423 return DW_ERROR_UNKNOWN;
12424 } 12424 }
12425 12425
12426 /* 12426 /*
13309 13309
13310 /* 13310 /*
13311 * Sets the application ID used by this Dynamic Windows application instance. 13311 * Sets the application ID used by this Dynamic Windows application instance.
13312 * Parameters: 13312 * Parameters:
13313 * appid: A string typically in the form: com.company.division.application 13313 * appid: A string typically in the form: com.company.division.application
13314 * appguid: A globally unique identifier required on Windows or NULL. 13314 * appname: The application name used on Windows or NULL.
13315 * Returns: 13315 * Returns:
13316 * DW_ERROR_NONE after successfully setting the application ID. 13316 * DW_ERROR_NONE after successfully setting the application ID.
13317 * DW_ERROR_UNKNOWN if unsupported on this system. 13317 * DW_ERROR_UNKNOWN if unsupported on this system.
13318 * DW_ERROR_GENERAL if the application ID is not allowed. 13318 * DW_ERROR_GENERAL if the application ID is not allowed.
13319 * Remarks: 13319 * Remarks:
13320 * This must be called before dw_init(). If dw_init() is called first 13320 * This must be called before dw_init(). If dw_init() is called first
13321 * it will create a unique ID in the form: org.dbsoft.dwindows.application 13321 * it will create a unique ID in the form: org.dbsoft.dwindows.application
13322 * or if the application name cannot be detected: org.dbsoft.dwindows.pid.# 13322 * or if the application name cannot be detected: org.dbsoft.dwindows.pid.#
13323 * The GUID is only required on Windows, NULL can be passed on other platforms. 13323 * The appname is only required on Windows. If NULL is passed the detected
13324 */ 13324 * application name will be used, but a prettier name may be desired.
13325 int dw_app_id_set(const char *appid, const char *appguid) 13325 */
13326 int API dw_app_id_set(const char *appid, const char *appname)
13326 { 13327 {
13327 return DW_ERROR_UNKNOWN; 13328 return DW_ERROR_UNKNOWN;
13328 } 13329 }
13329 13330
13330 /* 13331 /*