![]() |
![]() |
![]() |
MATE UI Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals |
#include <libmateui/libmateui.h> MateEntryPrivate; struct MateEntry; GtkWidget * mate_entry_new (const gchar *history_id
); GtkWidget * mate_entry_gtk_entry (MateEntry *gentry
); const gchar * mate_entry_get_history_id (MateEntry *gentry
); void mate_entry_set_history_id (MateEntry *gentry
,const gchar *history_id
); void mate_entry_set_max_saved (MateEntry *gentry
,guint max_saved
); guint mate_entry_get_max_saved (MateEntry *gentry
); void mate_entry_prepend_history (MateEntry *gentry
,gboolean save
,const gchar *text
); void mate_entry_append_history (MateEntry *gentry
,gboolean save
,const gchar *text
); void mate_entry_clear_history (MateEntry *gentry
);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkHBox +----GtkCombo +----MateEntry
MateEntry implements AtkImplementorIface, GtkBuildable, GtkOrientable and GtkEditable.
typedef struct _MateEntryPrivate MateEntryPrivate;
MateEntryPrivate
is deprecated and should not be used in newly-written code.
struct MateEntry;
MateEntry
is deprecated and should not be used in newly-written code.
GtkWidget * mate_entry_new (const gchar *history_id
);
mate_entry_new
is deprecated and should not be used in newly-written code.
Creates a new MateEntry widget. If history_id
is
not NULL
, then the history list will be saved and restored between
uses under the given id.
|
If not NULL , the text id under which history data is stored
|
Returns : |
Newly-created MateEntry widget. |
GtkWidget * mate_entry_gtk_entry (MateEntry *gentry
);
mate_entry_gtk_entry
is deprecated and should not be used in newly-written code.
Obtain pointer to MateEntry's internal text entry
|
Pointer to MateEntry object. |
Returns : |
Pointer to GtkEntry widget. |
const gchar * mate_entry_get_history_id (MateEntry *gentry
);
mate_entry_get_history_id
is deprecated and should not be used in newly-written code.
Returns the current history id of the MateEntry widget.
|
Pointer to MateEntry object. |
Returns : |
The current history id. |
void mate_entry_set_history_id (MateEntry *gentry
,const gchar *history_id
);
mate_entry_set_history_id
is deprecated and should not be used in newly-written code.
Set the id of the history list. This function cannot be used to change and already existing id.
|
Pointer to MateEntry object. |
|
the text id under which history data is stored |
void mate_entry_set_max_saved (MateEntry *gentry
,guint max_saved
);
mate_entry_set_max_saved
is deprecated and should not be used in newly-written code.
Set internal limit on number of history items saved
to the config file.
Zero is an acceptable value for max_saved
, but the same thing is
accomplished by setting the history id of gentry
to NULL
.
|
Pointer to MateEntry object. |
|
Maximum number of history items to save |
guint mate_entry_get_max_saved (MateEntry *gentry
);
mate_entry_get_max_saved
is deprecated and should not be used in newly-written code.
Get internal limit on number of history items saved
to the config file
See #mate_entry_set_max_saved()
.
|
Pointer to MateEntry object. |
Returns : |
An unsigned integer |
void mate_entry_prepend_history (MateEntry *gentry
,gboolean save
,const gchar *text
);
mate_entry_prepend_history
is deprecated and should not be used in newly-written code.
Adds a history item of the given text
to the head of
the history list inside gentry
. If save
is TRUE
, the history
item will be saved in the config file (assuming that gentry
's
history id is not NULL
).
Duplicates are automatically removed from the history list.
The history list is automatically saved if needed.
|
Pointer to MateEntry object. |
|
If TRUE , history entry will be saved to config file
|
|
Text to add |
void mate_entry_append_history (MateEntry *gentry
,gboolean save
,const gchar *text
);
mate_entry_append_history
is deprecated and should not be used in newly-written code.
Adds a history item of the given text
to the tail
of the history list inside gentry
. If save
is TRUE
, the
history item will be saved in the config file (assuming that
gentry
's history id is not NULL
).
Duplicates are automatically removed from the history list.
The history list is automatically saved if needed.
|
Pointer to MateEntry object. |
|
If TRUE , history entry will be saved to config file
|
|
Text to add |
void mate_entry_clear_history (MateEntry *gentry
);
mate_entry_clear_history
is deprecated and should not be used in newly-written code.
Clears the history.
|
Pointer to MateEntry object. |
"activate"
signalvoid user_function (MateEntry *entry,
gpointer user_data) : Run Last
|
the object which received the signal. |
|
user data set when the signal handler was connected. |