Scol » Lib2D GTK

{{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]]