• Skip to content
  • Skip to link menu
Trinity API Reference
  • Trinity API Reference
  • kdeui
 

kdeui

Public Types | Signals | Public Member Functions | Protected Slots | Protected Member Functions | Properties | Friends | List of all members
KIconView Class Reference

#include <kiconview.h>

Inherits TQIconView.

Public Types

enum  Mode { Execute , Select }
 

Signals

void executed (TQIconViewItem *item)
 
void executed (TQIconViewItem *item, const TQPoint &pos)
 
void held (TQIconViewItem *item)
 
void doubleClicked (TQIconViewItem *item, const TQPoint &pos)
 

Public Member Functions

 KIconView (TQWidget *parent=0, const char *name=0, WFlags f=0)
 
void setMode (Mode m)
 
Mode mode () const
 
virtual void setFont (const TQFont &)
 
void setIconTextHeight (int n)
 
int iconTextHeight () const
 
virtual void takeItem (TQIconViewItem *item)
 

Protected Slots

void slotOnItem (TQIconViewItem *item)
 
void slotOnViewport ()
 
void slotSettingsChanged (int)
 
void slotAutoSelect ()
 

Protected Member Functions

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)
 
void cancelPendingHeldSignal ()
 
virtual void virtual_hook (int id, void *data)
 

Properties

Mode mode
 

Friends

class KIconViewItem
 

Detailed Description

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.

Definition at line 42 of file kiconview.h.

Member Enumeration Documentation

◆ Mode

enum KIconView::Mode

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.

Definition at line 62 of file kiconview.h.

Member Function Documentation

◆ cancelPendingHeldSignal()

void KIconView::cancelPendingHeldSignal ( )
protected

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).

Definition at line 382 of file kiconview.cpp.

◆ doubleClicked

void KIconView::doubleClicked ( TQIconViewItem *  item,
const TQPoint &  pos 
)
signal

This signal gets emitted whenever the user double clicks into the iconview.

Parameters
itemis the pointer to the clicked iconview item.
posis 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.

◆ executed [1/2]

void KIconView::executed ( TQIconViewItem *  item)
signal

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.

Parameters
itemis the pointer to the executed iconview item.

Note that you may not delete any TQIconViewItem objects in slots connected to this signal.

◆ executed [2/2]

void KIconView::executed ( TQIconViewItem *  item,
const TQPoint &  pos 
)
signal

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.

Parameters
itemis the pointer to the executed iconview item.
posis the position where the user has clicked

Note that you may not delete any TQIconViewItem objects in slots connected to this signal.

◆ held

void KIconView::held ( TQIconViewItem *  item)
signal

This signal is emitted whenever the user hold something on an iconview during a drag'n'drop.

Parameters
itemis 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.

◆ iconTextHeight()

int KIconView::iconTextHeight ( ) const
Returns
The height of icon text in lines
Since
3.3

Definition at line 427 of file kiconview.cpp.

◆ mode()

KIconView::Mode KIconView::mode ( ) const
Returns
the current Mode, either Execute or Select.

Definition at line 95 of file kiconview.cpp.

◆ setFont()

void KIconView::setFont ( const TQFont &  font)
virtual

Reimplemented for internal purposes.

Definition at line 401 of file kiconview.cpp.

◆ setIconTextHeight()

void KIconView::setIconTextHeight ( int  n)

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
Parameters
nNumber of lines

Definition at line 432 of file kiconview.cpp.

◆ setMode()

void KIconView::setMode ( KIconView::Mode  mode)

Sets the mode to Execute or Select.

  • In Execute mode, the signal executed() will be emitted when the user clicks/double-clicks an item.
  • Select mode is the normal TQIconView mode.

Default is Execute.

Definition at line 90 of file kiconview.cpp.

◆ slotAutoSelect

void KIconView::slotAutoSelect ( )
protectedslot

Auto selection happend.

Definition at line 160 of file kiconview.cpp.

◆ takeItem()

void KIconView::takeItem ( TQIconViewItem *  item)
virtual

Reimplemented for held() signal behavior internal purposes.

Definition at line 371 of file kiconview.cpp.


The documentation for this class was generated from the following files:
  • kiconview.h
  • kiconview.cpp

kdeui

Skip menu "kdeui"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdeui

Skip menu "kdeui"
  • arts
  • dcop
  • dnssd
  • interfaces
  •     interface
  •     library
  •   kspeech
  •   ktexteditor
  • kabc
  • kate
  • kcmshell
  • kdecore
  • kded
  • kdefx
  • kdeprint
  • kdesu
  • kdeui
  • kdoctools
  • khtml
  • kimgio
  • kinit
  • kio
  •   bookmarks
  •   httpfilter
  •   kfile
  •   kio
  •   kioexec
  •   kpasswdserver
  •   kssl
  • kioslave
  •   http
  • kjs
  • kmdi
  •   kmdi
  • knewstuff
  • kparts
  • krandr
  • kresources
  • kspell2
  • kunittest
  • kutils
  • kwallet
  • libkmid
  • libkscreensaver
Generated for kdeui by doxygen 1.9.1
This website is maintained by Timothy Pearson.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. |