# class KPixmapRegionSelectorDialog

###

Module | kdeui
Namespace |
Class | KPixmapRegionSelectorDialog
Inherits | KDialog

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 KPixmapRegionSelectorWidget 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>

### methods

- KPixmapRegionSelectorDialog (parent)

  returns ctor
  KDE 4.1.0 and later only

  Argument | Type | Default
  --- | --- | ---
  parent | QWidget | 0

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

- KPixmapRegionSelectorDialog (a0)

  returns ctor
  Not implemented

  Argument | Type | Default
  --- | --- | ---
  a0 | KPixmapRegionSelectorDialog |

- KPixmapRegionSelectorDialog (a0)

  returns ctor
  before KDE 4.1.0 only

  Argument | Type | Default
  --- | --- | ---
  a0 | QWidget | 0

- getSelectedImage (pixmap, parent)

  returns QImage
  static

  Argument | Type | Default
  --- | --- | ---
  pixmap | QPixmap |
  parent | QWidget | 0

  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.

- getSelectedImage (pixmap, aspectRatioWidth, aspectRatioHeight, parent)

  returns QImage
  static

  Argument | Type | Default
  --- | --- | ---
  pixmap | QPixmap |
  aspectRatioWidth | int |
  aspectRatioHeight | int |
  parent | QWidget | 0

  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.

- getSelectedRegion (pixmap, parent)

  returns QRect
  static

  Argument | Type | Default
  --- | --- | ---
  pixmap | QPixmap |
  parent | QWidget | 0

  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.

- getSelectedRegion (pixmap, aspectRatioWidth, aspectRatioHeight, parent)

  returns QRect
  static

  Argument | Type | Default
  --- | --- | ---
  pixmap | QPixmap |
  aspectRatioWidth | int |
  aspectRatioHeight | int |
  parent | QWidget | 0

  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.

- pixmapRegionSelectorWidget ( )

  returns KPixmapRegionSelectorWidget

  Returns the KPixmapRegionSelectorWidget widget so that additional parameters can be set by using it.