/* This file is part of the KDE project Copyright (C) 1999, 2000, 2001, 2002 David Faure 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 __kfileivi_h__ #define __kfileivi_h__ #include #include #include class KFileItem; class KonqIconViewWidget; class KIVDirectoryOverlay; /** * KFileIVI (short form of "Konq - File - IconViewItem") * is, as expected, an improved KIconViewItem, because * it represents a file. * All the information about the file is contained in the KFileItem * pointer. */ class LIBKONQ_EXPORT KFileIVI : public KIconViewItem { public: /** * Create an icon, within a qlistview, representing a file * @param iconview the parent widget * @param fileitem the file item created by KDirLister * @param size the icon size */ KFileIVI( KonqIconViewWidget *iconview, KFileItem* fileitem, int size ); virtual ~KFileIVI(); /** * Handler for return (or single/double click) on ONE icon. * Runs the file through KRun. */ virtual void returnPressed(); /** * @return the file item held by this instance */ KFileItem * item() const { return m_fileitem; } /** * @return true if dropping on this file is allowed * Overloads TQIconView::acceptDrop() */ virtual bool acceptDrop( const TQMimeSource *mime ) const; /** * Changes the icon for this item. * @param size the icon size (0 for default, otherwise size in pixels) * @param state the state of the icon (enum in KIcon) * @param recalc whether to update the tqlayout of the icon view when setting the icon * @param redraw whether to redraw the item after setting the icon */ virtual void setIcon( int size, int state=KIcon::DefaultState, bool recalc=false, bool redraw=false); /** * Bypass @ref setIcon. This is for animated icons, you should use setIcon * in all other cases. * @param pixmap the pixmap to set - it SHOULD really have the right icon size! * @param recalc whether to update the tqlayout of the icon view when setting the icon * @param redraw whether to redraw the item after setting the icon */ void setPixmapDirect( const TQPixmap & pixmap, bool recalc=false, bool redraw=false); /** * Notifies that all icon effects on thumbs should be tqinvalidated, * e.g. because the effect settings have been changed. The thumb itself * is assumed to be still valid (use setThumbnailPixmap() instead * otherwise). * @param state the state of the icon (enum in KIcon) * @param redraw whether to redraw the item after setting the icon */ void tqinvalidateThumb( int state, bool redraw = false ); /** * Our current thumbnail is not longer "current". * Called when the file contents have changed. */ void invalidateThumbnail(); bool isThumbnailInvalid() const; bool hasValidThumbnail() const { return isThumbnail() && !isThumbnailInvalid(); } /** * Return the current state of the icon * (KIcon::DefaultState, KIcon::ActiveState etc.) */ int state() const { return m_state; } /** * Return the theorical size of the icon */ int iconSize() const { return m_size; } /** * Set to true when this icon is 'cut' */ void setDisabled( bool disabled ); /** * Set this when the thumbnail was loaded */ void setThumbnailPixmap( const TQPixmap & pixmap ); /** * Set the icon to use the specified KIconEffect * See the docs for KIconEffect for details. */ void setEffect( /*int group,*/ int state ); /** * @return true if this item is a thumbnail */ bool isThumbnail() const { return m_bThumbnail; } /** * Sets an icon to be shown over the bottom left corner of the icon. * Currently used for directory overlays. * setOverlay(TQString::null) to remove icon. */ void setOverlay( const TQString & iconName); /** * Redetermines the icon (useful if KFileItem might return another icon). * Does nothing with thumbnails */ virtual void refreshIcon( bool redraw ); virtual void setKey( const TQString &key ); /** * Paints this item. Takes care of using the normal or alpha * blending methods depending on the configuration. */ virtual void paintItem( TQPainter *p, const TQColorGroup &cg ); virtual bool move( int x, int y ); /** * Enable an animation on mouseover, if there is an available mng. * @param movieFileName the base name for the mng, e.g. "folder". * Nothing happens if there is no animation available. */ void setMouseOverAnimation( const TQString& movieFileName ); TQString mouseOverAnimation() const; /** * Return true if the icon _might_ have an animation available. * This doesn't mean the .mng exists (only determined when hovering on the * icon - and if it doesn't exist setMouseOverAnimation(TQString::null) is called), * and it doesn't mean that it's currently running either. */ bool hasAnimation() const; /** Return true if we are currently animating this icon */ bool isAnimated() const; void setAnimated( bool ); /** Called when the mouse is over the icon */ void setActive( bool active ); /** * Sets showing of directory overlays. Does nothing if this does * not represent a folder. */ KIVDirectoryOverlay* setShowDirectoryOverlay( bool ); bool showDirectoryOverlay( ); virtual int compare( TQIconViewItem *i ) const; protected: virtual void dropped( TQDropEvent *e, const TQValueList & ); /** * Contains the logic and code for painting the overlay pixmap. */ void paintOverlay( TQPainter *p ) const; /** * Updates the colorgroup. */ TQColorGroup updateColors(const TQColorGroup &c) const; /** * Contains the logic and code for painting links. */ void paintFontUpdate( TQPainter *p ) const; private: /** You are not supposed to call this on a KFileIVI, from the outside, * it bypasses the icons cache */ virtual void setPixmap ( const TQPixmap & icon ) { KIconViewItem::setPixmap( icon ); } virtual void setPixmap ( const TQPixmap & icon, bool recalc, bool redraw = TRUE ) { KIconViewItem::setPixmap( icon, recalc, redraw ); } /** Check if a thumbnail will be generated and calc the size of the icon */ void updatePixmapSize(); int m_size, m_state; bool m_bDisabled; bool m_bThumbnail; /** Pointer to the file item in KDirLister's list */ KFileItem* m_fileitem; /** * Private data for KFileIVI * Implementation in kfileivi.cc */ struct Private; Private *d; }; #endif