GtkEditable

GtkEditable

Base class for text-editing widgets.

Object Hierarchy

GtkObject
`-- GtkWidget
       `-- GtkEditable

Direct subclasses

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 combinationEditing function
Control + aMove to the beginning of the line
Control + bMove back one character
Control + cCopy currently selected text
Control + dDelete forward character
Control + eMove to the end of the line
Control + fMove forward one character
Control + hDelete backward character
Control + kDelete to line end
Control + nMove to the next line (GtkText only)
Control + pMove to the previous line (GtkText only)
Control + uDelete current line
Control + vPaste clipboard text
Control + wDelete backward word
Control + xCut currently selected text
Alt + bMove back one word
Alt + dDelete forward word
Alt + fMove 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.

© Copyright 2003-2023 www.php-editors.com. The ultimate PHP Editor and PHP IDE site.