Actions

History

Texts » History » Revision 25

« Previous | Revision 25/31 (diff) | Next »
iri, 03/24/2011 07:52 PM

Texts¶

Widget that displays a text string, typically on multi lines.

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.

_gtkTextNew¶

Create a new text object.

Prototype : fun [Chn ObjGtkWidget S] [ObjGtkWidgetObjGtkWidget]

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.

_gtkTextGetBuffer¶

Return the current buffer object.

Prototype : fun [ObjGtkWidget] ObjGtkWidget
Text object -> buffer object.

_gtkTextSetBuffer¶

Sets a text buffer object as the buffer being displayed by a text object

Protototype : fun [ObjGtkWidget ObjGtkWidget] ObjGtkWidget

text	ObjGtkWidget	any text object already created
buffer	ObjGtkWidget	any text buffer object already created

Return : ObjGtkWidget : the same text object or nil if an error occurs

_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).

_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).

_gtkTextInsertWidget¶

Insert a widget in a text object.

Prototype : fun [ObjGtklWidget ObjGtklWidget I] ObjGtklWidget

text	ObjGtklWidget	any text object already created
child	ObjGtklWidget	a widget to insert in the text object
position	I	a position where the widget will be inserted

Return : ObjGtklWidget : the same object or, if an error occurs, returns nil.

_gtkTextScroll¶

Scrolls text object to the given position.
NOTE : this function could be updated and its prototype could be modified.

Prototype : fun [ObjGtkWidget I I I] I

text	ObjGtkWidget	a valid text object
position	I	a position of a character
alignx	I	horizontal position displayed of this character : 0 to left, 100 to right, 50, to center, etc
aligny	I	vertical position displayed of this character : 0 to top, 100 to bottom, 50, to center, etc

Return : I : 1 if scrolling occured, else 0. If an error occurs, returns nil.

Buffers¶

_gtkTextBufferNew¶

Create a new text buffer object.

Prototype : fun [Chn ObjGtkWidget] ObjGtkWidget

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

_gtkTextBufferInsert¶

Insert a string in a position

Prototype : fun [ObjGtkWidget S I] ObjGtkWidget

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.

_gtkTextBufferInsertCopy¶

Copy a string from a buffer (between two positions) to a buffer.
Bug

Prototype : fun [ObjGtkWidget I ObjGtkWidget I I] ObjGtkWidget

buffer	ObjGtkWidget	Any buffer already created (destination)
position	I	Any string to insert
buffer	ObjGtkWidget	Any other buffer already created (source)
position	I	A position. If nil, negative or greater than the current length of the buffer, the position will be the begin
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.

_gtkTextBufferInsertPix¶

Insert an image into a text buffer object, at a given position.

Prototype : fun [ObjGtkWidget P I I I I] ObjGtkWidget

buffer	ObjGtkWidget	any valid text buffer object
filename	P	a valid read-reference filename (relative at the Scol partition, of course)
position	I	a position to insert the image
width	I	a given width, or nil to keep the original width
height	I	a given height, or nil to keep the original height
ratio	I	1 to preserve the image's aspect ratio, else 0 or other value

Return : ObjGtkWidget : the same object or nil if error

_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.

_gtkTextBufferRem¶

Removes text between start and end positions from a text buffer object.

Prototype : fun [ObjGtkWidget I I] ObjGtkWidget

buffer	ObjGtkWidget	any text buffer object already created
start	I	a start position to begin the suppression. If nil, start will be at 0. If negative, start will be the total number of characters less start
end	I	another position. If nil, end will be the last character, if negative, end will be start - end (= the number of characters to remove)

Return : ObjGtkWidget : the same text buffer object or nil if an error occurs.

_gtkTextBufferSet¶

Set a string to a text buffer object. The old content is overwritten.

Prototype : fun [ObjGtkWidget S] ObjGtkWidget

buffer	ObjGtkWidget	any text buffer object
string	S	any string to set. If nil, the buffer will be empty (as "")

Return : ObjGtkWidget : the same object or nil if an error occurs.

_gtkTextBufferSetFrom¶

Set a string to a text buffer object from a given position. This function is at your convenience, you can do _gtkTextBufferRem and _gtkTextBufferInsert. The old content is overwritten.

Prototype : fun [ObjGtkWidget S I] ObjGtkWidget

buffer	ObjGtkWidget	any text buffer object
string	S	any string to set. If nil, the buffer will be empty (as "")
position	I	a position to begin the treatment. If nil, position will be at 0, if negative, it will be from the end.

Return : ObjGtkWidget : the same object or nil if an error occurs.

_gtkTextBufferGet¶

Returns the content to a text buffer object, without any invisible characters, without any embedded object. See _gtkTextBufferGetFull below too.

Prototype : fun [ObjGtkWidget] S

Return : S : a string or nil if error.

_gtkTextBufferGetFull¶

Returns from a buffer text object a string in the range [_start_, end].

Prototype : fun [ObjGtkWidget I I I I] S

buffer	ObjGtkWidget	any text buffer object
start	I	a position to begin the read. If start is equal at nil, start will be at 0, if negative, it will be from the end
end	I	a position to stop the read. If end is equal at nil, end will be at 0, if negative, it will be from the end.	If end is < start, they are reversed.
flagA	I	a flag, whether to include invisible text	SCOL_GTK_TEXT_WITH_HIDDENCHAR to include hidden characters, otherwise 0 or nil
flagB	I	a flag, whether to include embedded images or any others objects	SCOL_GTK_TEXT_WITH_OBJECT to include embedded object, otherwise 0 or nil. If it set, a 0xFFFC character will be included for each object in the current position

Return : S : the string or nil if error

_gtkTextBufferIsModified¶

Get or Set if the text buffer has been modified since the last call (or its creation)

Prototype : fun [ObjGtkWidget I] I

buffer	ObjGtkWidget	a valid text buffer object
value	I	To get the current state, value must be nil
		To set a new state, value must be 1 (true, is modified) or should be 0 (false, isn't modified)

Return : I : the current or the new state

_gtkTextBufferSelectionRem¶

Delete the currently selected text

Prototype : fun [ObjGtkWidget] ObjGtkWidget

Return : ObjGtkWidget : the same object or nil if error

Tags table¶

_gtkTextBufferGetTagTable¶

Gets the tags table associated with a text buffer object.