You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
66 lines
1.7 KiB
66 lines
1.7 KiB
// -*- C++ -*-
|
|
//
|
|
// pageNumber.h
|
|
//
|
|
// Part of KVIEWSHELL - A framework for multipage text/gfx viewers
|
|
//
|
|
// (C) 2004 Stefan Kebekus
|
|
// Distributed under the GPL
|
|
|
|
// Add header files alphabetically
|
|
|
|
#ifndef PAGENUMBER_H
|
|
#define PAGENUMBER_H
|
|
|
|
#include <tqglobal.h>
|
|
|
|
|
|
/** \brief Class to represent a page number
|
|
|
|
The class PageNumber is really nothing but an alias for Q_UINT16, and
|
|
can be casted to and from Q_UINT16. It is used in kviewshell to remind
|
|
the programmer of the convention that page numbers start at '1' (for
|
|
'first page'), and that the value '0' means 'illegal page number' or
|
|
'no page number'. Accordingly, the value '0' is also named
|
|
PageNumber::invalidPage, and there is a trivial method isInvalid()
|
|
that checks if the page number is 0.
|
|
|
|
@author Stefan Kebekus <kebekus@kde.org>
|
|
@version 1.0 0
|
|
*/
|
|
|
|
class PageNumber
|
|
{
|
|
public:
|
|
enum pageNums {
|
|
invalidPage = 0 /*! Invalid page number */
|
|
};
|
|
|
|
/** The default constructor sets the page number to 'invalidPage' */
|
|
PageNumber() {pgNum = invalidPage;}
|
|
|
|
/** \brief Constructor that sets the page number
|
|
|
|
@param num page number that is set initially
|
|
*/
|
|
PageNumber(Q_UINT16 num) {pgNum = num;}
|
|
|
|
/** \brief this method implements typecasts from Q_UINT16 */
|
|
PageNumber &operator=(const Q_UINT16 p) { pgNum = p; return *this; }
|
|
|
|
/** \brief This method implements typecasts to Q_UINT16 */
|
|
operator Q_UINT16() const { return pgNum; }
|
|
|
|
/** \brief Checks if the page number is invalid
|
|
|
|
@returns true, if pgNum != invalidPage, i.e., does not equal 0
|
|
*/
|
|
bool isValid() const {return (pgNum != invalidPage);}
|
|
|
|
private:
|
|
/** \brief Single number that represents the page number */
|
|
Q_UINT16 pgNum;
|
|
};
|
|
|
|
#endif
|