libtdepim

KPIM::KPixmapRegionSelectorDialog Class Reference

A dialog that uses a KPixmapRegionSelectorWidget to allow the user to select a region of an image. More...

#include <kpixmapregionselectordialog.h>

Inherits KDialogBase.

List of all members.

Public Member Functions

 KPixmapRegionSelectorDialog (TQWidget *parent=0L, const char *name=0L, bool modal=false)
 ~KPixmapRegionSelectorDialog ()
KPIM::KPixmapRegionSelectorWidgetpixmapRegionSelectorWidget () const

Static Public Member Functions

static TQRect getSelectedRegion (const TQPixmap &pixmap, TQWidget *parent=0L)
static TQRect getSelectedRegion (const TQPixmap &pixmap, int aspectRatioWidth, int aspectRatioHeight, TQWidget *parent=0L)
static TQImage getSelectedImage (const TQPixmap &pixmap, TQWidget *parent=0L)
static TQImage getSelectedImage (const TQPixmap &pixmap, int aspectRatioWidth, int aspectRatioHeight, TQWidget *parent=0L)

Protected Attributes

KPIM::KPixmapRegionSelectorWidgetm_pixmapSelectorWidget

Detailed Description

A dialog that uses a KPixmapRegionSelectorWidget to allow the user to select a region of an image.

If you want to use special features like forcing the selected area to have a fixed aspect ratio, you can use

See also:
pixmapRegionSelectorWidget() to get the pointer to the pixmapRegionSelectorWidget object and set the desired options there.

There are some convenience methods that allow to easily show a dialog for the user to select a region of an image, and just care about the selected image.

Author:
Antonio Larrosa <larrosa@kde.org>
Since:
3.4

Definition at line 46 of file kpixmapregionselectordialog.h.


Constructor & Destructor Documentation

KPixmapRegionSelectorDialog::KPixmapRegionSelectorDialog ( TQWidget *  parent = 0L,
const char *  name = 0L,
bool  modal = false 
)

The constructor of an empty KPixmapRegionSelectorDialog, you have to call later the setPixmap method of the KPixmapRegionSelectorWidget widget of the new object.

Definition at line 31 of file kpixmapregionselectordialog.cpp.

KPixmapRegionSelectorDialog::~KPixmapRegionSelectorDialog (  ) 

The destructor of the dialog.

Definition at line 43 of file kpixmapregionselectordialog.cpp.


Member Function Documentation

TQImage KPixmapRegionSelectorDialog::getSelectedImage ( const TQPixmap &  pixmap,
TQWidget *  parent = 0L 
) [static]

Creates a modal dialog, lets the user to select a region of the pixmap and returns when the dialog is closed.

Returns:
the selected image, or an invalid image if the user pressed the Cancel button.

Definition at line 90 of file kpixmapregionselectordialog.cpp.

TQImage KPixmapRegionSelectorDialog::getSelectedImage ( const TQPixmap &  pixmap,
int  aspectRatioWidth,
int  aspectRatioHeight,
TQWidget *  parent = 0L 
) [static]

Creates a modal dialog, lets the user to select a region of the pixmap with the same aspect ratio than aspectRatioWidth x aspectRatioHeight and returns when the dialog is closed.

Returns:
the selected image, or an invalid image if the user pressed the Cancel button.

Definition at line 110 of file kpixmapregionselectordialog.cpp.

TQRect KPixmapRegionSelectorDialog::getSelectedRegion ( const TQPixmap &  pixmap,
TQWidget *  parent = 0L 
) [static]

Creates a modal dialog, lets the user to select a region of the pixmap and returns when the dialog is closed.

Returns:
the selected rectangle, or an invalid rectangle if the user pressed the Cancel button.

Definition at line 47 of file kpixmapregionselectordialog.cpp.

TQRect KPixmapRegionSelectorDialog::getSelectedRegion ( const TQPixmap &  pixmap,
int  aspectRatioWidth,
int  aspectRatioHeight,
TQWidget *  parent = 0L 
) [static]

Creates a modal dialog, lets the user to select a region of the pixmap with the same aspect ratio than aspectRatioWidth x aspectRatioHeight and returns when the dialog is closed.

Returns:
the selected rectangle, or an invalid rectangle if the user pressed the Cancel button.

Definition at line 68 of file kpixmapregionselectordialog.cpp.

KPIM::KPixmapRegionSelectorWidget* KPIM::KPixmapRegionSelectorDialog::pixmapRegionSelectorWidget (  )  const [inline]
Returns:
the KPixmapRegionSelectorWidget widget so that additional parameters can be set by using it.

Definition at line 65 of file kpixmapregionselectordialog.h.


The documentation for this class was generated from the following files: