Share via


CMFCToolBarButton::OnDraw

Called by the framework to draw the button by using the specified styles and options.

virtual void OnDraw(
   CDC* pDC,
   const CRect& rect,
   CMFCToolBarImages* pImages,
   BOOL bHorz=TRUE,
   BOOL bCustomizeMode=FALSE,
   BOOL bHighlight=FALSE,
   BOOL bDrawBorder=TRUE,
   BOOL bGrayDisabledButtons=TRUE 
);

Parameters

  • [in] pDC
    The device context that displays the button.

  • [in] rect
    The bounding rectangle of the button.

  • [in] pImages
    The collection of toolbar images that is associated with the button.

  • [in] bHorz
    The dock state of the parent toolbar. This parameter is TRUE when the button is docked horizontally and FALSE when the button is docked vertically.

  • [in] bCustomizeMode
    Specifies whether the toolbar is in customization mode. This parameter is TRUE when the toolbar is in customization mode and FALSE when the toolbar is not in customization mode.

  • [in] bHighlight
    Specifies whether the button is highlighted. This parameter is TRUE when the button is highlighted and FALSE when the button is not highlighted.

  • [in] bDrawBorder
    Specifies whether the button should display its border. This parameter is TRUE when the button should display its border and FALSE when the button should not display its border.

  • [in] bGrayDisabledButtons
    Specifies whether to shade disabled buttons or use the disabled images collection. This parameter is TRUE when disabled buttons should be shaded and FALSE when this method should use the disabled images collection.

Remarks

Override this method to customize toolbar button drawing.

Requirements

Header: afxtoolbarbutton.h

See Also

Concepts

MFC Hierarchy Chart

Reference

CMFCToolBarButton Class