gi-atk-2.0.11: Atk bindings

CopyrightWill Thompson, Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria (garetxe@gmail.com)
Safe HaskellNone
LanguageHaskell2010

GI.Atk.Interfaces.Table

Contents

Description

Table should be implemented by components which present elements ordered via rows and columns. It may also be used to present tree-structured information if the nodes of the trees can be said to contain multiple "columns". Individual elements of an Table are typically referred to as "cells". Those cells should implement the interface TableCell, but Atk doesn't require them to be direct children of the current Table. They can be grand-children, grand-grand-children etc. Table provides the API needed to get a individual cell based on the row and column numbers.

Children of Table are frequently "lightweight" objects, that is, they may not have backing widgets in the host UI toolkit. They are therefore often transient.

Since tables are often very complex, Table includes provision for offering simplified summary information, as well as row and column headers and captions. Headers and captions are AtkObjects which may implement other interfaces (Text, Image, etc.) as appropriate. Table summaries may themselves be (simplified) AtkTables, etc.

Note for implementors: in the past, Table required that all the cells should be direct children of Table, and provided some index based methods to request the cells. The practice showed that that forcing made Table implementation complex, and hard to expose other kind of children, like rows or captions. Right now, index-based methods are deprecated.

Synopsis

Exported types

newtype Table Source #

Constructors

Table (ManagedPtr Table) 

Instances

WrappedPtr Table Source # 
IsTable Table Source # 
((~) * info (ResolveTableMethod t Table), MethodInfo * info Table p) => IsLabel t (Table -> p) Source # 

Methods

fromLabel :: Proxy# Symbol t -> Table -> p #

((~) * info (ResolveTableMethod t Table), MethodInfo * info Table p) => IsLabelProxy t (Table -> p) Source # 

Methods

fromLabelProxy :: Proxy Symbol t -> Table -> p #

HasAttributeList * Table Source # 
type AttributeList Table Source # 
type SignalList Table Source # 

Methods

addColumnSelection

tableAddColumnSelection Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

column: a gint representing a column in table

-> m Bool

Returns: a gboolean representing if the column was successfully added to the selection, or 0 if value does not implement this interface.

Adds the specified column to the selection.

addRowSelection

tableAddRowSelection Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in table

-> m Bool

Returns: a gboolean representing if row was successfully added to selection, or 0 if value does not implement this interface.

Adds the specified row to the selection.

getCaption

data TableGetCaptionMethodInfo Source #

Instances

((~) * signature (m (Maybe Object)), MonadIO m, IsTable a) => MethodInfo * TableGetCaptionMethodInfo a signature Source # 

tableGetCaption Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableInterface

-> m (Maybe Object)

Returns: a AtkObject* representing the table caption, or Nothing if value does not implement this interface.

Gets the caption for the table.

getColumnAtIndex

tableGetColumnAtIndex Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableInterface

-> Int32

index_: a gint representing an index in table

-> m Int32

Returns: a gint representing the column at the specified index, or -1 if the table does not implement this method.

Deprecated: Since 2.12.

Gets a gint representing the column at the specified index_.

getColumnDescription

tableGetColumnDescription Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

column: a gint representing a column in table

-> m Text

Returns: a gchar* representing the column description, or Nothing if value does not implement this interface.

Gets the description text of the specified column in the table

getColumnExtentAt

tableGetColumnExtentAt Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in table

-> Int32

column: a gint representing a column in table

-> m Int32

Returns: a gint representing the column extent at specified position, or 0 if value does not implement this interface.

Gets the number of columns occupied by the accessible object at the specified row and column in the table.

getColumnHeader

tableGetColumnHeader Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

column: a gint representing a column in the table

-> m (Maybe Object)

Returns: a AtkObject* representing the specified column header, or Nothing if value does not implement this interface.

Gets the column header of a specified column in an accessible table.

getIndexAt

data TableGetIndexAtMethodInfo Source #

Instances

((~) * signature (Int32 -> Int32 -> m Int32), MonadIO m, IsTable a) => MethodInfo * TableGetIndexAtMethodInfo a signature Source # 

tableGetIndexAt Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in table

-> Int32

column: a gint representing a column in table

-> m Int32

Returns: a gint representing the index at specified position. The value -1 is returned if the object at row,column is not a child of table or table does not implement this interface.

Deprecated: Since 2.12. Use tableRefAt in order to get theaccessible that represents the cell at (row, column)

Gets a gint representing the index at the specified row and column.

getNColumns

data TableGetNColumnsMethodInfo Source #

Instances

((~) * signature (m Int32), MonadIO m, IsTable a) => MethodInfo * TableGetNColumnsMethodInfo a signature Source # 

tableGetNColumns Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> m Int32

Returns: a gint representing the number of columns, or 0 if value does not implement this interface.

Gets the number of columns in the table.

getNRows

data TableGetNRowsMethodInfo Source #

Instances

((~) * signature (m Int32), MonadIO m, IsTable a) => MethodInfo * TableGetNRowsMethodInfo a signature Source # 

tableGetNRows Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> m Int32

Returns: a gint representing the number of rows, or 0 if value does not implement this interface.

Gets the number of rows in the table.

getRowAtIndex

tableGetRowAtIndex Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableInterface

-> Int32

index_: a gint representing an index in table

-> m Int32

Returns: a gint representing the row at the specified index, or -1 if the table does not implement this method.

Deprecated: since 2.12.

Gets a gint representing the row at the specified index_.

getRowDescription

tableGetRowDescription Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in table

-> m (Maybe Text)

Returns: a gchar* representing the row description, or Nothing if value does not implement this interface.

Gets the description text of the specified row in the table

getRowExtentAt

tableGetRowExtentAt Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in table

-> Int32

column: a gint representing a column in table

-> m Int32

Returns: a gint representing the row extent at specified position, or 0 if value does not implement this interface.

Gets the number of rows occupied by the accessible object at a specified row and column in the table.

getRowHeader

tableGetRowHeader Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in the table

-> m (Maybe Object)

Returns: a AtkObject* representing the specified row header, or Nothing if value does not implement this interface.

Gets the row header of a specified row in an accessible table.

getSelectedColumns

tableGetSelectedColumns Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

selected: a gint** that is to contain the selected columns numbers

-> m Int32

Returns: a gint representing the number of selected columns, or 0 if value does not implement this interface.

Gets the selected columns of the table by initializing **selected with the selected column numbers. This array should be freed by the caller.

getSelectedRows

tableGetSelectedRows Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

selected: a gint** that is to contain the selected row numbers

-> m Int32

Returns: a gint representing the number of selected rows, or zero if value does not implement this interface.

Gets the selected rows of the table by initializing **selected with the selected row numbers. This array should be freed by the caller.

getSummary

data TableGetSummaryMethodInfo Source #

Instances

((~) * signature (m Object), MonadIO m, IsTable a) => MethodInfo * TableGetSummaryMethodInfo a signature Source # 

tableGetSummary Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> m Object

Returns: a AtkObject* representing a summary description of the table, or zero if value does not implement this interface.

Gets the summary description of the table.

isColumnSelected

tableIsColumnSelected Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

column: a gint representing a column in table

-> m Bool

Returns: a gboolean representing if the column is selected, or 0 if value does not implement this interface.

Gets a boolean value indicating whether the specified column is selected

isRowSelected

tableIsRowSelected Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in table

-> m Bool

Returns: a gboolean representing if the row is selected, or 0 if value does not implement this interface.

Gets a boolean value indicating whether the specified row is selected

isSelected

data TableIsSelectedMethodInfo Source #

Instances

((~) * signature (Int32 -> Int32 -> m Bool), MonadIO m, IsTable a) => MethodInfo * TableIsSelectedMethodInfo a signature Source # 

tableIsSelected Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in table

-> Int32

column: a gint representing a column in table

-> m Bool

Returns: a gboolean representing if the cell is selected, or 0 if value does not implement this interface.

Gets a boolean value indicating whether the accessible object at the specified row and column is selected

refAt

data TableRefAtMethodInfo Source #

Instances

((~) * signature (Int32 -> Int32 -> m Object), MonadIO m, IsTable a) => MethodInfo * TableRefAtMethodInfo a signature Source # 

Methods

overloadedMethod :: MethodProxy TableRefAtMethodInfo a -> signature -> s #

tableRefAt Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in table

-> Int32

column: a gint representing a column in table

-> m Object

Returns: an Object representing the referred to accessible

Get a reference to the table cell at row, column. This cell should implement the interface TableCell

removeColumnSelection

tableRemoveColumnSelection Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

column: a gint representing a column in table

-> m Bool

Returns: a gboolean representing if the column was successfully removed from the selection, or 0 if value does not implement this interface.

Adds the specified column to the selection.

removeRowSelection

tableRemoveRowSelection Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in table

-> m Bool

Returns: a gboolean representing if the row was successfully removed from the selection, or 0 if value does not implement this interface.

Removes the specified row from the selection.

setCaption

data TableSetCaptionMethodInfo Source #

Instances

((~) * signature (b -> m ()), MonadIO m, IsTable a, IsObject b) => MethodInfo * TableSetCaptionMethodInfo a signature Source # 

tableSetCaption Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a, IsObject b) 
=> a

table: a GObject instance that implements AtkTableIface

-> b

caption: a Object representing the caption to set for table

-> m () 

Sets the caption for the table.

setColumnDescription

tableSetColumnDescription Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

column: a gint representing a column in table

-> Text

description: a gchar representing the description text to set for the specified column of the table

-> m () 

Sets the description text for the specified column of the table.

setColumnHeader

data TableSetColumnHeaderMethodInfo Source #

Instances

((~) * signature (Int32 -> b -> m ()), MonadIO m, IsTable a, IsObject b) => MethodInfo * TableSetColumnHeaderMethodInfo a signature Source # 

tableSetColumnHeader Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a, IsObject b) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

column: a gint representing a column in table

-> b

header: an Table

-> m () 

Sets the specified column header to header.

setRowDescription

tableSetRowDescription Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in table

-> Text

description: a gchar representing the description text to set for the specified row of table

-> m () 

Sets the description text for the specified row of table.

setRowHeader

data TableSetRowHeaderMethodInfo Source #

Instances

((~) * signature (Int32 -> b -> m ()), MonadIO m, IsTable a, IsObject b) => MethodInfo * TableSetRowHeaderMethodInfo a signature Source # 

tableSetRowHeader Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a, IsObject b) 
=> a

table: a GObject instance that implements AtkTableIface

-> Int32

row: a gint representing a row in table

-> b

header: an Table

-> m () 

Sets the specified row header to header.

setSummary

data TableSetSummaryMethodInfo Source #

Instances

((~) * signature (b -> m ()), MonadIO m, IsTable a, IsObject b) => MethodInfo * TableSetSummaryMethodInfo a signature Source # 

tableSetSummary Source #

Arguments

:: (HasCallStack, MonadIO m, IsTable a, IsObject b) 
=> a

table: a GObject instance that implements AtkTableIface

-> b

accessible: an Object representing the summary description to set for table

-> m () 

Sets the summary description of the table.

Signals

columnDeleted

columnInserted

columnReordered

modelChanged

rowDeleted

type C_TableRowDeletedCallback = Ptr () -> Int32 -> Int32 -> Ptr () -> IO () Source #

rowInserted

type C_TableRowInsertedCallback = Ptr () -> Int32 -> Int32 -> Ptr () -> IO () Source #

rowReordered