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.

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

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

CMFCImageEditorDialog

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

See Also

Hierarchy Chart
Classes
CMFCToolBar Class