Edit

CMFCImagePaintArea Class

  • Article

Provides the picture area that you use to modify an image in an image editor dialog box.

Syntax

class CMFCImagePaintArea : public CButton

Members

Public Constructors

Name Description
CMFCImagePaintArea::CMFCImagePaintArea Constructs a CMFCImagePaintArea object.
CMFCImagePaintArea::~CMFCImagePaintArea Destructor.

Public Methods

Name Description
CMFCImagePaintArea::GetMode Retrieves the current drawing mode.
CMFCImagePaintArea::SetBitmap Sets the bitmap image for the picture area.
CMFCImagePaintArea::SetColor Sets the current drawing color.
CMFCImagePaintArea::SetMode Sets the current drawing mode.

Remarks

This class is not intended to be used directly from your code.

The framework uses this class to display the picture area in an image editor dialog box. For more information about the image editor dialog box, see CMFCImageEditorDialog Class.

Example

The following example demonstrates how to construct an object of the CMFCImagePaintArea class, set the current drawing color, set the current drawing mode, and set the bitmap image for the picture area.

COLORREF mcolor(RGB(0, 255, 0));
//CBitmap bitmap;
CMFCImageEditorDialog *dialog = new CMFCImageEditorDialog(&bitmap);
CMFCImagePaintArea *wndLargeDrawArea = new CMFCImagePaintArea(dialog);
wndLargeDrawArea->SetColor(mcolor);
wndLargeDrawArea->SetMode(CMFCImagePaintArea::IMAGE_EDIT_MODE_PEN);
wndLargeDrawArea->SetBitmap(&bitmap);

Inheritance Hierarchy

CObject

CCmdTarget

CWnd

CButton

CMFCImagePaintArea

Requirements

Header: afximagepaintarea.h

CMFCImagePaintArea::CMFCImagePaintArea

Constructs a CMFCImagePaintArea object.

CMFCImagePaintArea(CMFCImageEditorDialog* pParentDlg);

Parameters

pParentDlg
[in] A pointer to the dialog box that is the parent of the image editor.

CMFCImagePaintArea::GetMode

Retrieves the current drawing mode.

IMAGE_EDIT_MODE GetMode() const;

Return Value

An IMAGE_EDIT_MODE value that specifies the current drawing mode.

CMFCImagePaintArea::SetBitmap

Sets the bitmap image for the picture area.

void SetBitmap(CBitmap* pBitmap);

Parameters

pBitmap
[in] The new bitmap image to display.

Remarks

If pBitmap is NULL, this method sets the size of the modifiable paint area to zero. Otherwise, it sets the size of the modifiable paint area to the size of the provided bitmap image.

CMFCImagePaintArea::SetColor

Sets the current drawing color.

void SetColor(COLORREF color);

Parameters

color
[in] The new drawing color.

Remarks

When you select a color from the image editor palette bar or color picker, the framework calls this method to update the current drawing color. The initial drawing color is black (a COLORREF value of 0).

The drawing color is used by the image editor dialog box for all drawing modes except for IMAGE_EDIT_MODE_COLOR. For more information about drawing modes, see CMFCImagePaintArea::IMAGE_EDIT_MODE Enumeration.

CMFCImagePaintArea::SetMode

Sets the current drawing mode.

void SetMode(IMAGE_EDIT_MODE mode);

Parameters

mode
[in] An IMAGE_EDIT_MODE value that specifies the current drawing mode.

See also

Hierarchy Chart
Classes
CMFCImageEditorDialog Class