Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions

QTableSelection Class Reference
[table module]

The QTableSelection class provides access to a selected area in a QTable. More...

#include <qtable.h>

List of all member functions.

Public Members

• QTableSelection ()
• QTableSelection ( int start_row, int start_col, int end_row, int end_col )
• void init ( int row, int col )
• void expandTo ( int row, int col )
• bool operator== ( const QTableSelection & s ) const
• bool operator!= ( const QTableSelection & s ) const
• int topRow () const
• int bottomRow () const
• int leftCol () const
• int rightCol () const
• int anchorRow () const
• int anchorCol () const
• int numRows () const
• int numCols () const
• bool isActive () const
• bool isEmpty () const

Detailed Description

The selection is a rectangular set of cells in a QTable. One of the rectangle's cells is called the anchor cell; this is the cell that was selected first. The init() function sets the anchor and the selection rectangle to exactly this cell; the expandTo() function expands the selection rectangle to include additional cells.

There are various access functions to find out about the area: anchorRow() and anchorCol() return the anchor's position; leftCol(), rightCol(), topRow() and bottomRow() return the rectangle's four edges. All four are part of the selection.

A newly created QTableSelection is inactive -- isActive() returns FALSE. You must use init() and expandTo() to activate it.

See also QTable, QTable::addSelection(), QTable::selection(), QTable::selectCells(), QTable::selectRow(), QTable::selectColumn(), and Advanced Widgets.

Member Function Documentation

QTableSelection::QTableSelection ()

QTableSelection::QTableSelection ( int start_row, int start_col, int end_row, int end_col )

int QTableSelection::anchorCol () const

Returns the anchor column of the selection.

See also anchorRow() and expandTo().

int QTableSelection::anchorRow () const

Returns the anchor row of the selection.

See also anchorCol() and expandTo().

int QTableSelection::bottomRow () const

Returns the bottom row of the selection.

See also topRow(), leftCol(), and rightCol().

void QTableSelection::expandTo ( int row, int col )

If you haven't called init(), this function does nothing.

See also init() and isActive().

void QTableSelection::init ( int row, int col )

To extend the selection to include additional cells, call expandTo().

See also isActive().

bool QTableSelection::isActive () const

Returns whether the selection is active or not. A selection is active after init() and expandTo() have been called.

bool QTableSelection::isEmpty () const

Returns whether the selection is empty or not.

See also numRows() and numCols().

int QTableSelection::leftCol () const

Returns the left column of the selection.

See also topRow(), bottomRow(), and rightCol().

int QTableSelection::numCols () const

See also numRows().

int QTableSelection::numRows () const

Returns the number of rows in the selection.

See also numCols().

bool QTableSelection::operator!= ( const QTableSelection & s ) const

Returns TRUE if s does not include the same cells as the selection; otherwise returns FALSE.

bool QTableSelection::operator== ( const QTableSelection & s ) const

int QTableSelection::rightCol () const

Returns the right column of the selection.

See also topRow(), bottomRow(), and leftCol().

int QTableSelection::topRow () const

Returns the top row of the selection.

See also bottomRow(), leftCol(), and rightCol().

This file is part of the Qt toolkit. Copyright © 1995-2007 Trolltech. All Rights Reserved.