libui-ng
A portable GUI library for C
|
A control with a single line text entry field. More...
#include <ui.h>
Public Member Functions | |
char * | uiEntryText (uiEntry *e) |
Returns the entry's text. More... | |
void | uiEntrySetText (uiEntry *e, const char *text) |
Sets the entry's text. More... | |
void | uiEntryOnChanged (uiEntry *e, void(*f)(uiEntry *sender, void *senderData), void *data) |
Registers a callback for when the user changes the entry's text. More... | |
int | uiEntryReadOnly (uiEntry *e) |
Returns whether or not the entry's text can be changed. More... | |
void | uiEntrySetReadOnly (uiEntry *e, int readonly) |
Sets whether or not the entry's text is read only. More... | |
uiEntry * | uiNewEntry (void) |
Creates a new entry. More... | |
uiEntry * | uiNewPasswordEntry (void) |
Creates a new entry suitable for sensitive inputs like passwords. More... | |
uiEntry * | uiNewSearchEntry (void) |
Creates a new entry suitable for search. More... | |
Public Member Functions inherited from uiControl | |
void | uiControlDestroy (uiControl *c) |
Dispose and free all allocated resources. More... | |
uintptr_t | uiControlHandle (uiControl *c) |
Returns the control's OS-level handle. More... | |
uiControl * | uiControlParent (uiControl *c) |
Returns the parent control. More... | |
void | uiControlSetParent (uiControl *c, uiControl *parent) |
Sets the control's parent. More... | |
int | uiControlToplevel (uiControl *c) |
Returns whether or not the control is a top level control. More... | |
int | uiControlVisible (uiControl *c) |
Returns whether or not the control is visible. More... | |
void | uiControlShow (uiControl *c) |
Shows the control. More... | |
void | uiControlHide (uiControl *c) |
Hides the control. More... | |
int | uiControlEnabled (uiControl *c) |
Returns whether or not the control is enabled. More... | |
void | uiControlEnable (uiControl *c) |
Enables the control. More... | |
void | uiControlDisable (uiControl *c) |
Disables the control. More... | |
uiControl * | uiAllocControl (size_t n, uint32_t OSsig, uint32_t typesig, const char *typenamestr) |
Allocates a uiControl. More... | |
void | uiFreeControl (uiControl *c) |
Frees the memory associated with the control reference. More... | |
void | uiControlVerifySetParent (uiControl *c, uiControl *parent) |
Makes sure the control's parent can be set to parent . More... | |
int | uiControlEnabledToUser (uiControl *c) |
Returns whether or not the control can be interacted with by the user. More... | |
Additional Inherited Members | |
Public Attributes inherited from uiControl | |
uint32_t | Signature |
uint32_t | OSSignature |
uint32_t | TypeSignature |
void(* | Destroy )(uiControl *) |
uintptr_t(* | Handle )(uiControl *) |
uiControl *(* | Parent )(uiControl *) |
void(* | SetParent )(uiControl *, uiControl *) |
int(* | Toplevel )(uiControl *) |
int(* | Visible )(uiControl *) |
void(* | Show )(uiControl *) |
void(* | Hide )(uiControl *) |
int(* | Enabled )(uiControl *) |
void(* | Enable )(uiControl *) |
void(* | Disable )(uiControl *) |
A control with a single line text entry field.
Registers a callback for when the user changes the entry's text.
e | uiEntry instance. |
f | Callback function.sender Back reference to the instance that initiated the callback.senderData User data registered with the sender instance. |
data | User data to be passed to the callback. |
int uiEntryReadOnly | ( | uiEntry * | e | ) |
Returns whether or not the entry's text can be changed.
e | uiEntry instance. |
TRUE
if read only, FALSE
otherwise. [Default: FALSE
] void uiEntrySetReadOnly | ( | uiEntry * | e, |
int | readonly | ||
) |
Sets whether or not the entry's text is read only.
e | uiEntry instance. |
readonly | TRUE to make read only, FALSE otherwise. |
void uiEntrySetText | ( | uiEntry * | e, |
const char * | text | ||
) |
Sets the entry's text.
e | uiEntry instance. |
text | Entry text. A valid, NUL terminated UTF-8 string.Data is copied internally. Ownership is not transferred. |
char * uiEntryText | ( | uiEntry * | e | ) |
Returns the entry's text.
e | uiEntry instance. |
NUL
terminated UTF-8 string.uiFreeText()
. uiEntry * uiNewPasswordEntry | ( | void | ) |
Creates a new entry suitable for sensitive inputs like passwords.
The entered text is NOT readable by the user but masked as *******.
uiEntry * uiNewSearchEntry | ( | void | ) |
Creates a new entry suitable for search.
Some systems will deliberately delay the uiEntryOnChanged() callback for a more natural feel.