| GTK+ 3 Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Style Properties | Signals |
#include <gtk/gtk.h> struct GtkEntry; GtkWidget * gtk_entry_new (void
); GtkWidget * gtk_entry_new_with_buffer (GtkEntryBuffer *buffer
); GtkEntryBuffer * gtk_entry_get_buffer (GtkEntry *entry
); void gtk_entry_set_buffer (GtkEntry *entry
,GtkEntryBuffer *buffer
); void gtk_entry_set_text (GtkEntry *entry
,const gchar *text
); const gchar * gtk_entry_get_text (GtkEntry *entry
); guint16 gtk_entry_get_text_length (GtkEntry *entry
); void gtk_entry_get_text_area (GtkEntry *entry
,GdkRectangle *text_area
); void gtk_entry_set_visibility (GtkEntry *entry
,gboolean visible
); void gtk_entry_set_invisible_char (GtkEntry *entry
,gunichar ch
); void gtk_entry_unset_invisible_char (GtkEntry *entry
); void gtk_entry_set_max_length (GtkEntry *entry
,gint max
); gboolean gtk_entry_get_activates_default (GtkEntry *entry
); gboolean gtk_entry_get_has_frame (GtkEntry *entry
); const GtkBorder * gtk_entry_get_inner_border (GtkEntry *entry
); gint gtk_entry_get_width_chars (GtkEntry *entry
); void gtk_entry_set_activates_default (GtkEntry *entry
,gboolean setting
); void gtk_entry_set_has_frame (GtkEntry *entry
,gboolean setting
); void gtk_entry_set_inner_border (GtkEntry *entry
,const GtkBorder *border
); void gtk_entry_set_width_chars (GtkEntry *entry
,gint n_chars
); gunichar gtk_entry_get_invisible_char (GtkEntry *entry
); void gtk_entry_set_alignment (GtkEntry *entry
,gfloat xalign
); gfloat gtk_entry_get_alignment (GtkEntry *entry
); void gtk_entry_set_placeholder_text (GtkEntry *entry
,const gchar *text
); const gchar * gtk_entry_get_placeholder_text (GtkEntry *entry
); void gtk_entry_set_overwrite_mode (GtkEntry *entry
,gboolean overwrite
); gboolean gtk_entry_get_overwrite_mode (GtkEntry *entry
); PangoLayout * gtk_entry_get_layout (GtkEntry *entry
); void gtk_entry_get_layout_offsets (GtkEntry *entry
,gint *x
,gint *y
); gint gtk_entry_layout_index_to_text_index (GtkEntry *entry
,gint layout_index
); gint gtk_entry_text_index_to_layout_index (GtkEntry *entry
,gint text_index
); void gtk_entry_set_attributes (GtkEntry *entry
,PangoAttrList *attrs
); PangoAttrList * gtk_entry_get_attributes (GtkEntry *entry
); gint gtk_entry_get_max_length (GtkEntry *entry
); gboolean gtk_entry_get_visibility (GtkEntry *entry
); void gtk_entry_set_completion (GtkEntry *entry
,GtkEntryCompletion *completion
); GtkEntryCompletion * gtk_entry_get_completion (GtkEntry *entry
); void gtk_entry_set_cursor_hadjustment (GtkEntry *entry
,GtkAdjustment *adjustment
); GtkAdjustment * gtk_entry_get_cursor_hadjustment (GtkEntry *entry
); void gtk_entry_set_progress_fraction (GtkEntry *entry
,gdouble fraction
); gdouble gtk_entry_get_progress_fraction (GtkEntry *entry
); void gtk_entry_set_progress_pulse_step (GtkEntry *entry
,gdouble fraction
); gdouble gtk_entry_get_progress_pulse_step (GtkEntry *entry
); void gtk_entry_progress_pulse (GtkEntry *entry
); gboolean gtk_entry_im_context_filter_keypress (GtkEntry *entry
,GdkEventKey *event
); void gtk_entry_reset_im_context (GtkEntry *entry
); enum GtkEntryIconPosition; void gtk_entry_set_icon_from_pixbuf (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,GdkPixbuf *pixbuf
); void gtk_entry_set_icon_from_stock (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,const gchar *stock_id
); void gtk_entry_set_icon_from_icon_name (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,const gchar *icon_name
); void gtk_entry_set_icon_from_gicon (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,GIcon *icon
); GtkImageType gtk_entry_get_icon_storage_type (GtkEntry *entry
,GtkEntryIconPosition icon_pos
); GdkPixbuf * gtk_entry_get_icon_pixbuf (GtkEntry *entry
,GtkEntryIconPosition icon_pos
); const gchar * gtk_entry_get_icon_stock (GtkEntry *entry
,GtkEntryIconPosition icon_pos
); const gchar * gtk_entry_get_icon_name (GtkEntry *entry
,GtkEntryIconPosition icon_pos
); GIcon * gtk_entry_get_icon_gicon (GtkEntry *entry
,GtkEntryIconPosition icon_pos
); void gtk_entry_set_icon_activatable (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,gboolean activatable
); gboolean gtk_entry_get_icon_activatable (GtkEntry *entry
,GtkEntryIconPosition icon_pos
); void gtk_entry_set_icon_sensitive (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,gboolean sensitive
); gboolean gtk_entry_get_icon_sensitive (GtkEntry *entry
,GtkEntryIconPosition icon_pos
); gint gtk_entry_get_icon_at_pos (GtkEntry *entry
,gint x
,gint y
); void gtk_entry_set_icon_tooltip_text (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,const gchar *tooltip
); gchar * gtk_entry_get_icon_tooltip_text (GtkEntry *entry
,GtkEntryIconPosition icon_pos
); void gtk_entry_set_icon_tooltip_markup (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,const gchar *tooltip
); gchar * gtk_entry_get_icon_tooltip_markup (GtkEntry *entry
,GtkEntryIconPosition icon_pos
); void gtk_entry_set_icon_drag_source (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,GtkTargetList *target_list
,GdkDragAction actions
); gint gtk_entry_get_current_icon_drag_source (GtkEntry *entry
); void gtk_entry_get_icon_area (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,GdkRectangle *icon_area
); enum GtkInputPurpose; void gtk_entry_set_input_purpose (GtkEntry *entry
,GtkInputPurpose purpose
); GtkInputPurpose gtk_entry_get_input_purpose (GtkEntry *entry
); enum GtkInputHints; void gtk_entry_set_input_hints (GtkEntry *entry
,GtkInputHints hints
); GtkInputHints gtk_entry_get_input_hints (GtkEntry *entry
);
GObject +----GInitiallyUnowned +----GtkWidget +----GtkEntry +----GtkSearchEntry +----GtkSpinButton
GtkEntry implements AtkImplementorIface, GtkBuildable, GtkEditable and GtkCellEditable.
"activates-default" gboolean : Read / Write "attributes" PangoAttrList* : Read / Write "buffer" GtkEntryBuffer* : Read / Write / Construct "caps-lock-warning" gboolean : Read / Write "completion" GtkEntryCompletion* : Read / Write "cursor-position" gint : Read "editable" gboolean : Read / Write "has-frame" gboolean : Read / Write "im-module" gchar* : Read / Write "inner-border" GtkBorder* : Read / Write "input-hints" GtkInputHints : Read / Write "input-purpose" GtkInputPurpose : Read / Write "invisible-char" guint : Read / Write "invisible-char-set" gboolean : Read / Write "max-length" gint : Read / Write "overwrite-mode" gboolean : Read / Write "placeholder-text" gchar* : Read / Write "primary-icon-activatable" gboolean : Read / Write "primary-icon-gicon" GIcon* : Read / Write "primary-icon-name" gchar* : Read / Write "primary-icon-pixbuf" GdkPixbuf* : Read / Write "primary-icon-sensitive" gboolean : Read / Write "primary-icon-stock" gchar* : Read / Write "primary-icon-storage-type" GtkImageType : Read "primary-icon-tooltip-markup" gchar* : Read / Write "primary-icon-tooltip-text" gchar* : Read / Write "progress-fraction" gdouble : Read / Write "progress-pulse-step" gdouble : Read / Write "scroll-offset" gint : Read "secondary-icon-activatable" gboolean : Read / Write "secondary-icon-gicon" GIcon* : Read / Write "secondary-icon-name" gchar* : Read / Write "secondary-icon-pixbuf" GdkPixbuf* : Read / Write "secondary-icon-sensitive" gboolean : Read / Write "secondary-icon-stock" gchar* : Read / Write "secondary-icon-storage-type" GtkImageType : Read "secondary-icon-tooltip-markup" gchar* : Read / Write "secondary-icon-tooltip-text" gchar* : Read / Write "selection-bound" gint : Read "shadow-type" GtkShadowType : Read / Write "text" gchar* : Read / Write "text-length" guint : Read "truncate-multiline" gboolean : Read / Write "visibility" gboolean : Read / Write "width-chars" gint : Read / Write "xalign" gfloat : Read / Write
"icon-prelight" gboolean : Read "inner-border" GtkBorder* : Read "invisible-char" guint : Read "progress-border" GtkBorder* : Read
"activate" :Action
"backspace" :Action
"copy-clipboard" :Action
"cut-clipboard" :Action
"delete-from-cursor" :Action
"icon-press" :Run Last
"icon-release" :Run Last
"insert-at-cursor" :Action
"move-cursor" :Action
"paste-clipboard" :Action
"populate-popup" :Run Last
"preedit-changed" :Action
"toggle-overwrite" :Action
The GtkEntry widget is a single line text entry widget. A fairly large set of key bindings are supported by default. If the entered text is longer than the allocation of the widget, the widget will scroll so that the cursor position is visible.
When using an entry for passwords and other sensitive information,
it can be put into "password mode" using gtk_entry_set_visibility()
.
In this mode, entered text is displayed using a 'invisible' character.
By default, GTK+ picks the best invisible character that is available
in the current font, but it can be changed with
gtk_entry_set_invisible_char()
. Since 2.16, GTK+ displays a warning
when Caps Lock or input methods might interfere with entering text in
a password entry. The warning can be turned off with the
"caps-lock-warning" property.
Since 2.16, GtkEntry has the ability to display progress or activity
information behind the text. To make an entry display such information,
use gtk_entry_set_progress_fraction()
or gtk_entry_set_progress_pulse_step()
.
Additionally, GtkEntry can show icons at either side of the entry. These
icons can be activatable by clicking, can be set up as drag source and
can have tooltips. To add an icon, use gtk_entry_set_icon_from_gicon()
or
one of the various other functions that set an icon from a stock id, an
icon name or a pixbuf. To trigger an action when the user clicks an icon,
connect to the "icon-press" signal. To allow DND operations
from an icon, use gtk_entry_set_icon_drag_source()
. To set a tooltip on
an icon, use gtk_entry_set_icon_tooltip_text()
or the corresponding function
for markup.
Note that functionality or information that is only available by clicking on an icon in an entry may not be accessible at all to users which are not able to use a mouse or other pointing device. It is therefore recommended that any such functionality should also be available by other means, e.g. via the context menu of the entry.
GtkWidget * gtk_entry_new_with_buffer (GtkEntryBuffer *buffer
);
Creates a new entry with the specified text buffer.
Since 2.18
GtkEntryBuffer * gtk_entry_get_buffer (GtkEntry *entry
);
Get the GtkEntryBuffer object which holds the text for this widget.
|
a GtkEntry |
Returns : |
A GtkEntryBuffer object. [transfer none] |
Since 2.18
void gtk_entry_set_buffer (GtkEntry *entry
,GtkEntryBuffer *buffer
);
Set the GtkEntryBuffer object which holds the text for this widget.
|
a GtkEntry |
|
a GtkEntryBuffer |
Since 2.18
void gtk_entry_set_text (GtkEntry *entry
,const gchar *text
);
Sets the text in the widget to the given value, replacing the current contents.
See gtk_entry_buffer_set_text()
.
|
a GtkEntry |
|
the new text |
const gchar * gtk_entry_get_text (GtkEntry *entry
);
Retrieves the contents of the entry widget.
See also gtk_editable_get_chars()
.
This is equivalent to:
1 |
gtk_entry_buffer_get_text (gtk_entry_get_buffer (entry)); |
|
a GtkEntry |
Returns : |
a pointer to the contents of the widget as a string. This string points to internally allocated storage in the widget and must not be freed, modified or stored. |
guint16 gtk_entry_get_text_length (GtkEntry *entry
);
Retrieves the current length of the text in
entry
.
This is equivalent to:
1 |
gtk_entry_buffer_get_length (gtk_entry_get_buffer (entry)); |
Since 2.14
void gtk_entry_get_text_area (GtkEntry *entry
,GdkRectangle *text_area
);
Gets the area where the entry's text is drawn. This function is useful when drawing something to the entry in a draw callback.
If the entry is not realized, text_area
is filled with zeros.
See also gtk_entry_get_icon_area()
.
|
a GtkEntry |
|
Return location for the text area. [out] |
Since 3.0
void gtk_entry_set_visibility (GtkEntry *entry
,gboolean visible
);
Sets whether the contents of the entry are visible or not.
When visibility is set to FALSE
, characters are displayed
as the invisible char, and will also appear that way when
the text in the entry widget is copied elsewhere.
By default, GTK+ picks the best invisible character available
in the current font, but it can be changed with
gtk_entry_set_invisible_char()
.
Note that you probably want to set "input-purpose"
to GTK_INPUT_PURPOSE_PASSWORD
or GTK_INPUT_PURPOSE_PIN
to
inform input methods about the purpose of this entry,
in addition to setting visibility to FALSE
.
|
a GtkEntry |
|
TRUE if the contents of the entry are displayed
as plaintext |
void gtk_entry_set_invisible_char (GtkEntry *entry
,gunichar ch
);
Sets the character to use in place of the actual text when
gtk_entry_set_visibility()
has been called to set text visibility
to FALSE
. i.e. this is the character used in "password mode" to
show the user how many characters have been typed. By default, GTK+
picks the best invisible char available in the current font. If you
set the invisible char to 0, then the user will get no feedback
at all; there will be no text on the screen as they type.
|
a GtkEntry |
|
a Unicode character |
void gtk_entry_unset_invisible_char (GtkEntry *entry
);
Unsets the invisible char previously set with
gtk_entry_set_invisible_char()
. So that the
default invisible char is used again.
|
a GtkEntry |
Since 2.16
void gtk_entry_set_max_length (GtkEntry *entry
,gint max
);
Sets the maximum allowed length of the contents of the widget. If the current contents are longer than the given length, then they will be truncated to fit.
This is equivalent to:
1 |
gtk_entry_buffer_set_max_length (gtk_entry_get_buffer (entry), max); |
|
a GtkEntry |
|
the maximum length of the entry, or 0 for no maximum. (other than the maximum length of entries.) The value passed in will be clamped to the range 0-65536. |
gboolean gtk_entry_get_activates_default (GtkEntry *entry
);
Retrieves the value set by gtk_entry_set_activates_default()
.
|
a GtkEntry |
Returns : |
TRUE if the entry will activate the default widget |
gboolean gtk_entry_get_has_frame (GtkEntry *entry
);
Gets the value set by gtk_entry_set_has_frame()
.
|
a GtkEntry |
Returns : |
whether the entry has a beveled frame |
const GtkBorder * gtk_entry_get_inner_border (GtkEntry *entry
);
gtk_entry_get_inner_border
has been deprecated since version 3.4 and should not be used in newly-written code. Use the standard border and padding CSS properties (through
objects like GtkStyleContext and GtkCssProvider); the value returned by
this function is ignored by GtkEntry.
This function returns the entry's "inner-border" property. See
gtk_entry_set_inner_border()
for more information.
Since 2.10
gint gtk_entry_get_width_chars (GtkEntry *entry
);
Gets the value set by gtk_entry_set_width_chars()
.
|
a GtkEntry |
Returns : |
number of chars to request space for, or negative if unset |
void gtk_entry_set_activates_default (GtkEntry *entry
,gboolean setting
);
If setting
is TRUE
, pressing Enter in the entry
will activate the default
widget for the window containing the entry. This usually means that
the dialog box containing the entry will be closed, since the default
widget is usually one of the dialog buttons.
(For experts: if setting
is TRUE
, the entry calls
gtk_window_activate_default()
on the window containing the entry, in
the default handler for the "activate" signal.)
|
a GtkEntry |
|
TRUE to activate window's default widget on Enter keypress |
void gtk_entry_set_has_frame (GtkEntry *entry
,gboolean setting
);
Sets whether the entry has a beveled frame around it.
|
a GtkEntry |
|
new value |
void gtk_entry_set_inner_border (GtkEntry *entry
,const GtkBorder *border
);
gtk_entry_set_inner_border
has been deprecated since version 3.4 and should not be used in newly-written code. Use the standard border and padding CSS properties (through
objects like GtkStyleContext and GtkCssProvider); the value set with
this function is ignored by GtkEntry.
Sets entry
's inner-border property to border
, or clears it if NULL
is passed. The inner-border is the area around the entry's text, but
inside its frame.
If set, this property overrides the inner-border style property. Overriding the style-provided border is useful when you want to do in-place editing of some text in a canvas or list widget, where pixel-exact positioning of the entry is important.
Since 2.10
void gtk_entry_set_width_chars (GtkEntry *entry
,gint n_chars
);
Changes the size request of the entry to be about the right size
for n_chars
characters. Note that it changes the size
request, the size can still be affected by
how you pack the widget into containers. If n_chars
is -1, the
size reverts to the default entry size.
|
a GtkEntry |
|
width in chars |
gunichar gtk_entry_get_invisible_char (GtkEntry *entry
);
Retrieves the character displayed in place of the real characters
for entries with visibility set to false. See gtk_entry_set_invisible_char()
.
|
a GtkEntry |
Returns : |
the current invisible char, or 0, if the entry does not show invisible text at all. |
void gtk_entry_set_alignment (GtkEntry *entry
,gfloat xalign
);
Sets the alignment for the contents of the entry. This controls the horizontal positioning of the contents when the displayed text is shorter than the width of the entry.
|
a GtkEntry |
|
The horizontal alignment, from 0 (left) to 1 (right). Reversed for RTL layouts |
Since 2.4
gfloat gtk_entry_get_alignment (GtkEntry *entry
);
Gets the value set by gtk_entry_set_alignment()
.
|
a GtkEntry |
Returns : |
the alignment |
Since 2.4
void gtk_entry_set_placeholder_text (GtkEntry *entry
,const gchar *text
);
Sets text to be displayed in entry
when it is empty and unfocused.
This can be used to give a visual hint of the expected contents of
the GtkEntry.
Note that since the placeholder text gets removed when the entry received focus, using this feature is a bit problematic if the entry is given the initial focus in a window. Sometimes this can be worked around by delaying the initial focus setting until the first key event arrives.
Since 3.2
const gchar * gtk_entry_get_placeholder_text (GtkEntry *entry
);
Retrieves the text that will be displayed when entry
is empty and unfocused
|
a GtkEntry |
Returns : |
a pointer to the placeholder text as a string. This string points to internally allocated storage in the widget and must not be freed, modified or stored. |
Since 3.2
void gtk_entry_set_overwrite_mode (GtkEntry *entry
,gboolean overwrite
);
Sets whether the text is overwritten when typing in the GtkEntry.
|
a GtkEntry |
|
new value |
Since 2.14
gboolean gtk_entry_get_overwrite_mode (GtkEntry *entry
);
Gets the value set by gtk_entry_set_overwrite_mode()
.
|
a GtkEntry |
Returns : |
whether the text is overwritten when typing. |
Since 2.14
PangoLayout * gtk_entry_get_layout (GtkEntry *entry
);
Gets the PangoLayout used to display the entry.
The layout is useful to e.g. convert text positions to
pixel positions, in combination with gtk_entry_get_layout_offsets()
.
The returned layout is owned by the entry and must not be
modified or freed by the caller.
Keep in mind that the layout text may contain a preedit string, so
gtk_entry_layout_index_to_text_index()
and
gtk_entry_text_index_to_layout_index()
are needed to convert byte
indices in the layout to byte indices in the entry contents.
|
a GtkEntry |
Returns : |
the PangoLayout for this entry. [transfer none] |
void gtk_entry_get_layout_offsets (GtkEntry *entry
,gint *x
,gint *y
);
Obtains the position of the PangoLayout used to render text in the entry, in widget coordinates. Useful if you want to line up the text in an entry with some other text, e.g. when using the entry to implement editable cells in a sheet widget.
Also useful to convert mouse events into coordinates inside the PangoLayout, e.g. to take some action if some part of the entry text is clicked.
Note that as the user scrolls around in the entry the offsets will
change; you'll need to connect to the "notify::scroll-offset"
signal to track this. Remember when using the PangoLayout
functions you need to convert to and from pixels using
PANGO_PIXELS()
or PANGO_SCALE.
Keep in mind that the layout text may contain a preedit string, so
gtk_entry_layout_index_to_text_index()
and
gtk_entry_text_index_to_layout_index()
are needed to convert byte
indices in the layout to byte indices in the entry contents.
gint gtk_entry_layout_index_to_text_index (GtkEntry *entry
,gint layout_index
);
Converts from a position in the entry contents (returned
by gtk_entry_get_text()
) to a position in the
entry's PangoLayout (returned by gtk_entry_get_layout()
,
with text retrieved via pango_layout_get_text()
).
|
a GtkEntry |
|
byte index into the entry layout text |
Returns : |
byte index into the entry contents |
gint gtk_entry_text_index_to_layout_index (GtkEntry *entry
,gint text_index
);
Converts from a position in the entry's PangoLayout (returned by
gtk_entry_get_layout()
) to a position in the entry contents
(returned by gtk_entry_get_text()
).
|
a GtkEntry |
|
byte index into the entry contents |
Returns : |
byte index into the entry layout text |
void gtk_entry_set_attributes (GtkEntry *entry
,PangoAttrList *attrs
);
Sets a PangoAttrList; the attributes in the list are applied to the entry text.
|
a GtkEntry |
|
a PangoAttrList |
Since 3.6
PangoAttrList * gtk_entry_get_attributes (GtkEntry *entry
);
Gets the attribute list that was set on the entry using
gtk_entry_set_attributes()
, if any.
Since 3.6
gint gtk_entry_get_max_length (GtkEntry *entry
);
Retrieves the maximum allowed length of the text in
entry
. See gtk_entry_set_max_length()
.
This is equivalent to:
1 |
gtk_entry_buffer_get_max_length (gtk_entry_get_buffer (entry)); |
gboolean gtk_entry_get_visibility (GtkEntry *entry
);
Retrieves whether the text in entry
is visible. See
gtk_entry_set_visibility()
.
|
a GtkEntry |
Returns : |
TRUE if the text is currently visible |
void gtk_entry_set_completion (GtkEntry *entry
,GtkEntryCompletion *completion
);
Sets completion
to be the auxiliary completion object to use with entry
.
All further configuration of the completion mechanism is done on
completion
using the GtkEntryCompletion API. Completion is disabled if
completion
is set to NULL
.
|
A GtkEntry |
|
The GtkEntryCompletion or NULL . [allow-none]
|
Since 2.4
GtkEntryCompletion * gtk_entry_get_completion (GtkEntry *entry
);
Returns the auxiliary completion object currently in use by entry
.
|
A GtkEntry |
Returns : |
The auxiliary completion object currently
in use by entry . [transfer none]
|
Since 2.4
void gtk_entry_set_cursor_hadjustment (GtkEntry *entry
,GtkAdjustment *adjustment
);
Hooks up an adjustment to the cursor position in an entry, so that when
the cursor is moved, the adjustment is scrolled to show that position.
See gtk_scrolled_window_get_hadjustment()
for a typical way of obtaining
the adjustment.
The adjustment has to be in pixel units and in the same coordinate system as the entry.
|
a GtkEntry |
|
an adjustment which should be adjusted when the cursor
is moved, or NULL
|
Since 2.12
GtkAdjustment * gtk_entry_get_cursor_hadjustment (GtkEntry *entry
);
Retrieves the horizontal cursor adjustment for the entry.
See gtk_entry_set_cursor_hadjustment()
.
|
a GtkEntry |
Returns : |
the horizontal cursor adjustment, or NULL
if none has been set. [transfer none]
|
Since 2.12
void gtk_entry_set_progress_fraction (GtkEntry *entry
,gdouble fraction
);
Causes the entry's progress indicator to "fill in" the given fraction of the bar. The fraction should be between 0.0 and 1.0, inclusive.
|
a GtkEntry |
|
fraction of the task that's been completed |
Since 2.16
gdouble gtk_entry_get_progress_fraction (GtkEntry *entry
);
Returns the current fraction of the task that's been completed.
See gtk_entry_set_progress_fraction()
.
|
a GtkEntry |
Returns : |
a fraction from 0.0 to 1.0 |
Since 2.16
void gtk_entry_set_progress_pulse_step (GtkEntry *entry
,gdouble fraction
);
Sets the fraction of total entry width to move the progress
bouncing block for each call to gtk_entry_progress_pulse()
.
|
a GtkEntry |
|
fraction between 0.0 and 1.0 |
Since 2.16
gdouble gtk_entry_get_progress_pulse_step (GtkEntry *entry
);
Retrieves the pulse step set with gtk_entry_set_progress_pulse_step()
.
|
a GtkEntry |
Returns : |
a fraction from 0.0 to 1.0 |
Since 2.16
void gtk_entry_progress_pulse (GtkEntry *entry
);
Indicates that some progress is made, but you don't know how much.
Causes the entry's progress indicator to enter "activity mode,"
where a block bounces back and forth. Each call to
gtk_entry_progress_pulse()
causes the block to move by a little bit
(the amount of movement per pulse is determined by
gtk_entry_set_progress_pulse_step()
).
|
a GtkEntry |
Since 2.16
gboolean gtk_entry_im_context_filter_keypress (GtkEntry *entry
,GdkEventKey *event
);
Allow the GtkEntry input method to internally handle key press
and release events. If this function returns TRUE
, then no further
processing should be done for this key event. See
gtk_im_context_filter_keypress()
.
Note that you are expected to call this function from your handler
when overriding key event handling. This is needed in the case when
you need to insert your own key handling between the input method
and the default key event handling of the GtkEntry.
See gtk_text_view_reset_im_context()
for an example of use.
|
a GtkEntry |
|
the key event. [type Gdk.EventKey] |
Returns : |
TRUE if the input method handled the key event. |
Since 2.22
void gtk_entry_reset_im_context (GtkEntry *entry
);
Reset the input method context of the entry if needed.
This can be necessary in the case where modifying the buffer would confuse on-going input method behavior.
|
a GtkEntry |
Since 2.22
typedef enum { GTK_ENTRY_ICON_PRIMARY, GTK_ENTRY_ICON_SECONDARY } GtkEntryIconPosition;
Specifies the side of the entry at which an icon is placed.
| At the beginning of the entry (depending on the text direction). | |
| At the end of the entry (depending on the text direction). |
Since 2.16
void gtk_entry_set_icon_from_pixbuf (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,GdkPixbuf *pixbuf
);
Sets the icon shown in the specified position using a pixbuf.
If pixbuf
is NULL
, no icon will be shown in the specified position.
Since 2.16
void gtk_entry_set_icon_from_stock (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,const gchar *stock_id
);
Sets the icon shown in the entry at the specified position from a stock image.
If stock_id
is NULL
, no icon will be shown in the specified position.
|
A GtkEntry |
|
Icon position |
|
The name of the stock item, or NULL . [allow-none]
|
Since 2.16
void gtk_entry_set_icon_from_icon_name (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,const gchar *icon_name
);
Sets the icon shown in the entry at the specified position from the current icon theme.
If the icon name isn't known, a "broken image" icon will be displayed instead.
If icon_name
is NULL
, no icon will be shown in the specified position.
|
A GtkEntry |
|
The position at which to set the icon |
|
An icon name, or NULL . [allow-none]
|
Since 2.16
void gtk_entry_set_icon_from_gicon (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,GIcon *icon
);
Sets the icon shown in the entry at the specified position from the current icon theme. If the icon isn't known, a "broken image" icon will be displayed instead.
If icon
is NULL
, no icon will be shown in the specified position.
|
A GtkEntry |
|
The position at which to set the icon |
|
The icon to set, or NULL . [allow-none]
|
Since 2.16
GtkImageType gtk_entry_get_icon_storage_type (GtkEntry *entry
,GtkEntryIconPosition icon_pos
);
Gets the type of representation being used by the icon
to store image data. If the icon has no image data,
the return value will be GTK_IMAGE_EMPTY
.
|
a GtkEntry |
|
Icon position |
Returns : |
image representation being used |
Since 2.16
GdkPixbuf * gtk_entry_get_icon_pixbuf (GtkEntry *entry
,GtkEntryIconPosition icon_pos
);
Retrieves the image used for the icon.
Unlike the other methods of setting and getting icon data, this method will work regardless of whether the icon was set using a GdkPixbuf, a GIcon, a stock item, or an icon name.
|
A GtkEntry |
|
Icon position |
Returns : |
A GdkPixbuf, or NULL if no icon is
set for this position. [transfer none]
|
Since 2.16
const gchar * gtk_entry_get_icon_stock (GtkEntry *entry
,GtkEntryIconPosition icon_pos
);
Retrieves the stock id used for the icon, or NULL
if there is
no icon or if the icon was set by some other method (e.g., by
pixbuf, icon name or gicon).
|
A GtkEntry |
|
Icon position |
Returns : |
A stock id, or NULL if no icon is set or if the icon
wasn't set from a stock id |
Since 2.16
const gchar * gtk_entry_get_icon_name (GtkEntry *entry
,GtkEntryIconPosition icon_pos
);
Retrieves the icon name used for the icon, or NULL
if there is
no icon or if the icon was set by some other method (e.g., by
pixbuf, stock or gicon).
|
A GtkEntry |
|
Icon position |
Returns : |
An icon name, or NULL if no icon is set or if the icon
wasn't set from an icon name |
Since 2.16
GIcon * gtk_entry_get_icon_gicon (GtkEntry *entry
,GtkEntryIconPosition icon_pos
);
Retrieves the GIcon used for the icon, or NULL
if there is
no icon or if the icon was set by some other method (e.g., by
stock, pixbuf, or icon name).
|
A GtkEntry |
|
Icon position |
Returns : |
A GIcon, or NULL if no icon is set
or if the icon is not a GIcon. [transfer none]
|
Since 2.16
void gtk_entry_set_icon_activatable (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,gboolean activatable
);
Sets whether the icon is activatable.
|
A GtkEntry |
|
Icon position |
|
TRUE if the icon should be activatable |
Since 2.16
gboolean gtk_entry_get_icon_activatable (GtkEntry *entry
,GtkEntryIconPosition icon_pos
);
Returns whether the icon is activatable.
|
a GtkEntry |
|
Icon position |
Returns : |
TRUE if the icon is activatable. |
Since 2.16
void gtk_entry_set_icon_sensitive (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,gboolean sensitive
);
Sets the sensitivity for the specified icon.
|
A GtkEntry |
|
Icon position |
|
Specifies whether the icon should appear sensitive or insensitive |
Since 2.16
gboolean gtk_entry_get_icon_sensitive (GtkEntry *entry
,GtkEntryIconPosition icon_pos
);
Returns whether the icon appears sensitive or insensitive.
|
a GtkEntry |
|
Icon position |
Returns : |
TRUE if the icon is sensitive. |
Since 2.16
gint gtk_entry_get_icon_at_pos (GtkEntry *entry
,gint x
,gint y
);
Finds the icon at the given position and return its index. The
position's coordinates are relative to the entry
's top left corner.
If x
, y
doesn't lie inside an icon, -1 is returned.
This function is intended for use in a "query-tooltip"
signal handler.
|
a GtkEntry |
|
the x coordinate of the position to find |
|
the y coordinate of the position to find |
Returns : |
the index of the icon at the given position, or -1 |
Since 2.16
void gtk_entry_set_icon_tooltip_text (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,const gchar *tooltip
);
Sets tooltip
as the contents of the tooltip for the icon
at the specified position.
Use NULL
for tooltip
to remove an existing tooltip.
See also gtk_widget_set_tooltip_text()
and
gtk_entry_set_icon_tooltip_markup()
.
|
a GtkEntry |
|
the icon position |
|
the contents of the tooltip for the icon, or NULL . [allow-none]
|
Since 2.16
gchar * gtk_entry_get_icon_tooltip_text (GtkEntry *entry
,GtkEntryIconPosition icon_pos
);
Gets the contents of the tooltip on the icon at the specified
position in entry
.
|
a GtkEntry |
|
the icon position |
Returns : |
the tooltip text, or NULL . Free the returned string
with g_free() when done. |
Since 2.16
void gtk_entry_set_icon_tooltip_markup (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,const gchar *tooltip
);
Sets tooltip
as the contents of the tooltip for the icon at
the specified position. tooltip
is assumed to be marked up with
the Pango text markup language.
Use NULL
for tooltip
to remove an existing tooltip.
See also gtk_widget_set_tooltip_markup()
and
gtk_entry_set_icon_tooltip_text()
.
|
a GtkEntry |
|
the icon position |
|
the contents of the tooltip for the icon, or NULL . [allow-none]
|
Since 2.16
gchar * gtk_entry_get_icon_tooltip_markup (GtkEntry *entry
,GtkEntryIconPosition icon_pos
);
Gets the contents of the tooltip on the icon at the specified
position in entry
.
|
a GtkEntry |
|
the icon position |
Returns : |
the tooltip text, or NULL . Free the returned string
with g_free() when done. |
Since 2.16
void gtk_entry_set_icon_drag_source (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,GtkTargetList *target_list
,GdkDragAction actions
);
Sets up the icon at the given position so that GTK+ will start a drag operation when the user clicks and drags the icon.
To handle the drag operation, you need to connect to the usual
"drag-data-get" (or possibly "drag-data-delete")
signal, and use gtk_entry_get_current_icon_drag_source()
in
your signal handler to find out if the drag was started from
an icon.
By default, GTK+ uses the icon as the drag icon. You can use the
"drag-begin" signal to set a different icon. Note that you
have to use g_signal_connect_after()
to ensure that your signal handler
gets executed after the default handler.
|
a GtkEntry |
|
icon position |
|
the targets (data formats) in which the data can be provided |
|
a bitmask of the allowed drag actions |
Since 2.16
gint gtk_entry_get_current_icon_drag_source
(GtkEntry *entry
);
Returns the index of the icon which is the source of the current DND operation, or -1.
This function is meant to be used in a "drag-data-get" callback.
|
a GtkIconEntry |
Returns : |
index of the icon which is the source of the current DND operation, or -1. |
Since 2.16
void gtk_entry_get_icon_area (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,GdkRectangle *icon_area
);
Gets the area where entry's icon at icon_pos
is drawn.
This function is useful when drawing something to the
entry in a draw callback.
If the entry is not realized or has no icon at the given position,
icon_area
is filled with zeros.
See also gtk_entry_get_text_area()
|
A GtkEntry |
|
Icon position |
|
Return location for the icon's area. [out] |
Since 3.0
typedef enum { GTK_INPUT_PURPOSE_FREE_FORM, GTK_INPUT_PURPOSE_ALPHA, GTK_INPUT_PURPOSE_DIGITS, GTK_INPUT_PURPOSE_NUMBER, GTK_INPUT_PURPOSE_PHONE, GTK_INPUT_PURPOSE_URL, GTK_INPUT_PURPOSE_EMAIL, GTK_INPUT_PURPOSE_NAME, GTK_INPUT_PURPOSE_PASSWORD, GTK_INPUT_PURPOSE_PIN } GtkInputPurpose;
Describes primary purpose of the input widget. This information is useful for on-screen keyboards and similar input methods to decide which keys should be presented to the user.
Note that the purpose is not meant to impose a totally strict rule about allowed characters, and does not replace input validation. It is fine for an on-screen keyboard to let the user override the character set restriction that is expressed by the purpose. The application is expected to validate the entry contents, even if it specified a purpose.
The difference between GTK_INPUT_PURPOSE_DIGITS
and
GTK_INPUT_PURPOSE_NUMBER
is that the former accepts only digits
while the latter also some punctuation (like commas or points, plus,
minus) and 'e' or 'E' as in 3.14E+000.
This enumeration may be extended in the future; input methods should interpret unknown values as 'free form'.
| Allow any character | |
| Allow only alphabetic characters | |
| Allow only digits | |
| Edited field expects numbers | |
| Edited field expects phone number | |
| Edited field expects URL | |
| Edited field expects email address | |
| Edited field expects the name of a person | |
Like GTK_INPUT_PURPOSE_FREE_FORM , but characters are hidden
|
|
Like GTK_INPUT_PURPOSE_DIGITS , but characters are hidden
|
Since 3.6
void gtk_entry_set_input_purpose (GtkEntry *entry
,GtkInputPurpose purpose
);
Sets the "input-purpose" property which can be used by on-screen keyboards and other input methods to adjust their behaviour.
|
a GtkEntry |
|
the purpose |
Since 3.6
GtkInputPurpose gtk_entry_get_input_purpose (GtkEntry *entry
);
Gets the value of the "input-purpose" property.
|
a GtkEntry |
Since 3.6
typedef enum { GTK_INPUT_HINT_NONE = 0, GTK_INPUT_HINT_SPELLCHECK = 1 << 0, GTK_INPUT_HINT_NO_SPELLCHECK = 1 << 1, GTK_INPUT_HINT_WORD_COMPLETION = 1 << 2, GTK_INPUT_HINT_LOWERCASE = 1 << 3, GTK_INPUT_HINT_UPPERCASE_CHARS = 1 << 4, GTK_INPUT_HINT_UPPERCASE_WORDS = 1 << 5, GTK_INPUT_HINT_UPPERCASE_SENTENCES = 1 << 6, GTK_INPUT_HINT_INHIBIT_OSK = 1 << 7 } GtkInputHints;
Describes hints that might be taken into account by input methods or applications. Note that input methods may already tailor their behaviour according to the GtkInputPurpose of the entry.
Some common sense is expected when using these flags - mixing
GTK_INPUT_HINT_LOWERCASE
with any of the uppercase hints makes no sense.
This enumeration may be extended in the future; input methods should ignore unknown values.
| No special behaviour suggested | |
| Suggest checking for typos | |
| Suggest not checking for typos | |
| Suggest word completion | |
| Suggest to convert all text to lowercase | |
| Suggest to capitalize all text | |
| Suggest to capitalize the first character of each word | |
| Suggest to capitalize the first word of each sentence | |
| Suggest to not show an onscreen keyboard (e.g for a calculator that already has all the keys). |
Since 3.6
void gtk_entry_set_input_hints (GtkEntry *entry
,GtkInputHints hints
);
Sets the "input-hints" property, which allows input methods to fine-tune their behaviour.
|
a GtkEntry |
|
the hints |
Since 3.6
GtkInputHints gtk_entry_get_input_hints (GtkEntry *entry
);
Gets the value of the "input-hints" property.
|
a GtkEntry |
Since 3.6
"activates-default"
property "activates-default" gboolean : Read / Write
Whether to activate the default widget (such as the default button in a dialog) when Enter is pressed.
Default value: FALSE
"attributes"
property "attributes" PangoAttrList* : Read / Write
A list of Pango attributes to apply to the text of the entry.
This is mainly useful to change the size or weight of the text.
Since 3.6
"buffer"
property"buffer" GtkEntryBuffer* : Read / Write / Construct
Text buffer object which actually stores entry text.
"caps-lock-warning"
property "caps-lock-warning" gboolean : Read / Write
Whether password entries will show a warning when Caps Lock is on.
Note that the warning is shown using a secondary icon, and thus does not work if you are using the secondary icon position for some other purpose.
Default value: TRUE
Since 2.16
"completion"
property"completion" GtkEntryCompletion* : Read / Write
The auxiliary completion object to use with the entry.
Since 3.2
"cursor-position"
property "cursor-position" gint : Read
The current position of the insertion cursor in chars.
Allowed values: [0,65535]
Default value: 0
"editable"
property "editable" gboolean : Read / Write
Whether the entry contents can be edited.
Default value: TRUE
"has-frame"
property "has-frame" gboolean : Read / Write
FALSE removes outside bevel from entry.
Default value: TRUE
"im-module"
property "im-module" gchar* : Read / Write
Which IM (input method) module should be used for this entry. See GtkIMContext.
Setting this to a non-NULL
value overrides the
system-wide IM module setting. See the GtkSettings
"gtk-im-module" property.
Default value: NULL
Since 2.16
"inner-border"
property"inner-border" GtkBorder* : Read / Write
GtkEntry:inner-border
has been deprecated since version 3.4 and should not be used in newly-written code. Use the standard border and padding CSS properties
(through objects like GtkStyleContext and GtkCssProvider); the value
of this style property is ignored.
Sets the text area's border between the text and the frame.
Since 2.10
"input-hints"
property"input-hints" GtkInputHints : Read / Write
Additional hints (beyond "input-purpose") that allow input methods to fine-tune their behaviour.
Since 3.6
"input-purpose"
property"input-purpose" GtkInputPurpose : Read / Write
The purpose of this text field.
This property can be used by on-screen keyboards and other input methods to adjust their behaviour.
Note that setting the purpose to GTK_INPUT_PURPOSE_PASSWORD
or
GTK_INPUT_PURPOSE_PIN
is independent from setting
"visibility".
Default value: GTK_INPUT_PURPOSE_FREE_FORM
Since 3.6
"invisible-char"
property "invisible-char" guint : Read / Write
The invisible character is used when masking entry contents (in \"password mode\")"). When it is not explicitly set with the "invisible-char" property, GTK+ determines the character to use from a list of possible candidates, depending on availability in the current font.
This style property allows the theme to prepend a character to the list of candidates.
Default value: '*'
Since 2.18
"invisible-char-set"
property "invisible-char-set" gboolean : Read / Write
Whether the invisible char has been set for the GtkEntry.
Default value: FALSE
Since 2.16
"max-length"
property "max-length" gint : Read / Write
Maximum number of characters for this entry. Zero if no maximum.
Allowed values: [0,65535]
Default value: 0
"overwrite-mode"
property "overwrite-mode" gboolean : Read / Write
If text is overwritten when typing in the GtkEntry.
Default value: FALSE
Since 2.14
"placeholder-text"
property "placeholder-text" gchar* : Read / Write
The text that will be displayed in the GtkEntry when it is empty and unfocused.
Default value: NULL
Since 3.2
"primary-icon-activatable"
property "primary-icon-activatable" gboolean : Read / Write
Whether the primary icon is activatable.
GTK+ emits the "icon-press" and "icon-release" signals only on sensitive, activatable icons.
Sensitive, but non-activatable icons can be used for purely informational purposes.
Default value: TRUE
Since 2.16
"primary-icon-gicon"
property "primary-icon-gicon" GIcon* : Read / Write
The GIcon to use for the primary icon for the entry.
Since 2.16
"primary-icon-name"
property "primary-icon-name" gchar* : Read / Write
The icon name to use for the primary icon for the entry.
Default value: NULL
Since 2.16
"primary-icon-pixbuf"
property"primary-icon-pixbuf" GdkPixbuf* : Read / Write
A pixbuf to use as the primary icon for the entry.
Since 2.16
"primary-icon-sensitive"
property "primary-icon-sensitive" gboolean : Read / Write
Whether the primary icon is sensitive.
An insensitive icon appears grayed out. GTK+ does not emit the "icon-press" and "icon-release" signals and does not allow DND from insensitive icons.
An icon should be set insensitive if the action that would trigger when clicked is currently not available.
Default value: TRUE
Since 2.16
"primary-icon-stock"
property "primary-icon-stock" gchar* : Read / Write
The stock id to use for the primary icon for the entry.
Default value: NULL
Since 2.16
"primary-icon-storage-type"
property"primary-icon-storage-type" GtkImageType : Read
The representation which is used for the primary icon of the entry.
Default value: GTK_IMAGE_EMPTY
Since 2.16
"primary-icon-tooltip-markup"
property "primary-icon-tooltip-markup" gchar* : Read / Write
The contents of the tooltip on the primary icon, which is marked up
with the
Also see gtk_entry_set_icon_tooltip_markup()
.
Default value: NULL
Since 2.16
"primary-icon-tooltip-text"
property "primary-icon-tooltip-text" gchar* : Read / Write
The contents of the tooltip on the primary icon.
Also see gtk_entry_set_icon_tooltip_text()
.
Default value: NULL
Since 2.16
"progress-fraction"
property "progress-fraction" gdouble : Read / Write
The current fraction of the task that's been completed.
Allowed values: [0,1]
Default value: 0
Since 2.16
"progress-pulse-step"
property "progress-pulse-step" gdouble : Read / Write
The fraction of total entry width to move the progress
bouncing block for each call to gtk_entry_progress_pulse()
.
Allowed values: [0,1]
Default value: 0.1
Since 2.16
"scroll-offset"
property "scroll-offset" gint : Read
Number of pixels of the entry scrolled off the screen to the left.
Allowed values: >= 0
Default value: 0
"secondary-icon-activatable"
property "secondary-icon-activatable" gboolean : Read / Write
Whether the secondary icon is activatable.
GTK+ emits the "icon-press" and "icon-release" signals only on sensitive, activatable icons.
Sensitive, but non-activatable icons can be used for purely informational purposes.
Default value: TRUE
Since 2.16
"secondary-icon-gicon"
property "secondary-icon-gicon" GIcon* : Read / Write
The GIcon to use for the secondary icon for the entry.
Since 2.16
"secondary-icon-name"
property "secondary-icon-name" gchar* : Read / Write
The icon name to use for the secondary icon for the entry.
Default value: NULL
Since 2.16
"secondary-icon-pixbuf"
property"secondary-icon-pixbuf" GdkPixbuf* : Read / Write
An pixbuf to use as the secondary icon for the entry.
Since 2.16
"secondary-icon-sensitive"
property "secondary-icon-sensitive" gboolean : Read / Write
Whether the secondary icon is sensitive.
An insensitive icon appears grayed out. GTK+ does not emit the "icon-press" and "icon-release" signals and does not allow DND from insensitive icons.
An icon should be set insensitive if the action that would trigger when clicked is currently not available.
Default value: TRUE
Since 2.16
"secondary-icon-stock"
property "secondary-icon-stock" gchar* : Read / Write
The stock id to use for the secondary icon for the entry.
Default value: NULL
Since 2.16
"secondary-icon-storage-type"
property"secondary-icon-storage-type" GtkImageType : Read
The representation which is used for the secondary icon of the entry.
Default value: GTK_IMAGE_EMPTY
Since 2.16
"secondary-icon-tooltip-markup"
property "secondary-icon-tooltip-markup" gchar* : Read / Write
The contents of the tooltip on the secondary icon, which is marked up
with the
Also see gtk_entry_set_icon_tooltip_markup()
.
Default value: NULL
Since 2.16
"secondary-icon-tooltip-text"
property "secondary-icon-tooltip-text" gchar* : Read / Write
The contents of the tooltip on the secondary icon.
Also see gtk_entry_set_icon_tooltip_text()
.
Default value: NULL
Since 2.16
"selection-bound"
property "selection-bound" gint : Read
The position of the opposite end of the selection from the cursor in chars.
Allowed values: [0,65535]
Default value: 0
"shadow-type"
property"shadow-type" GtkShadowType : Read / Write
Which kind of shadow to draw around the entry when
"has-frame" is set to TRUE
.
Default value: GTK_SHADOW_IN
Since 2.12
"text-length"
property "text-length" guint : Read
The length of the text in the GtkEntry.
Allowed values: <= 65535
Default value: 0
Since 2.14
"truncate-multiline"
property "truncate-multiline" gboolean : Read / Write
When TRUE
, pasted multi-line text is truncated to the first line.
Default value: FALSE
Since 2.10
"visibility"
property "visibility" gboolean : Read / Write
FALSE displays the "invisible char" instead of the actual text (password mode).
Default value: TRUE
"width-chars"
property "width-chars" gint : Read / Write
Number of characters to leave space for in the entry.
Allowed values: >= G_MAXULONG
Default value: -1
"icon-prelight"
style property "icon-prelight" gboolean : Read
The prelight style property determines whether activatable icons prelight on mouseover.
Default value: TRUE
Since 2.16
"inner-border"
style property"inner-border" GtkBorder* : Read
GtkEntry:inner-border
has been deprecated since version 3.4 and should not be used in newly-written code. Use the standard border and padding CSS properties
(through objects like GtkStyleContext and GtkCssProvider); the value
of this style property is ignored.
Sets the text area's border between the text and the frame.
Since 2.10
"invisible-char"
style property "invisible-char" guint : Read
The invisible character is used when masking entry contents (in \"password mode\")"). When it is not explicitly set with the "invisible-char" property, GTK+ determines the character to use from a list of possible candidates, depending on availability in the current font.
This style property allows the theme to prepend a character to the list of candidates.
Default value: 0
Since 2.18
"progress-border"
style property"progress-border" GtkBorder* : Read
GtkEntry:progress-border
has been deprecated since version 3.4 and should not be used in newly-written code. Use the standard margin CSS property (through objects
like GtkStyleContext and GtkCssProvider); the value of this style
property is ignored.
The border around the progress bar in the entry.
Since 2.16
"activate"
signalvoid user_function (GtkEntry *entry,
gpointer user_data) : Action
The ::activate signal is emitted when the user hits the Enter key.
While this signal is used as a keybinding signal, it is also commonly used by applications to intercept activation of entries.
The default bindings for this signal are all forms of the Enter key.
|
The entry on which the signal is emitted |
|
user data set when the signal handler was connected. |
"backspace"
signalvoid user_function (GtkEntry *entry,
gpointer user_data) : Action
The ::backspace signal is a keybinding signal which gets emitted when the user asks for it.
The default bindings for this signal are Backspace and Shift-Backspace.
|
the object which received the signal |
|
user data set when the signal handler was connected. |
"copy-clipboard"
signalvoid user_function (GtkEntry *entry,
gpointer user_data) : Action
The ::copy-clipboard signal is a keybinding signal which gets emitted to copy the selection to the clipboard.
The default bindings for this signal are Ctrl-c and Ctrl-Insert.
|
the object which received the signal |
|
user data set when the signal handler was connected. |
"cut-clipboard"
signalvoid user_function (GtkEntry *entry,
gpointer user_data) : Action
The ::cut-clipboard signal is a keybinding signal which gets emitted to cut the selection to the clipboard.
The default bindings for this signal are Ctrl-x and Shift-Delete.
|
the object which received the signal |
|
user data set when the signal handler was connected. |
"delete-from-cursor"
signalvoid user_function (GtkEntry *entry,
GtkDeleteType type,
gint count,
gpointer user_data) : Action
The ::delete-from-cursor signal is a keybinding signal which gets emitted when the user initiates a text deletion.
If the type
is GTK_DELETE_CHARS
, GTK+ deletes the selection
if there is one, otherwise it deletes the requested number
of characters.
The default bindings for this signal are Delete for deleting a character and Ctrl-Delete for deleting a word.
|
the object which received the signal |
|
the granularity of the deletion, as a GtkDeleteType |
|
the number of type units to delete |
|
user data set when the signal handler was connected. |
"icon-press"
signalvoid user_function (GtkEntry *entry,
GtkEntryIconPosition icon_pos,
GdkEvent *event,
gpointer user_data) : Run Last
The ::icon-press signal is emitted when an activatable icon is clicked.
|
The entry on which the signal is emitted |
|
The position of the clicked icon |
|
the button press event. [type Gdk.EventButton] |
|
user data set when the signal handler was connected. |
Since 2.16
"icon-release"
signalvoid user_function (GtkEntry *entry,
GtkEntryIconPosition icon_pos,
GdkEvent *event,
gpointer user_data) : Run Last
The ::icon-release signal is emitted on the button release from a mouse click over an activatable icon.
|
The entry on which the signal is emitted |
|
The position of the clicked icon |
|
the button release event. [type Gdk.EventButton] |
|
user data set when the signal handler was connected. |
Since 2.16
"insert-at-cursor"
signalvoid user_function (GtkEntry *entry,
gchar *string,
gpointer user_data) : Action
The ::insert-at-cursor signal is a keybinding signal which gets emitted when the user initiates the insertion of a fixed string at the cursor.
This signal has no default bindings.
|
the object which received the signal |
|
the string to insert |
|
user data set when the signal handler was connected. |
"move-cursor"
signalvoid user_function (GtkEntry *entry,
GtkMovementStep step,
gint count,
gboolean extend_selection,
gpointer user_data) : Action
The ::move-cursor signal is a
keybinding signal
which gets emitted when the user initiates a cursor movement.
If the cursor is not visible in entry
, this signal causes
the viewport to be moved instead.
Applications should not connect to it, but may emit it with
g_signal_emit_by_name()
if they need to control the cursor
programmatically.
The default bindings for this signal come in two variants, the variant with the Shift modifier extends the selection, the variant without the Shift modifer does not. There are too many key combinations to list them all here.
|
the object which received the signal |
|
the granularity of the move, as a GtkMovementStep |
|
the number of step units to move |
|
TRUE if the move should extend the selection |
|
user data set when the signal handler was connected. |
"paste-clipboard"
signalvoid user_function (GtkEntry *entry,
gpointer user_data) : Action
The ::paste-clipboard signal is a keybinding signal which gets emitted to paste the contents of the clipboard into the text view.
The default bindings for this signal are Ctrl-v and Shift-Insert.
|
the object which received the signal |
|
user data set when the signal handler was connected. |
"populate-popup"
signalvoid user_function (GtkEntry *entry,
GtkMenu *menu,
gpointer user_data) : Run Last
The ::populate-popup signal gets emitted before showing the context menu of the entry.
If you need to add items to the context menu, connect
to this signal and append your menuitems to the menu
.
|
The entry on which the signal is emitted |
|
the menu that is being populated |
|
user data set when the signal handler was connected. |
"preedit-changed"
signalvoid user_function (GtkEntry *entry,
gchar *preedit,
gpointer user_data) : Action
If an input method is used, the typed text will not immediately be committed to the buffer. So if you are interested in the text, connect to this signal.
|
the object which received the signal |
|
the current preedit string |
|
user data set when the signal handler was connected. |
Since 2.20
"toggle-overwrite"
signalvoid user_function (GtkEntry *entry,
gpointer user_data) : Action
The ::toggle-overwrite signal is a keybinding signal which gets emitted to toggle the overwrite mode of the entry.
The default bindings for this signal is Insert.
|
the object which received the signal |
|
user data set when the signal handler was connected. |


To use the forms, you just have to surround your input with a div with the attribute _form-group.
_form-group
<div _form-group> <label for="input_test_1">Input test 1</label> <input id="input_test_1" type="text"> </div>


Profile
Users
Event
Browse Event
Create Event
View Event
Log out
EventRock
×
Profile
Users
Event
Browse Event
Create Event
View Event
Log out
[username]
Contact Information
FIRST NAME
MIDDLE NAME
LAST NAME
EMAIL
JOB TITLE
COMPANY
COMPANY ADDRESS
WEBSITE
Home Address
ADDRESS
CITY
STATE
COUNTRY
SAVE


I'm A Celebrity fans demand justice for James and Roman after 'impossible' trial
I’m A Celebrity viewers are demanding justice for Roman Kemp and James Haskell for being given ‘impossible’ task during today’s live trial.
Eight of the celebrities were put to the test for a roast dinner on the live trial, called Jungle Love Island (complete with Ant and Dec getting texts and everything!).
With 12 stars on the line for those in camp, the team were going strong until the last round.
Lying on a bed filled with snakes, Roman and James were tasked with unscrewing stars from one side of the bed and rescrewing them on the other – with 90 seconds to get all three moved over.
On top of the snakes already on the bed with them, each star was in a box filled with critters and animals including a snappy crab that caused havoc for James.
Unable to complete the trial, a clearly annoyed James snapped at Ant and Dec when they asked him what went wrong.
Advertisement Advertisement
While normally most people vehemently defend the Geordie duo, this time they backed up rugby star Haskell, claiming it was impossible for the pair of them to complete the challenge in the allotted time slot.
Ant and Dec later defended the trial task, and said: ‘The stand ins did it when we tested it #ImACeleb’
Taking to Twitter, they demanded justice for the three stars who would now miss out on a roast dinner meal in camp tonight, after a week of meagre rations.
Tensions have clearly been running high in the Australian camp site, with food causing the celebs to get hangry as the day goes on.
Advertisement Advertisement
After a particularly tough day, the team were seen on a knife edge with Andrew Maxwell clashing with several members of the camp and Kate Garraway clashing with Ian Wright and James over chivalry.
Ian, Cliff Parisi and Andy Whyment were the three celebs whose stars for dinner weren’t successfully earned – which could be interesting when they return to camp.
Nadine Coyle, Myles Stephenson, Kate Garraway and Andy weren’t present at the trial, instead heading off on a separate mission to get the group care packages from home.
I’m a Celebrity, Get Me Out Of Here continues tonight at 9pm on ITV.
Got a showbiz story? If you've got a celebrity story, video or pictures get in touch with the Metro.co.uk entertainment team by emailing us<EMAIL_ADDRESS>calling 020 3615 2145 or by visiting our Submit Stuff page - we'd love to hear from you.


Hi there,
Good news! Your Democracy Sausage stall has just been approved.
You submitted the following information:
Polling Place: {%POLLING_PLACE_NAME%}, {%POLLING_PLACE_ADDRESS%}
Stall Name: {%STALL_NAME%}
Stall Description: {%STALL_DESCRIPTION%}
Stall Website: {%STALL_WEBSITE%}
Deliciousness: {%DELICIOUSNESS%}
Would you like to hear more from us?
Now that we've approved your stall, we've added you to our mailing list. Don't worry, we'll only ever send emails around
election-time in your state or territory. (And we won't sell your email to spammers - promise!)
Still, if you'd like to opt-out and unsubscribe from our mailing list you can do so
here.
Best of luck with your fundraising efforts!
Thanks,
Team Democracy Sausage


anode lithium graphite electrode Power Sources surface batteries lithium-ion capacity ion ./S-()- Electrochem. battery Soc. electrolyte charge carbon cells particles reaction temperature {border-style ./j.jpowsour... formation high performance px;} #ffffff;} ./. layer Figure degradation loss low rate electrodes film impedance irreversible ./.jes cycle increase ions area cathode cycling materials mechanisms plating size Li-ion aging current fade higher products study cell density formed intercalation life Electrochemical Lithium Wang active carbonate effect elevated growth material px; reversible various {font-family Acta Anode Kim Shim Striebel battery. compared font-size increases lattice metal operating reduces specific structure ./j.electacta... Aging Electrochim. However, Studies Surface Takeuchi behavior cause conditions cycled decomposition discharge double; energy particle potential solid species temperatures thermal used (e.g., Abraham Aurbach Capacity Dahn Effect Haran LiCoO Novak Popov SEI White Zhang affect anodes border-color border-width change commercial distribution electrode. factors fading form function metallic natural negative porosity reduction resistance solid; storage using voltage {font-style {font-weight A.J. B.N. Carbon Choi D.P. D.W. Dees Degradation Influence J.P. Lee Levi LiNi M.C. Materials Study aged bold characterization charging content courier; cylindrical dendrites deposits different diffusion electrochemical em; high-power i.e., interphase kinetics operation overall pores preferred properties pt;} react stability thickness undergoes °C)


Experimental Feature
S3Guard is an experimental feature for the S3A client of the S3 object store, which can use a (consistent) database as the store of metadata about objects in an S3 bucket.
S3Guard
May improve performance on directory listing/scanning operations, including those which take place during the partitioning period of query execution, the process where files are listed and the work divided up amongst processes.
Permits a consistent view of the object store. Without this, changes in objects may not be immediately visible, especially in listing operations.
Offers a platform for future performance improvements for running Hadoop workloads on top of object stores
The basic idea is that, for each operation in the Hadoop S3 client (s3a) that reads or modifies metadata, a shadow copy of that metadata is stored in a separate MetadataStore implementation. Each MetadataStore implementation offers HDFS-like consistency for the metadata, and may also provide faster lookups for things like file status or directory listings.
For links to early design documents and related patches, see HADOOP-13345.
Important
S3Guard is experimental and should be considered unstable.
While all underlying data is persisted in S3, if, for some reason, the S3Guard-cached metadata becomes inconsistent with that in S3, queries on the data may become incorrect. For example, new datasets may be omitted, objects may be overwritten, or clients may not be aware that some data has been deleted. It is essential for all clients writing to an S3Guard-enabled S3 Repository to use the feature. Clients reading the data may work directly with the S3A data, in which case the normal S3 consistency guarantees apply.
The latest configuration parameters are defined in core-default.xml. You should consult that file for full information, but a summary is provided here.
A core concept of S3Guard is that the directory listing data of the object store, the metadata is replicated in a higher-performance, consistent, database. In S3Guard, this database is called The Metadata Store
By default, S3Guard is not enabled.
The Metadata Store to use in production is bonded to Amazon’s DynamoDB database service. The following setting will enable this Metadata Store:
<property> <name>fs.s3a.metadatastore.impl</name> <value>org.apache.hadoop.fs.s3a.s3guard.DynamoDBMetadataStore</value> </property>
Note that the NullMetadataStore store can be explicitly requested if desired. This offers no metadata storage, and effectively disables S3Guard.
<property> <name>fs.s3a.metadatastore.impl</name> <value>org.apache.hadoop.fs.s3a.s3guard.NullMetadataStore</value> </property>
More settings will may be added in the future. Currently the only Metadata Store-independent setting, besides the implementation class above, is the allow authoritative flag.
It is recommended that you leave the default setting here:
<property> <name>fs.s3a.metadatastore.authoritative</name> <value>false</value> </property>
Setting this to true is currently an experimental feature. When true, the S3A client will avoid round-trips to S3 when getting directory listings, if there is a fully-cached version of the directory stored in the Metadata Store.
Note that if this is set to true, it may exacerbate or persist existing race conditions around multiple concurrent modifications and listings of a given directory tree.
In particular: If the Metadata Store is declared as authoritative, all interactions with the S3 bucket(s) must be through S3A clients sharing the same Metadata Store
Here are the DynamoDBMetadataStore settings. Other Metadata Store implementations will have their own configuration parameters.
First, choose the name of the table you wish to use for the S3Guard metadata storage in your DynamoDB instance. If you leave it unset/empty, a separate table will be created for each S3 bucket you access, and that bucket’s name will be used for the name of the DynamoDB table. For example, this sets the table name to my-ddb-table-name
<property> <name>fs.s3a.s3guard.ddb.table</name> <value>my-ddb-table-name</value> <description> The DynamoDB table name to operate. Without this property, the respective S3 bucket names will be used. </description> </property>
It is good to share a table across multiple buckets for multiple reasons.
You are billed for the I/O capacity allocated to the table, even when the table is not used. Sharing capacity can reduce costs.
You can share the “provision burden” across the buckets. That is, rather than allocating for the peak load on a single bucket, you can allocate for the peak load across all the buckets, which is likely to be significantly lower.
It’s easier to measure and tune the load requirements and cost of S3Guard, because there is only one table to review and configure in the AWS management console.
When wouldn’t you want to share a table?
When you do explicitly want to provision I/O capacity to a specific bucket and table, isolated from others.
When you are using separate billing for specific buckets allocated to specific projects.
When different users/roles have different access rights to different buckets. As S3Guard requires all users to have R/W access to the table, all users will be able to list the metadata in all buckets, even those to which they lack read access.
You may also wish to specify the region to use for DynamoDB. If a region is not configured, S3A will assume that it is in the same region as the S3 bucket. A list of regions for the DynamoDB service can be found in Amazon’s documentation. In this example, to use the US West 2 region:
<property> <name>fs.s3a.s3guard.ddb.region</name> <value>us-west-2</value> </property>
When working with S3Guard-managed buckets from EC2 VMs running in AWS infrastructure, using a local DynamoDB region ensures the lowest latency and highest reliability, as well as avoiding all long-haul network charges. The S3Guard tables, and indeed, the S3 buckets, should all be in the same region as the VMs.
Next, you can choose whether or not the table will be automatically created (if it doesn’t already exist). If you want this feature, set the fs.s3a.s3guard.ddb.table.create option to true.
<property> <name>fs.s3a.s3guard.ddb.table.create</name> <value>true</value> <description> If true, the S3A client will create the table if it does not already exist. </description> </property>
Next, you need to set the DynamoDB read and write throughput requirements you expect to need for your cluster. Setting higher values will cost you more money. Note that these settings only affect table creation when fs.s3a.s3guard.ddb.table.create is enabled. To change the throughput for an existing table, use the AWS console or CLI tool.
For more details on DynamoDB capacity units, see the AWS page on Capacity Unit Calculations.
The charges are incurred per hour for the life of the table, even when the table and the underlying S3 buckets are not being used.
There are also charges incurred for data storage and for data IO outside of the region of the DynamoDB instance. S3Guard only stores metadata in DynamoDB: path names and summary details of objects —the actual data is stored in S3, so billed at S3 rates.
<property> <name>fs.s3a.s3guard.ddb.table.capacity.read</name> <value>500</value> <description> Provisioned throughput requirements for read operations in terms of capacity units for the DynamoDB table. This config value will only be used when creating a new DynamoDB table, though later you can manually provision by increasing or decreasing read capacity as needed for existing tables. See DynamoDB documents for more information. </description> </property> <property> <name>fs.s3a.s3guard.ddb.table.capacity.write</name> <value>100</value> <description> Provisioned throughput requirements for write operations in terms of capacity units for the DynamoDB table. Refer to related config fs.s3a.s3guard.ddb.table.capacity.read before usage. </description> </property>
Attempting to perform more IO than the capacity requested simply throttles the IO; small capacity numbers are recommended when initially experimenting with S3Guard.
The DynamoDB metadata store takes advantage of the fact that the DynamoDB service uses the same authentication mechanisms as S3. S3Guard gets all its credentials from the S3A client that is using it.
All existing S3 authentication mechanisms can be used, except for one exception. Credentials placed in URIs are not supported for S3Guard, for security reasons.
In production, it is likely only some buckets will have S3Guard enabled; those which are read-only may have disabled, for example. Equally importantly, buckets in different regions should have different tables, each in the relevant region.
 All options with the under fs.s3a.bucket.BUCKETNAME.KEY are propagated to the options fs.s3a.KEY for that bucket only.
As an example, here is a configuration to use different metadata stores and tables for different buckets
First, we define shortcuts for the metadata store classnames
<property> <name>s3guard.null</name> <value>org.apache.hadoop.fs.s3a.s3guard.NullMetadataStore</value> </property> <property> <name>s3guard.dynamo</name> <value>org.apache.hadoop.fs.s3a.s3guard.DynamoDBMetadataStore</value> </property>
Next, Amazon’s public landsat database is configured with no metadata store
<property> <name>fs.s3a.bucket.landsat-pds.metadatastore.impl</name> <value>${s3guard.null}</value> <description>The read-only landsat-pds repository isn't managed by S3Guard</description> </property>
Next the ireland-2 and ireland-offline buckets are configured with DynamoDB as the store, and a shared table production-table
<property> <name>fs.s3a.bucket.ireland-2.metadatastore.impl</name> <value>${s3guard.dynamo}</value> </property> <property> <name>fs.s3a.bucket.ireland-offline.metadatastore.impl</name> <value>${s3guard.dynamo}</value> </property> <property> <name>fs.s3a.bucket.ireland-2.s3guard.ddb.table</name> <value>production-table</value> </property>
The region of this table is automatically set to be that of the buckets, here eu-west-1; the same table name may actually be used in different regions.
Together then, this configuration enables the DynamoDB Metadata Store for two buckets with a shared table, while disabling it for the public bucket.
Note that in some cases an AWS region or s3a:// URI can be provided.
Metadata store URIs include a scheme that designates the backing store. For example (e.g. dynamodb://table_name;). As documented above, the AWS region can be inferred if the URI to an existing bucket is provided.
The S3A URI must also be provided for per-bucket configuration options to be picked up. That is: when an s3a URL is provided on the command line, all its “resolved” per-bucket settings are used to connect to, authenticate with and configure the S3Guard table. If no such URL is provided, then the base settings are picked up.
hadoop s3guard init -meta URI ( -region REGION | s3a://BUCKET )
Creates and initializes an empty metadata store.
A DynamoDB metadata store can be initialized with additional parameters pertaining to Provisioned Throughput:
[-write PROVISIONED_WRITES] [-read PROVISIONED_READS]
Example 1
hadoop s3guard init -meta dynamodb://ireland-team -write 5 -read 10 s3a://ireland-1
Creates a table “ireland-team” with a capacity of 5 for writes, 10 for reads, in the same location as the bucket “ireland-1”.
Example 2
hadoop s3guard init -meta dynamodb://ireland-team -region eu-west-1
Creates a table “ireland-team” in the region “eu-west-1.amazonaws.com”
hadoop s3guard import [-meta URI] s3a://BUCKET
Pre-populates a metadata store according to the current contents of an S3 bucket. If the -meta option is omitted, the binding information is taken from the core-site.xml configuration.
Example
hadoop s3guard import s3a://ireland-1
hadoop s3guard diff [-meta URI] s3a://BUCKET
Lists discrepancies between a metadata store and bucket. Note that depending on how S3Guard is used, certain discrepancies are to be expected.
Example
hadoop s3guard diff s3a://ireland-1
Prints and optionally checks the s3guard and encryption status of a bucket.
hadoop s3guard bucket-info [ -guarded ] [-unguarded] [-auth] [-nonauth] [-encryption ENCRYPTION] s3a://BUCKET
Options
| argument | meaning |
|---|---|
| -guarded | Require S3Guard to be enabled |
| -unguarded | Require S3Guard to be disabled |
| -auth | Require the S3Guard mode to be “authoritative” |
| -nonauth | Require the S3Guard mode to be “non-authoritative” |
| -encryption <type> | Require a specific server-side encryption algorithm |
The server side encryption options are not directly related to S3Guard, but it is often convenient to check them at the same time.
Example
hadoop s3guard bucket-info -guarded s3a://ireland-1
List the details of bucket s3a://ireland-1, mandating that it must have S3Guard enabled
Filesystem s3a://ireland-1 Location: eu-west-1 Filesystem s3a://ireland-1 is using S3Guard with store DynamoDBMetadataStore{region=eu-west-1, tableName=ireland-1} Authoritative S3Guard: fs.s3a.metadatastore.authoritative=false Metadata Store Diagnostics: ARN=arn:aws:dynamodb:eu-west-1:00000000:table/ireland-1 description=S3Guard metadata store in DynamoDB name=ireland-1 read-capacity=20 region=eu-west-1 retryPolicy=ExponentialBackoffRetry(maxRetries=9, sleepTime=100 MILLISECONDS) size=12812 status=ACTIVE table={AttributeDefinitions: [{AttributeName: child,AttributeType: S}, {AttributeName: parent,AttributeType: S}],TableName: ireland-1, KeySchema: [{AttributeName: parent,KeyType: HASH}, {AttributeName: child,KeyType: RANGE}], TableStatus: ACTIVE, CreationDateTime: Fri Aug 25 19:07:25 BST 2017, ProvisionedThroughput: {LastIncreaseDateTime: Tue Aug 29 11:45:18 BST 2017, LastDecreaseDateTime: Wed Aug 30 15:37:51 BST 2017, NumberOfDecreasesToday: 1, ReadCapacityUnits: 20,WriteCapacityUnits: 20}, TableSizeBytes: 12812,ItemCount: 91, TableArn: arn:aws:dynamodb:eu-west-1:00000000:table/ireland-1,} write-capacity=20 S3A Client Endpoint: fs.s3a.endpoint=s3-eu-west-1.amazonaws.com Encryption: fs.s3a.server-side-encryption-algorithm=none Input seek policy: fs.s3a.experimental.input.fadvise=normal
This listing includes all the information about the table supplied from
hadoop s3guard bucket-info -unguarded -encryption none s3a://landsat-pds
List the S3Guard status of clients of the public landsat-pds bucket, and verifies that the data is neither tracked with S3Guard nor encrypted.
Filesystem s3a://landsat-pdsLocation: us-west-2 Filesystem s3a://landsat-pds is not using S3Guard Endpoint: fs.s3a.endpoints3.amazonaws.com Encryption: fs.s3a.server-side-encryption-algorithm=none Input seek policy: fs.s3a.experimental.input.fadvise=normal
Note that other clients may have a S3Guard table set up to store metadata on this bucket; the checks are all done from the perspective of the configuration setttings of the current client.
hadoop s3guard bucket-info -guarded -auth s3a://landsat-pds
Require the bucket to be using S3Guard in authoritative mode. This will normally fail against this specific bucket.
Deletes a metadata store. With DynamoDB as the store, this means the specific DynamoDB table use to store the metadata.
hadoop s3guard destroy [-meta URI] ( -region REGION | s3a://BUCKET )
This does not delete the bucket, only the S3Guard table which it is bound to.
Examples
hadoop s3guard destroy s3a://ireland-1
Deletes the table which the bucket ireland-1 is configured to use as its MetadataStore.
hadoop s3guard destroy -meta dynamodb://ireland-team -region eu-west-1
Delete all file entries in the MetadataStore table whose object “modification time” is older than the specified age.
hadoop s3guard prune [-days DAYS] [-hours HOURS] [-minutes MINUTES] [-seconds SECONDS] [-m URI] ( -region REGION | s3a://BUCKET )
A time value of hours, minutes and/or seconds must be supplied.
Example
hadoop s3guard prune -days 7 s3a://ireland-1
Deletes all entries in the S3Guard table for files older than seven days from the table associated with s3a://ireland-1.
hadoop s3guard prune -hours 1 -minutes 30 -meta dynamodb://ireland-team -region eu-west-1
Delete all entries more than 90 minutes old from the table “ireland-team” in the region “eu-west-1”.
Alter the read and/or write capacity of a s3guard table.
hadoop s3guard set-capacity [--read UNIT] [--write UNIT] ( -region REGION | s3a://BUCKET )
The --read and --write units are those of s3guard init.
Example
hadoop s3guard set-capacity -read 20 -write 20 s3a://ireland-1
Set the capacity of the table used by bucket s3a://ireland-1 to 20 read and 20 write. (This is a low number, incidentally)
2017-08-30 16:21:26,343 [main] INFO s3guard.S3GuardTool (S3GuardTool.java:initMetadataStore(229)) - Metadata store DynamoDBMetadataStore{region=eu-west-1, tableName=ireland-1} is initialized. 2017-08-30 16:21:26,344 [main] INFO s3guard.DynamoDBMetadataStore (DynamoDBMetadataStore.java:updateParameters(1084)) - Current table capacity is read: 25, write: 25 2017-08-30 16:21:26,344 [main] INFO s3guard.DynamoDBMetadataStore (DynamoDBMetadataStore.java:updateParameters(1086)) - Changing capacity of table to read: 20, write: 20 Metadata Store Diagnostics: ARN=arn:aws:dynamodb:eu-west-1:00000000000:table/ireland-1 description=S3Guard metadata store in DynamoDB name=ireland-1 read-capacity=25 region=eu-west-1 retryPolicy=ExponentialBackoffRetry(maxRetries=9, sleepTime=100 MILLISECONDS) size=12812 status=UPDATING table={ ... } write-capacity=25
After the update, the table status changes to UPDATING; this is a sign that the capacity has been changed
Repeating the same command will not change the capacity, as both read and write values match that already in use
2017-08-30 16:24:35,337 [main] INFO s3guard.DynamoDBMetadataStore (DynamoDBMetadataStore.java:updateParameters(1090)) - Table capacity unchanged at read: 20, write: 20 Metadata Store Diagnostics: ARN=arn:aws:dynamodb:eu-west-1:00000000000:table/ireland-1 description=S3Guard metadata store in DynamoDB name=ireland-1 read-capacity=20 region=eu-west-1 retryPolicy=ExponentialBackoffRetry(maxRetries=9, sleepTime=100 MILLISECONDS) size=12812 status=ACTIVE table={ ... } write-capacity=20
If you run into network connectivity issues, or have a machine failure in the middle of an operation, you may end up with your metadata store having state that differs from S3. The S3Guard CLI commands, covered in the CLI section above, can be used to diagnose and repair these issues.
There are some logs whose log level can be increased to provide more information.
# Log S3Guard classes log4j.logger.org.apache.hadoop.fs.s3a.s3guard=DEBUG # Log all S3A classes log4j.logger.org.apache.hadoop.fs.s3a=DEBUG # Enable debug logging of AWS DynamoDB client log4j.logger.com.amazonaws.services.dynamodbv2.AmazonDynamoDB # Log all HTTP requests made; includes S3 interaction. This may # include sensitive information such as account IDs in HTTP headers. log4j.logger.com.amazonaws.request=DEBUG
If all else fails, S3Guard is designed to allow for easy recovery by deleting the metadata store data. In DynamoDB, this can be accomplished by simply deleting the table, and allowing S3Guard to recreate it from scratch. Note that S3Guard tracks recent changes to file metadata to implement consistency. Deleting the metadata store table will simply result in a period of eventual consistency for any file modifications that were made right before the table was deleted.
Operations which modify metadata will make changes to S3 first. If, and only if, those operations succeed, the equivalent changes will be made to the Metadata Store.
These changes to S3 and Metadata Store are not fully-transactional: If the S3 operations succeed, and the subsequent Metadata Store updates fail, the S3 changes will not be rolled back. In this case, an error message will be logged.
S3Guard tables are created with a version marker, an entry with the primary key and child entry of ../VERSION; the use of a relative path guarantees that it will not be resolved.
Note: this policy does not indicate any intent to upgrade table structures in an incompatible manner. The version marker in tables exists to support such an option if it ever becomes necessary, by ensuring that all S3Guard client can recognise any version mismatch.
All users of the DynamoDB table must have write access to it. This effectively means they must have write access to the entire object store.
There’s not been much testing of using a S3Guard Metadata Store with a read-only S3 Bucket. It should work, provided all users have write access to the DynamoDB table. And, as updates to the Metadata Store are only made after successful file creation, deletion and rename, the store is unlikely to get out of sync, it is still something which merits more testing before it could be considered reliable.
The table which was intended to be used as a S3guard metadata store does not have any version marker indicating that it is a S3Guard table.
It may be that this is not a S3Guard table.
This indicates that the version of S3Guard which created (or possibly updated) the database table is from a different version that that expected by the S3A client.
This error will also include the expected and actual version numbers.
If the expected version is lower than the actual version, then the version of the S3A client library is too old to interact with this S3Guard-managed bucket. Upgrade the application/library.
If the expected version is higher than the actual version, then the table itself will need upgrading.
S3Guard could not find the DynamoDB table for the Metadata Store, and it was not configured to create it. Either the table was missing, or the configuration is preventing S3Guard from finding the table.
The IO load of clients of the (shared) DynamoDB table was exceeded.
Currently S3Guard doesn’t do any throttling and retries here; the way to address this is to increase capacity via the AWS console or the set-capacity command.
For details on how to test S3Guard, see Testing S3Guard


Published on: Jan 23, 2021
Published on: Dec 13, 2020
Published on: Dec 07, 2020
Published on: May 16, 2020
Published on: Oct 06, 2019
Published on: July 14, 2019
Updated on: Dec 14, 2020
Published on: May 11, 2019


{% extends "v2/modules/gsoc/form_base.html" %}
{% comment %}
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
{% endcomment %}
{% block dependencies %}
[
dep.uniform,
dep.melange.main,
dep.jqueryui.datepicker,
dep.jqueryui.autocomplete,
css("/soc/content/{{ app_version }}/css/v2/gsoc/map.css"),
null,
function () {
jQuery("select, input:radio, input:file, input:checkbox").uniform();
jQuery("#birth_date").datepicker({
changeMonth: true,
changeYear: true,
dateFormat: "yy-mm-dd",
showButtonPanel: true,
minDate: "-90y",
maxDate: "+0D",
yearRange: "-90",
defaultDate: '1990-01-01'
});
var url = "?fmt=json&field=school_name";
jQuery.ajax({
url: url,
success: function(data) {
var getSchools = function() {
var country = jQuery("#school_country").attr('value');
var schools = data[country];
if(!schools) {
return [];
}
return schools;
};
var onchange = function() {
jQuery("#school_name").autocomplete({
'source': getSchools()
});
};
jQuery("#school_country").change(onchange);
// trigger autocomplete for the currently selected country
onchange();
}
})
},
tc("/soc/content/{{ app_version }}/js/templates/modules/gsoc/profile.js", {})
]
{% endblock dependencies %}


?6
7
8
9
10
_
XT
v
The
New
York
copyright
reserved
botanical
Garden
The
University
of
Texas
Herbarium
(LL,
TEX)
Mentzelia
aspera
L.
Det:
B.
L.
Turner,
7
Feb
2001
PLANTS
OF
HAITI
S'V*W-CuiaL
Vieinfty
of
St.
MJfch^l
de
1’Atalaye,
Depanement
An
Nord
•
altitude
about
350
meters
’
••
707f
E.
C.
LEONARD,
Collector
OUV'17
New
York
Botanical
Garden
lb234Ä3
1623483
Legend -
Level of confidence that token is an accurately-transcribed word
extremely low
very low
low
undetermined
medium
high
very high


Hi ,
I would like to have a plug that could transmit power consumption to a base station. It should not use much power itself to do so. Is there a way to build this feature into a standard (German ) wall plug. Without affecting the plugs normal look?
Re: Plugs with capability to transmit power consumption
Do you mean "plug" or the socket on the wall? If you really meant plug, probably not. If you are making it yourself, my guess is that you will need a box roughly the size of this adapter to contain the necessary sensors, computing power, transmitter and a power supply.
Re: Plugs with capability to transmit power consumption
Is there a guide of how I can build this kind of plug? Where would I start?
Re: Plugs with capability to transmit power consumption
Ok I guess this is a question with no easy answer.
let me explain what I want to do maybe someone will be interested in helping me out.
i want to write a software that can evaluate all your houses plugs, or at least the ones that have an adapter.
i am an experienced programmer but lack the knowledge to get these plugs to send consumption data to a central system.
Btw Robert thanks for your response
Re: Plugs with capability to transmit power consumption
If you're an experienced programmer but have no experience with mains electrical circuits and working on live equipment, DON'T DO IT. One slip or one oversight and you could easily end up as a fatality.
Having said that, the "GIVMon" adapter's design and construction should give you an indication of what you need to do on the mains side. If the only connection to the outside world is by radio, you won't need the isolation in normal use, but you will need it while you're working on the plug and developing your software. I suggest you read that article and remember that it was written by a professional electrical engineer with very many years experience.
Re: Plugs with capability to transmit power consumption
when talking about plugs are you talking about things like wemo insight ? Cause that's basically what i'm doing. I have 3 wemo insight's and 4 other branded plugs that can monitor consumption of appliances. The last 4 are not availible for purchase anymore but wemo insight's, although costly are availible.
i then created a (windows) delphi program that connects to the ip of the wemo insight (it's a wifi plug) reads the power and sends it to my local emonscms installation however you can also submit it to emoncms.org.
So i monitor groups of appliances as wel as single appliances like my refrigirator etc. my total watt consumption according to my meter last month was 143 kwh, according to emoncms with my 7 plugs monitoring it was 127 kwh. Since i'm not using plugs for my washing / laundry machine and electrical cooking fire nore for my lights that's where the diffrence of 17 kwh comes from.
My setup is this:
Intel nuc: running wamp with emoncms locally (can use emoncms.org), runs my program day and night to read the data from the wemo insight's and post it to an emoncms installation
a router is needed to connect wemo insight's.
A word of advice though i had problems with the wemo insights finding my wifi network due to interference from all the other wifi signals near me (aroubnd 32 of them). But i found out that if i changed mu network from wireless N to the slower wireless g the wemo insight's had less problems.
The program basically does a http post / soap request to the wemo insight and you get the data it's as easy as that.
Is it that what you are looking for ?


MUTE WITNESS A film review by James Berardinelli Copyright 1995 James Berardinelli
RATING (0 TO 10): 6.6
United States, 1995 U.S. Availability: 9/15/95 (limited) Running Length: 1:30 MPAA Classification: R (Violence, sex, nudity) Theatrical Aspect Ratio: 2.35:1
Cast: Mary Sudina, Fay Ripley, Evan Richards, Oleg Jankowski, Igor Volkov, Alec Guinness Director: Anthony Waller Producers: Alexander Buchman, Norbert Soentgen, and Anthony Waller Screenplay: Anthony Waller Cinematography: Egon Werdin Music: Wilbert Hirsch U.S. Distributor: Sony Pictures Classics
It's not often that a slasher/thriller is released by a recognized distributor of art-house fare (in this case, Sony Pictures Classics), but that's the case with MUTE WITNESS. Of course, it's somewhat unfair to pigeon-hole this movie by using the word "slasher", since that term conjures images of FRIDAY THE THIRTEENTH, and this picture aims considerably higher. In approach and execution, if not in content, MUTE WITNESS belongs in the same category as another low-budget edge-of-the- seater: THE STEPFATHER.
It goes without saying that it's not a good idea to think deeply about this sort of movie while it's on-screen. There are gaps in logic -- many obvious, others less so--but these occur in service of a better-paced, more taut storyline. MUTE WITNESS isn't a masterpiece of plotting or originality, but it provides the requisite shocks and scares, includes a few unexpected twists, and mixes together a fair number of the genre's requisite cliches. It's slick and fun, but not great.
MUTE WITNESS opens on the set of a low-budget, schlocky horror flick being filmed in Moscow. Director Andy Clarke (Evan Richards) has brought the production to Russia because costs are low (the same reason MUTE WITNESS was filmed there--art imitating life). Only two other Americans are with Andy on this journey: his lover/assistant, Karen Hughes (Fay Ripley), and her sister, the movie's special effects/makeup maestro, Billy (Mary Sudina), who is mute but not deaf. The cast and crew are all locals, many of whom don't speak English.
One night, Billy becomes locked in the studio after dark. As she searches for a way out, she comes upon two men filming what appears to be a porno movie. All is not as it seems, however, and the sex act turns violent. While the camera rolls and Billy looks on in silent horror, the naked woman is brutally hacked to death. As Billy turns to flee, she knocks over a coat rack, and a chase through lonely, deserted corridors ensues.
Director Anthony Waller keeps the tension at a high level that atones for many of the film's faults. Several thriller staples appear to have been deliberately included--not because the plot requires them, but as a kind of "wink and nod" at the knowing audience. There isn't a need to show Billy emerging naked from a bath, but Waller does it anyway. There's a thinly-disguised playfulness about how he approaches this, as well as other, traditional slasher/thriller elements.
The last half-hour is nicely convoluted. The situation is complicated to begin with because of the communications difficulties--hardly anyone speaks the same language, and Billy can't talk at all. On top of that, MUTE WITNESS toys with us by making it unclear who's on whose side. Things are sorted out by the last frame, but it's fun to guess along the way about who can be trusted.
The only "name" actor in the film is Sir Alec Guinness, who has the briefest of cameos as "The Reaper"--the vile instigator of all that takes place. Everyone else in the cast is an unknown. The best acting job is turned in by Mary Sudina, whose mute performance is lively and convincing. Fay Ripley and Evan Richards don't fare as well dramatically, although several of their scenes contain a portion of comic relief.
There's nothing especially artsy about this film. The issue of communication, and the resulting vulnerability and isolation that occur when there's no common language, is one of MUTE WITNESS' most compelling themes, but it's too often used as little more than a plot device. This film has its share of blood, gore, chills, and thrills, and Waller is competent, although not masterful, at blending these elements without bothering too much with the abstract--and potentially more interesting--aspects of his production.
- James Berardinelli<EMAIL_ADDRESS>The review above was posted to the
rec.arts.movies.reviews newsgroup (de.rec.film.kritiken for German reviews).
The Internet Movie Database accepts no responsibility for the contents of the
review and has no editorial control. Unless stated otherwise, the copyright
belongs to the author.
Please direct comments/criticisms of the review to relevant newsgroups.
Broken URLs inthe reviews are the responsibility of the author.
The formatting of the review is likely to differ from the original due
to ASCII to HTML conversion.
Related links: index of all rec.arts.movies.reviews reviews


| PREV CLASS NEXT CLASS | FRAMES NO FRAMES |
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
SFDCAccessControlResults SFDCAccessControlResults.UpdateResults
public class SFDCAccessControlResults.UpdateResults
This class provides results info and functionality for update operations.
| Constructor Summary | |
|---|---|
SFDCAccessControlResults.UpdateResults(SObject[] objects,
Database.SaveResult[] results)
This constructor sets the objects that were actually used to update the db, and also sets the results from that update operation. |
| Method Summary | |
|---|---|
Database.SaveResult[] |
getResults()
Get the Database.SaveResult [] returned by the update operation. |
SObject[] |
getUpdatedObjects()
Get the objects that were actually updated into the db. |
Boolean |
wasSuccessful()
Did the update operation succeed for all objects in the array? |
| Constructor Detail |
|---|
public SFDCAccessControlResults.UpdateResults(SObject[] objects, Database.SaveResult[] results)
| Method Detail |
|---|
public Database.SaveResult[] getResults()
public SObject[] getUpdatedObjects()
public Boolean wasSuccessful()
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES |
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |


{% autoescape off %}
Dear {{ username }},
We have created an account on our Tic platform, and below is the credentials to log in to the platform.
Please change your account's password as soon as you log in.
Username: {{ username }}
Password: {{ password }}
Sincerely,
The Tic Team
{% endautoescape %}


Landing Page
Special Projects
This story is part of a series of specially designed stories that represents some of the best journalism The Post has to offer. Check out the rest of the special projects here.
RILEY SCOTT
05.30.19
Athens may seem small, but one thing is for sure: a lot is packed into the few miles surrounding campus. So if you’re worried about not having enough to do, don’t worry, we’ve got you covered. Here are six staples of Athens to visit in your first year:
ILLUSTRATION | RILEY SCOTT
image description here
A favorite for students, Donkey Coffee is one of the best study and hangout spots in Athens. With delicious fair trade coffee, a great atmosphere and open mic and poetry nights, what more could you ask for? It’s open late, too, so head down to 17 1/2 W Washington St., right off of Court, for late-night lattes.
If you’re craving a sandwich with your Donkey Coffee, consider heading back down the road to Bagel Street Deli at 27 S Court St. Another staple of the Athens food scene, Bagel Street offers a staggeringly large menu of bagel sandwiches, ranging from the common place to the strange.
Just outside the Richland roundabout, The Ridges is a great place to explore with friends while the weather is still warm and sunny. Formerly the Athens Lunatic Asylum and tinged with a multitude of ghost stories, The Ridges is a complex of buildings that now houses administrative offices, the Voinovich School of Leadership and Public Affairs, an observatory and the Kennedy Museum of Art. Check out the latest exhibits or simply follow the beautiful hiking trails that wind through the former hospital grounds. And keep an eye out for public telescope nights!
If you’re into hiking, canoeing, kayaking or just want a nice picnic spot, Strouds Run is the place to go. Go out on the lake or explore the trails, or you can make use of the volleyball and basketball courts with friends!
Another staple of the Athens food scene, Casa Nueva offers some of the best Mexican cuisine in town. The restaurant and cantina frequently brings in live music and also hosts themed dance nights each semester. Even better, Casa pays it waiters fair wages and does not require tipping!
If you’re interested in seeing something other than the biggest blockbusters, consider heading to the Athena Cinema on Court Street next time you want to see a movie. The Athena shows less widely-released films alongside student films and also hosts the Athens International Film and Video Festival each spring.
Landing Page
This story is part of a series of specially designed stories that represents some of the best journalism The Post has to offer. Check out the rest of the special projects here.


In my free time I'm a keen runner and have competed in several ultra-marathons. These include the Winter Spine Race, the Hardmoors 200 and the Arc of Attrition.
Most of my runs can be found on Strava
I've been plotting my more interesting (and longer runs) on a map.
During the Summer of 2022 I (accidentally) entered two 100 mile races a week apart. These were the Peak District 100 and South Downs 100
My most recent adventure was a solo fastpack along Hadrian's Wall