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

TQTableSelection Class Reference
[table module]

The TQTableSelection class provides access to a selected area in a TQTable. More...

#include <qtable.h>

List of all member functions.

Public Members

• TQTableSelection ()
• TQTableSelection ( 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 TQTableSelection & s ) const
• bool operator!= ( const TQTableSelection & 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 TQTable. 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 TQTableSelection is inactive -- isActive() returns FALSE. You must use init() and expandTo() to activate it.

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

Member Function Documentation

TQTableSelection::TQTableSelection ()

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

int TQTableSelection::anchorCol () const

Returns the anchor column of the selection.

See also anchorRow() and expandTo().

int TQTableSelection::anchorRow () const

Returns the anchor row of the selection.

See also anchorCol() and expandTo().

int TQTableSelection::bottomRow () const

Returns the bottom row of the selection.

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

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

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

See also init() and isActive().

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

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

See also isActive().

bool TQTableSelection::isActive () const

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

bool TQTableSelection::isEmpty () const

Returns whether the selection is empty or not.

See also numRows() and numCols().

int TQTableSelection::leftCol () const

Returns the left column of the selection.

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

int TQTableSelection::numCols () const

See also numRows().

int TQTableSelection::numRows () const

Returns the number of rows in the selection.

See also numCols().

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

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

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

int TQTableSelection::rightCol () const

Returns the right column of the selection.

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

int TQTableSelection::topRow () const

Returns the top row of the selection.

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

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