\section{KPixmap\-Region\-Selector\-Dialog Class Reference}
\label{classKPixmapRegionSelectorDialog}\index{KPixmapRegionSelectorDialog@{KPixmapRegionSelectorDialog}}
A dialog that uses a {\bf KPixmap\-Region\-Selector\-Widget}{\rm (p.\,\pageref{classKPixmapRegionSelectorWidget})} to allow the user to select a region of an image.  


{\tt \#include $<$kpixmapregionselectordialog.h$>$}

Inheritance diagram for KPixmap\-Region\-Selector\-Dialog:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=94pt]{classKPixmapRegionSelectorDialog__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KPixmap\-Region\-Selector\-Dialog:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=159pt]{classKPixmapRegionSelectorDialog__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KPixmap\-Region\-Selector\-Dialog} ({\bf QWidget} $\ast$parent=0L, const char $\ast$name=0L, bool modal=false)
\item 
{\bf $\sim$KPixmap\-Region\-Selector\-Dialog} ()
\item 
{\bf KPixmap\-Region\-Selector\-Widget} $\ast$ {\bf pixmap\-Region\-Selector\-Widget} () const 
\end{CompactItemize}
\subsection*{Static Public Member Functions}
\begin{CompactItemize}
\item 
static {\bf QRect} {\bf get\-Selected\-Region} (const {\bf QPixmap} \&pixmap, {\bf QWidget} $\ast$parent=0L)
\item 
static {\bf QRect} {\bf get\-Selected\-Region} (const {\bf QPixmap} \&pixmap, int aspect\-Ratio\-Width, int aspect\-Ratio\-Height, {\bf QWidget} $\ast$parent=0L)
\item 
static {\bf QImage} {\bf get\-Selected\-Image} (const {\bf QPixmap} \&pixmap, {\bf QWidget} $\ast$parent=0L)
\item 
static {\bf QImage} {\bf get\-Selected\-Image} (const {\bf QPixmap} \&pixmap, int aspect\-Ratio\-Width, int aspect\-Ratio\-Height, {\bf QWidget} $\ast$parent=0L)
\end{CompactItemize}
\subsection*{Protected Attributes}
\begin{CompactItemize}
\item 
{\bf KPixmap\-Region\-Selector\-Widget} $\ast$ {\bf m\_\-pixmap\-Selector\-Widget}\label{classKPixmapRegionSelectorDialog_p0}

\end{CompactItemize}


\subsection{Detailed Description}
A dialog that uses a {\bf KPixmap\-Region\-Selector\-Widget}{\rm (p.\,\pageref{classKPixmapRegionSelectorWidget})} 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 \begin{Desc}
\item[See also:]{\bf pixmap\-Region\-Selector\-Widget()}{\rm (p.\,\pageref{classKPixmapRegionSelectorDialog_a2})} to get the pointer to the {\bf KPixmap\-Region\-Selector\-Widget}{\rm (p.\,\pageref{classKPixmapRegionSelectorWidget})} object and set the desired options there.\end{Desc}
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.

\begin{Desc}
\item[Author:]Antonio Larrosa $<${\tt larrosa@kde.org}$>$ \end{Desc}
\begin{Desc}
\item[Since:]3.4 \end{Desc}




Definition at line 42 of file kpixmapregionselectordialog.h.

\subsection{Constructor \& Destructor Documentation}
\index{KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}!KPixmapRegionSelectorDialog@{KPixmapRegionSelectorDialog}}
\index{KPixmapRegionSelectorDialog@{KPixmapRegionSelectorDialog}!KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KPixmap\-Region\-Selector\-Dialog::KPixmap\-Region\-Selector\-Dialog ({\bf QWidget} $\ast$ {\em parent} = {\tt 0L}, const char $\ast$ {\em name} = {\tt 0L}, bool {\em modal} = {\tt false})}\label{classKPixmapRegionSelectorDialog_a0}


The constructor of an empty KPixmap\-Region\-Selector\-Dialog, you have to call later the set\-Pixmap method of the {\bf KPixmap\-Region\-Selector\-Widget}{\rm (p.\,\pageref{classKPixmapRegionSelectorWidget})} widget of the new object. 



Definition at line 27 of file kpixmapregionselectordialog.cpp.

References KDialog\-Base::set\-Main\-Widget().\index{KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}!~KPixmapRegionSelectorDialog@{$\sim$KPixmapRegionSelectorDialog}}
\index{~KPixmapRegionSelectorDialog@{$\sim$KPixmapRegionSelectorDialog}!KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KPixmap\-Region\-Selector\-Dialog::$\sim${\bf KPixmap\-Region\-Selector\-Dialog} ()}\label{classKPixmapRegionSelectorDialog_a1}


The destructor of the dialog. 



Definition at line 39 of file kpixmapregionselectordialog.cpp.

\subsection{Member Function Documentation}
\index{KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}!pixmapRegionSelectorWidget@{pixmapRegionSelectorWidget}}
\index{pixmapRegionSelectorWidget@{pixmapRegionSelectorWidget}!KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KPixmap\-Region\-Selector\-Widget}$\ast$ KPixmap\-Region\-Selector\-Dialog::pixmap\-Region\-Selector\-Widget () const\hspace{0.3cm}{\tt  [inline]}}\label{classKPixmapRegionSelectorDialog_a2}


\begin{Desc}
\item[Returns:]the {\bf KPixmap\-Region\-Selector\-Widget}{\rm (p.\,\pageref{classKPixmapRegionSelectorWidget})} widget so that additional parameters can be set by using it. \end{Desc}


Definition at line 61 of file kpixmapregionselectordialog.h.

Referenced by get\-Selected\-Image(), and get\-Selected\-Region().\index{KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}!getSelectedRegion@{getSelectedRegion}}
\index{getSelectedRegion@{getSelectedRegion}!KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QRect} KPixmap\-Region\-Selector\-Dialog::get\-Selected\-Region (const {\bf QPixmap} \& {\em pixmap}, {\bf QWidget} $\ast$ {\em parent} = {\tt 0L})\hspace{0.3cm}{\tt  [static]}}\label{classKPixmapRegionSelectorDialog_e0}


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

\begin{Desc}
\item[Returns:]the selected rectangle, or an invalid rectangle if the user pressed the Cancel button. \end{Desc}


Definition at line 43 of file kpixmapregionselectordialog.cpp.

References QDesktop\-Widget::available\-Geometry(), QDialog::exec(), QRect::height(), pixmap\-Region\-Selector\-Widget(), KPixmap\-Region\-Selector\-Widget::set\-Maximum\-Widget\-Size(), KPixmap\-Region\-Selector\-Widget::set\-Pixmap(), KPixmap\-Region\-Selector\-Widget::unzoomed\-Selected\-Region(), and QRect::width().\index{KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}!getSelectedRegion@{getSelectedRegion}}
\index{getSelectedRegion@{getSelectedRegion}!KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QRect} KPixmap\-Region\-Selector\-Dialog::get\-Selected\-Region (const {\bf QPixmap} \& {\em pixmap}, int {\em aspect\-Ratio\-Width}, int {\em aspect\-Ratio\-Height}, {\bf QWidget} $\ast$ {\em parent} = {\tt 0L})\hspace{0.3cm}{\tt  [static]}}\label{classKPixmapRegionSelectorDialog_e1}


Creates a modal dialog, lets the user to select a region of the {\tt pixmap} with the same aspect ratio than {\tt aspect\-Ratio\-Width} x {\tt aspect\-Ratio\-Height} and returns when the dialog is closed. 

\begin{Desc}
\item[Returns:]the selected rectangle, or an invalid rectangle if the user pressed the Cancel button. \end{Desc}


Definition at line 64 of file kpixmapregionselectordialog.cpp.

References QDesktop\-Widget::available\-Geometry(), QDialog::exec(), QRect::height(), pixmap\-Region\-Selector\-Widget(), KPixmap\-Region\-Selector\-Widget::set\-Maximum\-Widget\-Size(), KPixmap\-Region\-Selector\-Widget::set\-Pixmap(), KPixmap\-Region\-Selector\-Widget::set\-Selection\-Aspect\-Ratio(), KPixmap\-Region\-Selector\-Widget::unzoomed\-Selected\-Region(), and QRect::width().\index{KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}!getSelectedImage@{getSelectedImage}}
\index{getSelectedImage@{getSelectedImage}!KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QImage} KPixmap\-Region\-Selector\-Dialog::get\-Selected\-Image (const {\bf QPixmap} \& {\em pixmap}, {\bf QWidget} $\ast$ {\em parent} = {\tt 0L})\hspace{0.3cm}{\tt  [static]}}\label{classKPixmapRegionSelectorDialog_e2}


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

\begin{Desc}
\item[Returns:]the selected image, or an invalid image if the user pressed the Cancel button. \end{Desc}


Definition at line 86 of file kpixmapregionselectordialog.cpp.

References QDesktop\-Widget::available\-Geometry(), QDialog::exec(), QRect::height(), pixmap\-Region\-Selector\-Widget(), KPixmap\-Region\-Selector\-Widget::selected\-Image(), KPixmap\-Region\-Selector\-Widget::set\-Maximum\-Widget\-Size(), KPixmap\-Region\-Selector\-Widget::set\-Pixmap(), and QRect::width().\index{KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}!getSelectedImage@{getSelectedImage}}
\index{getSelectedImage@{getSelectedImage}!KPixmapRegionSelectorDialog@{KPixmap\-Region\-Selector\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QImage} KPixmap\-Region\-Selector\-Dialog::get\-Selected\-Image (const {\bf QPixmap} \& {\em pixmap}, int {\em aspect\-Ratio\-Width}, int {\em aspect\-Ratio\-Height}, {\bf QWidget} $\ast$ {\em parent} = {\tt 0L})\hspace{0.3cm}{\tt  [static]}}\label{classKPixmapRegionSelectorDialog_e3}


Creates a modal dialog, lets the user to select a region of the {\tt pixmap} with the same aspect ratio than {\tt aspect\-Ratio\-Width} x {\tt aspect\-Ratio\-Height} and returns when the dialog is closed. 

\begin{Desc}
\item[Returns:]the selected image, or an invalid image if the user pressed the Cancel button. \end{Desc}


Definition at line 106 of file kpixmapregionselectordialog.cpp.

References QDesktop\-Widget::available\-Geometry(), QDialog::exec(), QRect::height(), pixmap\-Region\-Selector\-Widget(), KPixmap\-Region\-Selector\-Widget::selected\-Image(), KPixmap\-Region\-Selector\-Widget::set\-Maximum\-Widget\-Size(), KPixmap\-Region\-Selector\-Widget::set\-Pixmap(), KPixmap\-Region\-Selector\-Widget::set\-Selection\-Aspect\-Ratio(), and QRect::width().

The documentation for this class was generated from the following files:\begin{CompactItemize}
\item 
kpixmapregionselectordialog.h\item 
kpixmapregionselectordialog.cpp\end{CompactItemize}
