CMFCImageEditorDialog Class
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at CMFCImageEditorDialog Class.
The CMFCImageEditorDialog class supports an image editor dialog box.
Syntax
class CMFCImageEditorDialog : public CDialogEx
Members
Public Constructors
| Name | Description |
|---|---|
| CMFCImageEditorDialog::CMFCImageEditorDialog | Constructs a CMFCImageEditorDialog object. |
Remarks
The CMFCImageEditorDialog class provides a dialog box that includes:
A picture area that you use to modify individual pixels in an image.
Drawing tools to modify the pixels in the picture area.
A color palette to specify the color that is used by the drawing tools.
A preview area that displays the effect of your edit.
The following illustration shows an image editor dialog box.
.jpeg "CMFCImageEditorDialog dialog box")
One way to use a CMFCImageEditorDialog object is to pass it a CBitmap image to be edited. Do not create a large image because the image editing area has a limited size and the logical pixel size is adjusted to fit the area. Call the DoModal method to start a modal dialog box.
Inheritance Hierarchy
Requirements
Header: afximageeditordialog.h
CMFCImageEditorDialog::CMFCImageEditorDialog
Constructs a CMFCImageEditorDialog object.
CMFCImageEditorDialog(
CBitmap* pBitmap,
CWnd* pParent=NULL,
int nBitsPixel=-1);
Parameters
pBitmap
Pointer to an image.
pParent
Pointer to the parent window of the current image editor dialog box.
nBitsPixel
The number of bits used to represent the color of a single pixel, which is also referred to as color depth. If the nBitsPixel parameter is -1, the color depth is derived from the image specified by the pBitmap parameter. The default value is -1.
Return Value
To modify an image, pass an image pointer to the CMFCImageEditorDialog constructor. Then call the DoModal method to open a modal dialog box. When the DoModal method returns, the bitmap contains the new image.
Remarks
Example
The following example demonstrates how to construct an object of the CMFCImageEditorDialog class. This example is part of the New Controls sample.
// CBitmap m_bmpImage
HBITMAP hBmpCopy = (HBITMAP) ::CopyImage(m_bmpImage.GetSafeHandle(), IMAGE_BITMAP, 0, 0, 0);
// this points to Page3 class which extends the CMFCPropertyPage class
CMFCImageEditorDialog dlg(CBitmap::FromHandle(hBmpCopy), this);