## File: kpixmapsplitter.h

package info (click to toggle)
kdelibs 4:3.5.10.dfsg.1-5+deb6u1
 `123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123` ``````/* This file is part of the KDE libraries Copyright (C) 2000 Carsten Pfeiffer This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details. You should have received a copy of the GNU Library General Public License along with this library; see the file COPYING.LIB. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ #ifndef KPIXMAPSPLITTER_H #define KPIXMAPSPLITTER_H #include #include #include #include #include class KPixmapSplitterPrivate; /** * @short A class to split a pixmap into several items. * * If you have a pixmap containing several items (icons), you can use this * class to get the coordinates of each item. * * For example, if you have a pixmap with 25 items and you want to get the * 4th item as a pixmap (every item being 20x10 pixels): * \code * KPixmapSplitter splitter; * splitter.setPixmap( somePixmap ); * splitter.setItemSize( QSize( 20, 10 )); * * QPixmap item( 20, 10 ); * item.fill( Qt::white ); * QRect rect = splitter.coordinates( 4 ); * if ( !rect.isEmpty() ) * bitBlt( &item, QPoint(0,0), &somePixmap, rect, CopyROP ); * \endcode * * @author Carsten Pfeiffer */ class KDEFX_EXPORT KPixmapSplitter { public: /** * Constructor, does nothing but initialize some default-values. */ KPixmapSplitter(); ~KPixmapSplitter(); /** * Sets the pixmap to be split. */ void setPixmap( const QPixmap& pixmap ); /** * @returns the pixmap that has been set via setPixmap(). */ const QPixmap& pixmap() const { return m_pixmap; } /** * Sets the size of the items you want to get out of the given pixmap. * The QRect of #coordinates(int) will have the width and height of exactly * this @p size. */ void setItemSize( const QSize& size ); /** * @returns the set size of the items (coordinates) you want to get * out of the given pixmap. */ QSize itemSize() const { return m_itemSize; } /** * If there is space between rows in the given pixmap, you have to specify * how many pixels there are. */ void setVSpacing( int spacing ); /** * If there is space between columns in the given pixmap, you have to * specify how many pixels there are. */ void setHSpacing( int spacing ); /** * @returns the coordinates of the item at position pos in the given * pixmap. */ QRect coordinates( int pos ); /** * Overloaded for convenience. Returns the item at the position of the * given character (when using a latin1 font-pixmap) */ QRect coordinates( const QChar& ch ); private: QPixmap m_pixmap; QSize m_itemSize; int m_vSpacing; int m_hSpacing; int m_numCols; int m_numRows; bool m_dirty; KPixmapSplitterPrivate* d; }; #endif // KPIXMAPSPLITTER_H ``````