diff options
author | inmarket <andrewh@inmarket.com.au> | 2014-05-09 21:25:31 +1000 |
---|---|---|
committer | inmarket <andrewh@inmarket.com.au> | 2014-05-09 21:25:31 +1000 |
commit | 9e8b38ba943b339b966b1011bab899720d6305fc (patch) | |
tree | f0b169569f380857e4ed7c3927d0197bcb5ec6ae /src/gwin/gwidget.h | |
parent | ca1a83abca9ecc159ff6f0d9e27ab133fb947997 (diff) | |
download | uGFX-9e8b38ba943b339b966b1011bab899720d6305fc.tar.gz uGFX-9e8b38ba943b339b966b1011bab899720d6305fc.tar.bz2 uGFX-9e8b38ba943b339b966b1011bab899720d6305fc.zip |
Add gwinClearInit() and gwinWidgetClearInit() to clear gwin initialisation structures.
Incorporate into demo's
Diffstat (limited to 'src/gwin/gwidget.h')
-rw-r--r-- | src/gwin/gwidget.h | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/src/gwin/gwidget.h b/src/gwin/gwidget.h index 96832fe3..8373e2d0 100644 --- a/src/gwin/gwidget.h +++ b/src/gwin/gwidget.h @@ -78,6 +78,10 @@ typedef void (*CustomWidgetDrawFunction)(struct GWidgetObject *gw, void *param); * @brief The structure to initialise a widget. * * @note Some widgets may have extra parameters. + * @note If you create this structure on the stack, you should always memset + * it to all zero's first in case a future version of the software + * add's extra fields. Alternatively you can use @p gwinWidgetClearInit() + * to clear it. * @note The text element must be static string (not stack allocated). If you want to use * a dynamic string (eg a stack allocated string) use NULL for this member and then call * @p gwinSetText() with useAlloc set to TRUE. @@ -127,6 +131,18 @@ extern "C" { #endif /** + * @brief Clear a GWidgetInit structure to all zero's + * @note This function is provided just to prevent problems + * on operating systems where using memset() causes issues + * in the users application. + * + * @param[in] pwi The GWidgetInit structure to clear + * + * @api + */ +void gwinWidgetClearInit(GWidgetInit *pwi); + +/** * @brief Set the default style for widgets created hereafter. * * @param[in] pstyle The default style. Passing NULL uses the system compiled style. |