PHP-GTK Manual - Base class for text-editing widgets.

GtkEditable

Base class for text-editing widgets.

Object Hierarchy

GtkObject
`-- GtkWidget
`-- GtkEditable

Description

GtkEditable is an abstract base class providing GtkEntry and GtkText with several methods, signals and properties, and also a set of keybindings that can be used for editing.

Table 2. Key bindings for editing
Key combination Editing function
Control + a Move to the beginning of the line
Control + b Move back one character
Control + c Copy currently selected text
Control + d Delete forward character
Control + e Move to the end of the line
Control + f Move forward one character
Control + h Delete backward character
Control + k Delete to line end
Control + n Move to the next line (GtkText only)
Control + p Move to the previous line (GtkText only)
Control + u Delete current line
Control + v Paste clipboard text
Control + w Delete backward word
Control + x Cut currently selected text
Alt + b Move back one word
Alt + d Delete forward word
Alt + f Move forward one word

There are also a host of signals that are used internally to enable these editing functions to work. These signals have not been documented here.

Methods

select_region()
Selects designated area of text.
insert_text()
Inserts a string of text.
delete_text()
Deletes designated area of text.
get_chars()
Returns designated string.
cut_clipboard()
Copies and deletes selected string.
copy_clipboard()
Copies selected string.
paste_clipboard()
Pastes current clipboard contents.
claim_selection()
Provides selection data.
delete_selection()
Deletes selected text and accompanying selection data.
changed()
Causes "changed" signal to be emitted.
set_position()
Sets the cursor position.
get_position()
Returns the current cursor position.
set_editable()
Toggles whether the text is editable.

Signals

"changed"
Emitted when there is a change to the text string.
"insert-text"
Emitted when insert_text() is called.
"delete-text"
Emitted when text is deleted.
"activate"
Emitted when designated key is pressed.
"set-editable"
Emitted when the set_editable() method is called.
"cut-clipboard"
Emitted when cut_clipboard() is called.
"copy-clipboard"
Emitted when copy_clipboard() is called.
"paste-clipboard"
Emitted when paste_clipboard() is called.

Properties

selection_start_pos:
Selection start position.
selection_end_pos:
Selection end position.
has_selection:
Indicates whether there is currently a selection.