gtk-sharp
0.0.0.0
Entry is not a thread safe object
An Entry is a single-line text entry widget.
This widget should be used to retrieve small amounts of text from the user. 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.
See also the widget for displaying and editing large amounts of text.
Gtk.Widget
Gtk.Editable
GLib.IWrapper
Gtk.CellEditable
Atk.Implementor
GLib.IWrapper
GLib.IWrapper
System.IDisposable
Method
System.Int32
Add arbitrary text to the entry.
the text to add
The number of characters added
Use this method to insert a string at the current CursorPosition.
Method
System.Void
Specific implementation of Gtk.CellEditable.StartEditing for the Entry widget.
Method
System.Void
Specific implementation of Gtk.CellEditable.FinishEditing for the Entry widget.
Method
System.Void
Specific implementation of Gtk.CellEditable.RemoveWidget for the Entry widget.
Method
System.Void
Specific implementation of Gtk.Editable.SelectRegion for the Entry widget.
Method
System.String
Specific implementation of Gtk.Editable.GetChars for the Entry widget.
The index of the first character to get, (zero-indexed).
The index of the character to retrieve up to.
A string representing the characters from , up to, but not including . If is negative, then the the characters retrieved will be those characters from to the end of the text.
Method
System.Void
Specific implementation of Gtk.Editable.DeleteText for the Entry widget.
Method
System.Void
Specific implementation of Gtk.Editable.CopyClipboard for the Entry widget.
Method
System.Void
Specific implementation of Gtk.Editable.DeleteSelection for the Entry widget. Deletes the currently selected text from the Entry.
Method
System.Boolean
Get the the positions of the start and end of the current selection, if there is one.
output variable for the character index of the selection start
output variable for the character index of the end of the selection
true if there is a selection, false otherwise
Method
System.Void
Copies any selected text to the clipboard and deletes it from the entry.
Method
System.Void
Inserts text at a specific position in the Entry.
The text to add to the Entry
The length of the new text to add, in bytes.
An in/out parameter. The caller initializes it to the position at which to insert the text. After the call it points at the position after the newly inserted text.
Implements the Gtk.Editable.InsertText interface method for this Entry.
Method
System.Void
Causes the contents of the clipboard to be pasted into the Entry at the current cursor position.
Method
System.Void
Obtains the position of the PangoLayout used to render text in the entry, in widget coordinates.
X offset output of the layout
Y offset output of the layout
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.
Method
System.Void
Constructor
Internal Constructor
A new Entry widget
Constructor
Internal constructor
A new Entry widget
Constructor
Construct a new entry widget
Creates an entry widget with empty contents
Property
System.UInt32
Get the type of this object, as registered with the GLib object system.
A number that uniquely identifies this type in the GLib object system.
Mostly for internal use.
Property
System.Boolean
Implements the concrete version of Gtk.Editable.IsEditable, to determine if the text of the Entry can be edited.
true to allow editing of the Entry, false otherwise.
true if the Entry is editable, false otherwise.
Property
System.Int32
The position of the cursor.
the new cursor position, in characters.
the current cursor position
The cursor is displayed before the character with the given (base 0) index in the widget. The value must be less than or equal to the number of characters in the widget. A value of -1 indicates that the position should be set after the last character in the entry. Note that this position is in characters, not in bytes.
Property
Pango.Layout
Get the object used by this Entry for text layout
The Pango.Layout used to render the text of this entry
This property is read only.
Property
System.Boolean
Determine whether to display characters entered, or whether to mask them
true to display characters in the Entry, false to mask them
true if characters are being displayed, false if they are being masked
This property should be used to create entry widgets for sensitive data such as passwords.
Property
System.Int32
The maximum number of characters that can be placed in this Entry.
How many characters to limit this Entry to
The maximum number of characters that can currently be set in this Entry
This property can be useful for ensuring no more than a specific number of characters are put in an entry.
Property
System.Int32
The position of the cursor in the Entry's text
The current character of the cursor.
Use this property to manipulate the position of the cursor - it is displayed before the character with the given (base 0) index in the widget. The value must be less than or equal to the number of characters in the widget. A value of -1 indicates that the position should be set after the last character in the entry. Note that this position is in characters, not in bytes.
Property
System.Int32
The length of the selected text
the number of selected characters
Property
System.String
Manipulate the current text contents of an Entry
The new string to display in the Entry - overwrites any existing text in the widget.
The current text in an Entry
Property
System.Int32
To be added
To be added: an object of type 'int'
To be added
Property
System.Int32
Changes the size request of the entry to be about the right size for characters.
Requested width, in characters
The number of characters requested
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.
Property
System.Boolean
Whether or not this Entry is editable
true to make this Entry read-only, false to allow editing.
true if this entry can be edited, false otherwise
Set this property to false if you need to stop input into an Entry widget. For displaying textual data, it is more normal to use a instead.
Property
System.Boolean
Determine whether to activate the 'default widget' in the window when the return key is pressed.
set to true to activate the default button when enter is pressed, false otherwise
true if the default button will be activated, false otherwise.
If the value 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 the value is true, the entry calls ActivateDefault() on the containing the entry, in the default handler for the "activate" event).
Property
System.Boolean
Whether or not this Entry should be surrounded by a 3D frame
true to surround this Entry in a frmae (the default), false otherwise.
true if a frame surrounds this Entry, false otherwise
Unless there is a very specific reason for doing so, this property is best left to its default to ensure consistency in Entry widgets across applications.
Event
Implements the WidgetRemoved method of the interface. This will effectively destroy the Entry.
Event
Implements the EditingDone method of the interface.
Event
Connect to this event to be notified when text is inserted into the Entry.
Event
Connect to this event to be notified when text is deleted from the Entry.
Event
When the contents of the Entry change, this event is fired.
Event
Connect to this event handler to be notified when the cursor of an Entry moves
Data pertaining to this event is passed with a .
Event
Connect to this event to be notified when the user 'cuts' a selection in the Entry.
Connect to this event with a standard .
Event
Connect to this event to be notified when the user hits 'return'.
Connect to this event with a standard .
Event
Connect to this event to find out when text is deleted from the Entry by the user.
Data pertaining to this event is encapsulated in a .
Event
Connect to this event to be notified when the clipboard contents are pasted into this Entry.
Connect to this event with a standard .
Event
Connect to this event to be notified when the contents of the Entry are copied to the clipboard.
Connect to this event with a standard .
Event
To be added
Data pertaining to this event is encapsulated in a .
Event
Connect to this event to discover when the Overwrite state has been changed by the user. This is usually done by pressing the 'Insert' key on a keyboard.
Connect to this event with a standard .
Event
Connect to this event to discover when text is inserted at the cursor position - usually when the user types something in.
Data pertaining to this event is encapsulated in an .