ref: bda24e56c062c08a1d0f885afd519e915c177f2a
dir: /textscreen/txt_button.h/
// // Copyright(C) 2005-2014 Simon Howard // // This program is free software; you can redistribute it and/or // modify it under the terms of the GNU General Public License // as published by the Free Software Foundation; either version 2 // of the License, or (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // #ifndef TXT_BUTTON_H #define TXT_BUTTON_H /** * @file txt_button.h * * Button widget. */ /** * Button widget. * * A button is a widget that can be selected to perform some action. * When a button is pressed, it emits the "pressed" signal. */ typedef struct txt_button_s txt_button_t; #include "txt_widget.h" struct txt_button_s { txt_widget_t widget; char *label; }; /** * Create a new button widget. * * @param label The label to use on the new button (UTF-8 format). * @return Pointer to the new button widget. */ txt_button_t *TXT_NewButton(const char *label); /** * Create a new button widget, binding the "pressed" signal to a * specified callback function. * * @param label The label to use on the new button (UTF-8 format). * @param func The callback function to invoke. * @param user_data User-specified pointer to pass to the callback. * @return Pointer to the new button widget. */ txt_button_t *TXT_NewButton2(const char *label, TxtWidgetSignalFunc func, void *user_data); /** * Change the label used on a button. * * @param button The button. * @param label The new label (UTF-8 format). */ void TXT_SetButtonLabel(txt_button_t *button, const char *label); #endif /* #ifndef TXT_BUTTON_H */