comparison ios/dw.m @ 2711:00e42b9c9ebc

iOS: Similarly update the comments on unimplmented functions... a unofficial audit of the code to see where things stand for beta release by end of year.
author bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date Mon, 22 Nov 2021 06:44:47 +0000
parents ddcbed595a84
children ada3ac4677f6
comparison
equal deleted inserted replaced
2710:98cc4476b376 2711:00e42b9c9ebc
6878 * icon: Icon handle to display in the taskbar. 6878 * icon: Icon handle to display in the taskbar.
6879 * bubbletext: Text to show when the mouse is above the icon. 6879 * bubbletext: Text to show when the mouse is above the icon.
6880 */ 6880 */
6881 void API dw_taskbar_insert(HWND handle, HICN icon, const char *bubbletext) 6881 void API dw_taskbar_insert(HWND handle, HICN icon, const char *bubbletext)
6882 { 6882 {
6883 /* Taskbar unsupported on iOS */
6883 } 6884 }
6884 6885
6885 /* 6886 /*
6886 * Deletes an icon from the taskbar. 6887 * Deletes an icon from the taskbar.
6887 * Parameters: 6888 * Parameters:
6888 * handle: Window handle that was used with dw_taskbar_insert(). 6889 * handle: Window handle that was used with dw_taskbar_insert().
6889 * icon: Icon handle that was used with dw_taskbar_insert(). 6890 * icon: Icon handle that was used with dw_taskbar_insert().
6890 */ 6891 */
6891 void API dw_taskbar_delete(HWND handle, HICN icon) 6892 void API dw_taskbar_delete(HWND handle, HICN icon)
6892 { 6893 {
6894 /* Taskbar unsupported on iOS */
6893 } 6895 }
6894 6896
6895 /* Internal function to keep HICNs from getting too big */ 6897 /* Internal function to keep HICNs from getting too big */
6896 UIImage *_dw_icon_resize(UIImage *image) 6898 UIImage *_dw_icon_resize(UIImage *image)
6897 { 6899 {
7227 * dw_pixmap_new.. 7229 * dw_pixmap_new..
7228 * color: transparent color 7230 * color: transparent color
7229 * Note: This does nothing on Mac as transparency 7231 * Note: This does nothing on Mac as transparency
7230 * is handled automatically 7232 * is handled automatically
7231 */ 7233 */
7232 void API dw_pixmap_set_transparent_color( HPIXMAP pixmap, ULONG color ) 7234 void API dw_pixmap_set_transparent_color(HPIXMAP pixmap, ULONG color)
7233 { 7235 {
7234 /* Don't do anything */ 7236 /* Don't do anything, all images support transparency on iOS */
7235 } 7237 }
7236 7238
7237 /* 7239 /*
7238 * Creates a pixmap from internal resource graphic specified by id. 7240 * Creates a pixmap from internal resource graphic specified by id.
7239 * Parameters: 7241 * Parameters:
8044 * pageid: Page ID of the tab to set. 8046 * pageid: Page ID of the tab to set.
8045 * text: Pointer to the text to set. 8047 * text: Pointer to the text to set.
8046 */ 8048 */
8047 void API dw_notebook_page_set_status_text(HWND handle, ULONG pageid, const char *text) 8049 void API dw_notebook_page_set_status_text(HWND handle, ULONG pageid, const char *text)
8048 { 8050 {
8049 /* Note supported here... do nothing */ 8051 /* Not supported here... do nothing */
8050 } 8052 }
8051 8053
8052 /* 8054 /*
8053 * Packs the specified box into the notebook page. 8055 * Packs the specified box into the notebook page.
8054 * Parameters: 8056 * Parameters:
8302 * handle: The window (widget) handle. 8304 * handle: The window (widget) handle.
8303 * border: Size of the window border in pixels. 8305 * border: Size of the window border in pixels.
8304 */ 8306 */
8305 int API dw_window_set_border(HWND handle, int border) 8307 int API dw_window_set_border(HWND handle, int border)
8306 { 8308 {
8307 return 0; 8309 /* No overlapping windows on iOS, unsupported */
8310 return DW_ERROR_UNKNOWN;
8308 } 8311 }
8309 8312
8310 /* 8313 /*
8311 * Sets the style of a given window (widget). 8314 * Sets the style of a given window (widget).
8312 * Parameters: 8315 * Parameters:
8998 * Parameters: 9001 * Parameters:
8999 * handle: The window handle to minimize. 9002 * handle: The window handle to minimize.
9000 */ 9003 */
9001 int API dw_window_minimize(HWND handle) 9004 int API dw_window_minimize(HWND handle)
9002 { 9005 {
9003 return 0; 9006 /* TODO: Not sure if we should do anything here on iOS */
9007 return DW_ERROR_GENERAL;
9004 } 9008 }
9005 9009
9006 /* Causes entire window to be invalidated and redrawn. 9010 /* Causes entire window to be invalidated and redrawn.
9007 * Parameters: 9011 * Parameters:
9008 * handle: Toplevel window handle to be redrawn. 9012 * handle: Toplevel window handle to be redrawn.
9020 * Parameters: 9024 * Parameters:
9021 * handle: The window handle to make topmost. 9025 * handle: The window handle to make topmost.
9022 */ 9026 */
9023 int API dw_window_raise(HWND handle) 9027 int API dw_window_raise(HWND handle)
9024 { 9028 {
9025 return 0; 9029 /* TODO: Not sure if we should do anything here on iOS */
9030 return DW_ERROR_GENERAL;
9026 } 9031 }
9027 9032
9028 /* 9033 /*
9029 * Makes the window bottommost. 9034 * Makes the window bottommost.
9030 * Parameters: 9035 * Parameters:
9031 * handle: The window handle to make bottommost. 9036 * handle: The window handle to make bottommost.
9032 */ 9037 */
9033 int API dw_window_lower(HWND handle) 9038 int API dw_window_lower(HWND handle)
9034 { 9039 {
9035 return 0; 9040 /* TODO: Not sure if we should do anything here on iOS */
9041 return DW_ERROR_GENERAL;
9036 } 9042 }
9037 9043
9038 /* 9044 /*
9039 * Sets the size of a given window (widget). 9045 * Sets the size of a given window (widget).
9040 * Parameters: 9046 * Parameters:
9113 * width: Width of the widget. 9119 * width: Width of the widget.
9114 * height: Height of the widget. 9120 * height: Height of the widget.
9115 */ 9121 */
9116 void API dw_window_set_pos_size(HWND handle, LONG x, LONG y, ULONG width, ULONG height) 9122 void API dw_window_set_pos_size(HWND handle, LONG x, LONG y, ULONG width, ULONG height)
9117 { 9123 {
9124 /* iOS windows take up the whole screen */
9118 } 9125 }
9119 9126
9120 /* 9127 /*
9121 * Gets the position and size of a given window (widget). 9128 * Gets the position and size of a given window (widget).
9122 * Parameters: 9129 * Parameters:
10832 * Returns: 10839 * Returns:
10833 * A handle to the print object or NULL on failure. 10840 * A handle to the print object or NULL on failure.
10834 */ 10841 */
10835 HPRINT API dw_print_new(const char *jobname, unsigned long flags, unsigned int pages, void *drawfunc, void *drawdata) 10842 HPRINT API dw_print_new(const char *jobname, unsigned long flags, unsigned int pages, void *drawfunc, void *drawdata)
10836 { 10843 {
10844 /* TODO: Implement printing on iOS */
10837 return NULL; 10845 return NULL;
10838 } 10846 }
10839 10847
10840 /* 10848 /*
10841 * Runs the print job, causing the draw page callbacks to fire. 10849 * Runs the print job, causing the draw page callbacks to fire.
10845 * Returns: 10853 * Returns:
10846 * DW_ERROR_UNKNOWN on error or DW_ERROR_NONE on success. 10854 * DW_ERROR_UNKNOWN on error or DW_ERROR_NONE on success.
10847 */ 10855 */
10848 int API dw_print_run(HPRINT print, unsigned long flags) 10856 int API dw_print_run(HPRINT print, unsigned long flags)
10849 { 10857 {
10858 /* TODO: Implement printing on iOS */
10850 return DW_ERROR_UNKNOWN; 10859 return DW_ERROR_UNKNOWN;
10851 } 10860 }
10852 10861
10853 /* 10862 /*
10854 * Cancels the print job, typically called from a draw page callback. 10863 * Cancels the print job, typically called from a draw page callback.
10855 * Parameters: 10864 * Parameters:
10856 * print: Handle to the print object returned by dw_print_new(). 10865 * print: Handle to the print object returned by dw_print_new().
10857 */ 10866 */
10858 void API dw_print_cancel(HPRINT print) 10867 void API dw_print_cancel(HPRINT print)
10859 { 10868 {
10869 /* TODO: Implement printing on iOS */
10860 } 10870 }
10861 10871
10862 /* 10872 /*
10863 * Converts a UTF-8 encoded string into a wide string. 10873 * Converts a UTF-8 encoded string into a wide string.
10864 * Parameters: 10874 * Parameters: