summaryrefslogtreecommitdiffstats
path: root/kdeui/kiconview.h
diff options
context:
space:
mode:
Diffstat (limited to 'kdeui/kiconview.h')
-rw-r--r--kdeui/kiconview.h281
1 files changed, 0 insertions, 281 deletions
diff --git a/kdeui/kiconview.h b/kdeui/kiconview.h
deleted file mode 100644
index 5d2735d10..000000000
--- a/kdeui/kiconview.h
+++ /dev/null
@@ -1,281 +0,0 @@
-/* This file is part of the KDE libraries
- Copyright (C) 1999 Torben Weis <weis@kde.org>
-
- This library is free software; you can redistribute it and/or
- modify it under the terms of the GNU Library General Public
- License version 2 as published by the Free Software Foundation.
-
- 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 KICONVIEW_H
-#define KICONVIEW_H
-
-#include <tqcursor.h>
-#include <tqiconview.h>
-
-#include <kdelibs_export.h>
-
-/**
- * @short A variant of TQIconView that honors KDE's system-wide settings.
- *
- * This Widget extends the functionality of TQIconView to honor the system
- * wide settings for Single Click/Double Click mode, Auto Selection and
- * Change Cursor over Link.
- *
- * There is a new signal executed(). It gets connected to either
- * TQIconView::clicked() or TQIconView::doubleClicked() depending on the KDE
- * wide Single Click/Double Click settings. It is strongly recommended that
- * you use this signal instead of the above mentioned. This way you donīt
- * need to care about the current settings.
- * If you want to get informed when the user selects something connect to the
- * TQIconView::selectionChanged() signal.
- *
- **/
-class KDEUI_EXPORT KIconView : public TQIconView
-{
- friend class KIconViewItem;
- Q_OBJECT
- Q_ENUMS( Mode )
- Q_PROPERTY( Mode mode READ mode WRITE setMode )
-
-public:
- KIconView( TQWidget *parent = 0, const char *name = 0, WFlags f = 0 );
-
- ~KIconView();
-
- /**
- * KIconView has two different operating modes. Execute mode is depending
- * on the configuration of single-click or double-click where the signal
- * executed() will be emitted upon click/double-click.
- * In Select mode, this signal will not be emitted.
- *
- * Default is Execute mode.
- */
- enum Mode { Execute, Select };
-
- /**
- * Sets the mode to Execute or Select.
- * @li In Execute mode, the signal executed()
- * will be emitted when the user clicks/double-clicks an item.
- * @li Select mode is
- * the normal TQIconView mode.
- *
- * Default is Execute.
- */
- void setMode( Mode m );
-
- /**
- * @returns the current Mode, either Execute or Select.
- */
- Mode mode() const;
-
- /**
- * Reimplemented for internal purposes
- */
- virtual void setFont( const TQFont & );
-
- /**
- * Set the maximum number of lines that will be used to display icon text.
- * Setting this value will enable word-wrap, too.
- * @since 3.3
- *
- * @param n Number of lines
- */
- void setIconTextHeight( int n );
-
- /**
- * @return The height of icon text in lines
- * @since 3.3
- */
- int iconTextHeight() const;
-
- /**
- * Reimplemented for held() signal behavior internal purposes
- */
- virtual void takeItem( TQIconViewItem * item );
-
-signals:
-
- /**
- * This signal is emitted whenever the user executes an iconview item.
- * That means depending on the KDE wide Single Click/Double Click
- * setting the user clicked or double clicked on that item.
- * @param item is the pointer to the executed iconview item.
- *
- * Note that you may not delete any TQIconViewItem objects in slots
- * connected to this signal.
- */
- void executed( TQIconViewItem *item );
-
- /**
- * This signal is emitted whenever the user executes an iconview item.
- * That means depending on the KDE wide Single Click/Double Click
- * setting the user clicked or double clicked on that item.
- * @param item is the pointer to the executed iconview item.
- * @param pos is the position where the user has clicked
- *
- * Note that you may not delete any TQIconViewItem objects in slots
- * connected to this signal.
- */
- void executed( TQIconViewItem *item, const TQPoint &pos );
-
- /**
- * This signal is emitted whenever the user hold something on an iconview
- * during a drag'n'drop.
- * @param item is the pointer to the iconview item the hold event occur.
- *
- * Note that you may not delete any TQIconViewItem objects in slots
- * connected to this signal.
- */
- void held( TQIconViewItem *item );
-
- /**
- * This signal gets emitted whenever the user double clicks into the
- * iconview.
- * @param item is the pointer to the clicked iconview item.
- * @param pos is the position where the user has clicked, and
- *
- * Note that you may not delete any TQIconViewItem objects in slots
- * connected to this signal.
- *
- * This signal is more or less here for the sake of completeness.
- * You should normally not need to use this. In most cases it's better
- * to use executed() instead.
- */
- void doubleClicked( TQIconViewItem *item, const TQPoint &pos );
-
-protected slots:
- void slotOnItem( TQIconViewItem *item );
- void slotOnViewport();
- void slotSettingsChanged(int);
-
- /**
- * Auto selection happend.
- */
- void slotAutoSelect();
-
-protected:
- void emitExecute( TQIconViewItem *item, const TQPoint &pos );
- void updateDragHoldItem( TQDropEvent *e );
-
- virtual void focusOutEvent( TQFocusEvent *fe );
- virtual void leaveEvent( TQEvent *e );
- virtual void contentsMousePressEvent( TQMouseEvent *e );
- virtual void contentsMouseDoubleClickEvent ( TQMouseEvent * e );
- virtual void contentsMouseReleaseEvent( TQMouseEvent *e );
- virtual void contentsDragEnterEvent( TQDragEnterEvent *e );
- virtual void contentsDragLeaveEvent( TQDragLeaveEvent *e );
- virtual void contentsDragMoveEvent( TQDragMoveEvent *e );
- virtual void contentsDropEvent( TQDropEvent* e );
- virtual void wheelEvent( TQWheelEvent *e );
-
- /**
- * This method allows to handle correctly cases where a subclass
- * needs the held() signal to not be triggered without calling
- * a KIconView::contentsDrag*Event() method (which have side effects
- * because they forward to TQIconView).
- */
- void cancelPendingHeldSignal();
-
-private slots:
- void slotMouseButtonClicked( int btn, TQIconViewItem *item, const TQPoint &pos );
- void slotDragHoldTimeout();
-
-private:
- /**
- * @internal. For use by KIconViewItem.
- */
- TQFontMetrics *itemFontMetrics() const;
- /**
- * @internal. For use by KIconViewItem.
- */
- TQPixmap selectedIconPixmap( TQPixmap *pix, const TQColor &col ) const;
-
- bool m_bUseSingle;
- bool m_bChangeCursorOverItem;
-
- TQIconViewItem* m_pCurrentItem;
-
- TQTimer* m_pAutoSelect;
- int m_autoSelectDelay;
-
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class KIconViewPrivate;
- KIconViewPrivate *d;
-};
-
-class KWordWrap;
-/**
- * @short A variant of TQIconViewItem that wraps words better.
- *
- * KIconViewItem exists to improve the word-wrap functionality of QIconViewItem
- * Use KIconViewItem instead of TQIconViewItem for any iconview item you might have :)
- *
- * @author David Faure <david@mandrakesoft.com>
- */
-class KDEUI_EXPORT KIconViewItem : public TQIconViewItem
-{
-public:
- // Need to redefine all the constructors - I want Java !
- KIconViewItem( TQIconView *parent )
- : TQIconViewItem( parent ) { init(); } // We need to call it because the parent ctor won't call our reimplementation :(((
- KIconViewItem( TQIconView *parent, TQIconViewItem *after )
- : TQIconViewItem( parent, after ) { init(); }
- KIconViewItem( TQIconView *parent, const TQString &text )
- : TQIconViewItem( parent, text ) { init(); }
- KIconViewItem( TQIconView *parent, TQIconViewItem *after, const TQString &text )
- : TQIconViewItem( parent, after, text ) { init(); }
- KIconViewItem( TQIconView *parent, const TQString &text, const TQPixmap &icon )
- : TQIconViewItem( parent, text, icon ) { init(); }
- KIconViewItem( TQIconView *parent, TQIconViewItem *after, const TQString &text, const TQPixmap &icon )
- : TQIconViewItem( parent, after, text, icon ) { init(); }
- KIconViewItem( TQIconView *parent, const TQString &text, const TQPicture &picture )
- : TQIconViewItem( parent, text, picture ) { init(); }
- KIconViewItem( TQIconView *parent, TQIconViewItem *after, const TQString &text, const TQPicture &picture )
- : TQIconViewItem( parent, after, text, picture ) { init(); }
- virtual ~KIconViewItem();
-
- /**
- * Using this function, you can specify a custom size for the pixmap. The
- * geometry of the item will be calculated to let a pixmap of the given size
- * fit in the iconView without needing an update.
- * This may be useful if you want to change the pixmap later without breaking
- * the layout. A possible use of this function is to replace a fileItem icon
- * by a larger pixmap (preview).
- * @since 3.3
- *
- * @param size The size to use
- */
- void setPixmapSize( const TQSize& size );
-
- /**
- * @return The size set by setPixmapSize() or TQSize( 0, 0 )
- * @since 3.3
- */
- TQSize pixmapSize() const;
-
-protected:
- void init();
- virtual void calcRect( const TQString& text_ = TQString::null );
- virtual void paintItem( TQPainter *p, const TQColorGroup &c );
- KWordWrap *wordWrap();
- void paintPixmap( TQPainter *p, const TQColorGroup &c );
- void paintText( TQPainter *p, const TQColorGroup &c );
-
-private:
- KWordWrap* m_wordWrap;
- struct KIconViewItemPrivate;
- KIconViewItemPrivate *d;
-};
-
-#endif
generated by cgit v1.2.1 (git 2.18.0) at 2024-11-13 02:54:57 +0000