gi-atk-2.0.12: 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 #

Constructors

Table (ManagedPtr Table) 

Instances

GObject Table # 

Methods

gobjectType :: Table -> IO GType #

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

Methods

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

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

Methods

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

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

toTable :: (MonadIO m, IsTable o) => o -> m Table #

Methods

addColumnSelection

tableAddColumnSelection #

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 #

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 #

Instances

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

tableGetCaption #

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 #

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 #

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 #

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 #

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 #

Instances

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

tableGetIndexAt #

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 #

Instances

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

tableGetNColumns #

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 #

Instances

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

tableGetNRows #

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

data TableGetRowAtIndexMethodInfo #

Instances

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

tableGetRowAtIndex #

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 #

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

data TableGetRowExtentAtMethodInfo #

Instances

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

tableGetRowExtentAt #

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

data TableGetRowHeaderMethodInfo #

Instances

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

tableGetRowHeader #

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 #

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 #

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 #

Instances

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

tableGetSummary #

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 #

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

data TableIsRowSelectedMethodInfo #

Instances

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

tableIsRowSelected #

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 #

Instances

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

tableIsSelected #

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 #

Instances

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

Methods

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

tableRefAt #

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 #

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 #

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 #

Instances

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

tableSetCaption #

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 #

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 #

Instances

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

tableSetColumnHeader #

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

data TableSetRowDescriptionMethodInfo #

Instances

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

tableSetRowDescription #

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 #

Instances

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

tableSetRowHeader #

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 #

Instances

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

tableSetSummary #

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

type C_TableColumnDeletedCallback = Ptr () -> Int32 -> Int32 -> Ptr () -> IO () #

columnInserted

type C_TableColumnInsertedCallback = Ptr () -> Int32 -> Int32 -> Ptr () -> IO () #

columnReordered

type C_TableColumnReorderedCallback = Ptr () -> Ptr () -> IO () #

modelChanged

type C_TableModelChangedCallback = Ptr () -> Ptr () -> IO () #

rowDeleted

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

rowInserted

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

rowReordered

type C_TableRowReorderedCallback = Ptr () -> Ptr () -> IO () #