GtkClist Class

The GtkClist class is a container that presents data in a columnized list.

The class heirarchy


   Object
      +---GtkWidget
            +---GtkContainer
               +---GtkCList

The methods for the GtkCList class are documented below.

GtkClist Method Table of Contents

new - Create and initialize the widget
append - Append a new row
getcolumntitle - Get the title for a column
gettext - Get the text for a row/column entry
insert - Insert a new row
prepend - Prepend a new row
selected - Returns the selected row and column
setcolumntitle - Set the title for a column
setcolumnwidth - Set the width of a column
settext - Set the text for a row/column entry


Method: new

This method creates and initializes the widget.

Example

This is a example of how to create a new columnised list widget.


cols = 3
myclist = .GtkCList~new(cols)

Method Parameters

cols
The number of columns for the widget.

Method Results

The new GtkCList object.




Method: append

This method appends a new row to the end of the list.

Example

This is a example of how to append a new row to the columnised list.


col1 = 'Ashley'
col2 = 'David'
myclist~append(col1, col2)

Method Parameters

coln
The string to be placed into the new row/column.

Method Results

None.




Method: getcolumntitle

This method gets the title for a column.

Example

This is a example of how to get the title for a column.


title = myclist~getcolumntitle(col)

Method Parameters

col
The column number.

Method Results

The current column title.




Method: gettext

This method gets the text for a row/column.

Example

This is a example of how to get the text for a row/column.


text = myclist~gettext(row, col)

Method Parameters

row
The row number.
col
The column number.

Method Results

The current column text.




Method: insert

This method inserts a new row into the list.

Example

This is a example of how to insert a new row to the columnised list.


col1 = 'Ashley'
col2 = 'David'
myclist~append(row, col1, col2)

Method Parameters

row
The row number. The new row wil become this row and all existing rows after this row will be moved down in the list.
coln
The string to be placed into the new row/column.

Method Results

None.




Method: prepend

This method prepends a new row to the beginning of the list.

Example

This is a example of how to prepend a new row to the columnised list.


col1 = 'Ashley'
col2 = 'David'
myclist~prepend(col1, col2)

Method Parameters

coln
The string to be placed into the new row/column.

Method Results

None.




Method: selected

This method gets the selected row/column.

Example

This is a example of how to get the selected row/column.


selected = myclist~selected()
parse var selected row col

Method Parameters

None.

Method Results

The current selected row and column.




Method: setcolumntitle

This method sets the column title.

Example

This is a example of how to set the column title.


title = 'Last Name'
col = 1
myclist~setcolumntitle(col, title)

Method Parameters

col
The column number.
title
The column title text.

Method Results

None.




Method: setcolumnwidth

This method sets the column width.

Example

This is a example of how to set the column width.


width = 10
col = 1
myclist~setcolumnwidth(col, width)

Method Parameters

col
The column number.
width
The column width in pixels.

Method Results

None.




Method: settext

This method sets the row/column text.

Example

This is a example of how to set the row/column text.


text = 'Payne'
row = 1
col = 1
myclist~settext(row, col, text)

Method Parameters

row
The row number.
col
The column number.
width
The new text for the row/column.

Method Results

None.




Valid XHTML 1.0!