combo_box_entry.h File Reference

Combo_Box_Entry Widget. More...

#include "ntw.h"

Go to the source code of this file.

Functions
char *	ntw_combo_box_entry_get_text (ntwWidget *widget)
	Get the current text of a combo_box_entry widget.
int	ntw_combo_box_entry_set_text (ntwWidget *widget, char *text)
	Set the current text of a combo_box_entry widget.
uint8	ntw_combo_box_entry_get_editable (ntwWidget *widget)
	Get combo_box_entry editability.
int	ntw_combo_box_entry_set_editable (ntwWidget *widget, uint8 editable)
	Set combo_box_entry editability.
int32	ntw_combo_box_entry_get_max_length (ntwWidget *widget)
	Get combo_box_entry maximum length.
int	ntw_combo_box_entry_set_max_length (ntwWidget *widget, int32 max_length)
	Set combo_box_entry maximum length.
uint8	ntw_combo_box_entry_get_visibility (ntwWidget *widget)
	Get combo_box_entry visibility.
int	ntw_combo_box_entry_set_visibility (ntwWidget *widget, uint8 visibility)
	Set combo_box_entry visibility.
ntwWidget *	ntw_combo_box_entry_new (ntwWidget *list_model, int32 column)
	Create combo_box_entry widget.
void	ntw_combo_box_entry_initialize_callback ()

---

Detailed Description

Combo_Box_Entry Widget.

This widget is a combination of a combo_box and an entry widget. An example would be the URL field in a browser bar, which might include a drop down menu of recently visited sites.

---

Function Documentation

uint8 ntw_combo_box_entry_get_editable (  ntwWidget *  widget  )

Get combo_box_entry editability. Get the status of the entry editable flag. Parameters: widget  combo_box_entry widget Returns: TRUE if editable, FALSE if not

int32 ntw_combo_box_entry_get_max_length (  ntwWidget *  widget  )

Get combo_box_entry maximum length. Get the bounds on the number of characters that may be typed in an entry widget. 0 means no limit. Parameters: widget  combo_box_entry widget Returns: Maximum length in characters.

char* ntw_combo_box_entry_get_text (  ntwWidget *  widget  )

Get the current text of a combo_box_entry widget. Parameters: widget  Entry widget Returns: Text string

uint8 ntw_combo_box_entry_get_visibility (  ntwWidget *  widget  )

Get combo_box_entry visibility. The visibility refers to whether or not the typed characters are echoed to the screen. If FALSE, the characters will be replaced by asterisks, as in a password field. Default is TRUE. Parameters: widget  combo_box_entry widget Returns: TRUE if characters will be visible, FALSE if characters will be hidden.

ntwWidget* ntw_combo_box_entry_new (  ntwWidget *  list_model, int32  column )

Create combo_box_entry widget. Parameters: list_model  List model used to populate drop-down menu column  column of list model to use Returns: Newly created combo_box

int ntw_combo_box_entry_set_editable (  ntwWidget *  widget, uint8  editable )

Set combo_box_entry editability. Set the ability of a user to change the text in an entry. TRUE is editable, FALSE is non-editable. Default is TRUE. Parameters: widget  combo_box_entry widget editable  TRUE for editable, FALSE otherwise Returns: -1 on failure

int ntw_combo_box_entry_set_max_length (  ntwWidget *  widget, int32  max_length )

Set combo_box_entry maximum length. Set the bounds on the number of characters that may be typed in an entry widget. 0 means no limit. Parameters: widget  combo_box_entry widget max_length  Maximum length in characters Returns: -1 on failure

int ntw_combo_box_entry_set_text (  ntwWidget *  widget, char *  text )

Set the current text of a combo_box_entry widget. Note that this is destructive, none of the old text will remain. Text string should be in UTF-8 format (ASCII text is valid UTF-8). Parameters: widget  combo_box_entry widget text  Text string to set Returns: -1 on failure

int ntw_combo_box_entry_set_visibility (  ntwWidget *  widget, uint8  visibility )

Set combo_box_entry visibility. The visibility refers to whether or not the typed characters are echoed to the screen. If FALSE, the characters will be replaced by asterisks, as in a password field. Default is TRUE. Parameters: widget  combo_box_entry widget visibility  TRUE or FALSE Returns: -1 on failure

---