Texts » History » Revision 8
Revision 7 (iri, 03/17/2011 08:46 PM) → Revision 8/31 (iri, 03/19/2011 01:52 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.
h2. _gtkTextBufferCount
Gets the number of lines and of characters in the buffer. The number of characters and the numbers of bytes can be different. here, the number of characters is returned.
Prototype : *fun [ObjGtkWidget] [I I]*
+Return+ : [I I] : a tuple with the number of lines and the numbers of characters. If error, the function returns nil.
Return [[Api]]