Texts » History » Revision 7
Revision 6 (iri, 03/14/2011 11:13 PM) → Revision 7/31 (iri, 03/17/2011 08:46 PM)
{{toc}}
h1. Texts
Widget that displays a text string, typically on multi lines.
!>http://library.gnome.org/devel/gtk/2.21/multiline-text.png!
A text object can be seen as a container. Each text object has a buffer object. The buffer object stores the content (the string). You can change buffer object to a same text object.
h2. _gtkTextView
Create a new text object.
Prototype : *fun [Chn ObjGtkWidget S] [ObjGtkWidgetObjGtkWidget]*
table.
|*channel*|Chn|a channel. Can not be nil|
|*buffer*|ObjGtkWidget|a text buffer object. It can be nil; in this case, a default buffer will be created|
|*content*|S|an initial content. It can be nil|
+Return+ : [ObjGtkWidget ObjGtkWidget] : the new text object and the buffer text object. If _buffer_ was not nil, this will be the same, otherwise, it will be a new buffer text object too.
h2. _gtkTextGetBuffer
Return the current buffer object.
Prototype : *fun [ObjGtkWidget] ObjGtkWidget*
Text object -> buffer object.
h2. _gtkTextGetEditable
Return if a text object is editable or not.
Prototype : *fun [ObjGtkWidget] I*
+Return+ : I : 1 if editable, else 0. Nil if error (object is nil).
h2. _gtkTextSetEditable
Set if a text object is editable or not.
Prototype : *fun [ObjGtkWidget I] ObjGtkWidget*
Set the integer to 1 if the text must be editable, 0 otherwise
+Return+ : ObjGtkWidget : the same text object or nil if error (object is nil).
h1. Buffers
h2. _gtkTextBufferNew
Create a new text buffer object.
Prototype : *fun [Chn ObjGtkWidget] ObjGtkWidget*
table.
|*channel*|Chn|A channel|
|*tagstable*|ObjGtkWidget|A tags table object or nil (in this case, a default table object will be created)|
+Return+ : ObjGtkWidget : a new text buffer object or nil if error
h2. _gtkTextBufferInsert
Insert a string in a position
Prototype : *fun [ObjGtkWidget S I] ObjGtkWidget*
table.
|*buffer*|ObjGtkWidget|Any buffer already created|
|*string*|S|Any string to insert|
|*position*|I|A position. If nil, negative or greater than the current length of the buffer, the position will be the end|
+Return+ : ObjGtkWidget : the same text buffer object or nil if error.
Return [[Api]]