_ICommandButtonEvents Interface Reference

The CommandButton class' events interface More...

Public Member Functions
void	Click (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The user clicked into the control's client area
void	ContextMenu (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The context menu should be displayed
void	CustomDraw (CustomDrawStageConstants drawStage, CustomDrawControlStateConstants controlState, LONG hDC, RECTANGLE drawingRectangle, CustomDrawReturnValuesConstants furtherProcessing)
	Custom drawing should be done here
void	CustomDropDownAreaSize (RECTANGLE clientRectangle, RECTANGLE commandButtonAreaRectangle, RECTANGLE dropDownAreaRectangle, CustomDropDownAreaSizeReturnValuesConstants furtherProcessing)
	Customizing the size of a split button's drop-down area should be done here
void	DblClick (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The user double-clicked into the control's client area
void	DestroyedControlWindow (LONG hWnd)
	The control window was destroyed
void	DropDown (RECTANGLE *buttonRectangle)
	The drop-down menu should be displayed
void	KeyDown (SHORT *keyCode, SHORT shift)
	A key was pressed while the control has the focus
void	KeyPress (SHORT *keyAscii)
	An alphanumeric key was pressed and released while the control has the focus
void	KeyUp (SHORT *keyCode, SHORT shift)
	A key was released while the control has the focus
void	MClick (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The user clicked into the control's client area
void	MDblClick (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The user double-clicked into the control's client area
void	MouseDown (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	A mouse button was pressed over the control's client area
void	MouseEnter (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The mouse cursor was moved into the control's client area
void	MouseHover (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The mouse cursor was moved into the control's client area a specified period of time before
void	MouseLeave (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The mouse cursor was moved out of the control's client area
void	MouseMove (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The mouse cursor was moved over the control's client area
void	MouseUp (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	A mouse button was released over the control's client area
void	OLEDragDrop (IOLEDataObject data, OLEDropEffectConstants effect, SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The data was dropped onto the control during OLE drag'n'drop
void	OLEDragEnter (IOLEDataObject data, OLEDropEffectConstants effect, SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The data was dragged into the control during OLE drag'n'drop
void	OLEDragLeave (IOLEDataObject *data, SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The data was dragged out of the control during OLE drag'n'drop
void	OLEDragMouseMove (IOLEDataObject data, OLEDropEffectConstants effect, SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The data was dragged over the control during OLE drag'n'drop
void	OwnerDraw (OwnerDrawActionConstants requiredAction, OwnerDrawControlStateConstants controlState, LONG hDC, RECTANGLE *drawingRectangle)
	The control must be drawn
void	RClick (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The user clicked into the control's client area
void	RDblClick (SHORT button, SHORT shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y)
	The user double-clicked into the control's client area
void	RecreatedControlWindow (LONG hWnd)
	The control window was recreated
void	ResizedControlWindow (void)
	The control window was resized

Detailed Description

The CommandButton class' events interface

This interface defines all events the CommandButton class may raise.

See also:: ICommandButton

Member Function Documentation

void Click	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The user clicked into the control's client area

Will be fired if the user clicks into the control's client area using the left mouse button.

Parameters:

`[in]`	button	The mouse buttons that were pressed during the click. This should always be `vbLeftButton` (defined by VB's `MouseButtonConstants` enumeration).
`[in]`	shift	The modifier keys (Shift, Ctrl, Alt) that were pressed during the click. Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the click's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the click's position relative to the control's upper-left corner.

Remarks:: This is the control's default event.
This event may be disabled.

See also:: DblClick, MClick, RClick, ICommandButton::DisabledEvents

void ContextMenu	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The context menu should be displayed

Will be fired if the control's context menu should be displayed.

Parameters:

`[in]`	button	The pressed mouse buttons. Any combination of the values defined by VB's `MouseButtonConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the menu's proposed position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the menu's proposed position relative to the control's upper-left corner.

See also:: RClick

void CustomDraw	(	CustomDrawStageConstants	drawStage,
		CustomDrawControlStateConstants	controlState,
		LONG	hDC,
		RECTANGLE *	drawingRectangle,
		CustomDrawReturnValuesConstants *	furtherProcessing
	)

Custom drawing should be done here

Will be fired after the control processed a NM_CUSTOMDRAW notification allowing custom drawing of the control's content.

Parameters:

`[in]`	drawStage	Specifies the stage of custom drawing this event was raised for. Any of the values defined by the `CustomDrawStageConstants` enumeration is valid.
`[in]`	controlState	Specifies the control's current state (focused, selected etc.). Most of the values defined by the `CustomDrawControlStateConstants` enumeration are valid.
`[in]`	hDC	The handle of the device context in which all drawing should take place.
`[in]`	drawingRectangle	The bounding rectangle of the area that must be drawn.
`[in,out]`	furtherProcessing	Controls further drawing. Most of the values defined by the `CustomDrawReturnValuesConstants` enumeration are valid.

Remarks:: Requires comctl32.dll version 6.0 or higher.
This event may be disabled.

See also:: OwnerDraw, CustomDropDownAreaSize, RECTANGLE, CustomDrawStageConstants, CustomDrawControlStateConstants, CustomDrawReturnValuesConstants, ICommandButton::DisabledEvents, NM_CUSTOMDRAW (button)

void CustomDropDownAreaSize	(	RECTANGLE *	clientRectangle,
		RECTANGLE *	commandButtonAreaRectangle,
		RECTANGLE *	dropDownAreaRectangle,
		CustomDropDownAreaSizeReturnValuesConstants *	furtherProcessing
	)

Customizing the size of a split button's drop-down area should be done here

Will be fired if the system needs the bounding rectangle of a split button's drop-down area. This event is raised in each drawing cycle.

Parameters:

`[in]`	clientRectangle	The bounding rectangle of the control's client area.
`[in,out]`	commandButtonAreaRectangle	The bounding rectangle of the control's command button area. You may customize the area of the button, that is displayed and handled as the command button area by changing this rectangle.
`[in,out]`	dropDownAreaRectangle	The bounding rectangle of the control's drop-down area. You may customize the area of the button, that is displayed and handled as the drop-down area by changing this rectangle.
`[in,out]`	furtherProcessing	Controls how the rectangle specified by `dropDownAreaRectangle` is used. Any of the values defined by the `CustomDropDownAreaSizeReturnValuesConstants` enumeration is valid.

Remarks:: Requires comctl32.dll version 6.10 or higher.
This event may be disabled.

See also:: CustomDraw, ICommandButton::ButtonType, ICommandButton::DropDownArrowHeight, ICommandButton::DropDownArrowWidth, RECTANGLE, CustomDropDownAreaSizeReturnValuesConstants, ICommandButton::DisabledEvents

void DblClick	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The user double-clicked into the control's client area

Will be fired if the user double-clicks into the control's client area using the left mouse button.

Parameters:

`[in]`	button	The mouse buttons that were pressed during the double-click. This should always be `vbLeftButton` (defined by VB's `MouseButtonConstants` enumeration).
`[in]`	shift	The modifier keys (Shift, Ctrl, Alt) that were pressed during the double-click. Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the double-click's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the double-click's position relative to the control's upper-left corner.

Remarks:: This event may be disabled.

See also:: Click, MDblClick, RDblClick, ICommandButton::DisabledEvents

void DestroyedControlWindow ( LONG hWnd )

The control window was destroyed

Will be fired after the control window was destroyed.

Parameters:

[in] hWnd The control's window handle.

See also:: RecreatedControlWindow, ICommandButton::hWnd

void DropDown ( RECTANGLE * buttonRectangle )

The drop-down menu should be displayed

Will be fired if a split button's drop-down menu should displayed.

Parameters:

[in] buttonRectangle The button's bounding rectangle (in pixels). Use it to position the drop-down menu.

Remarks:: This event isn't raised, if the ShowSplitLine property is set to False.
Requires comctl32.dll version 6.10 or higher.

See also:: Click, ICommandButton::ButtonType, ICommandButton::ShowSplitLine

void KeyDown	(	SHORT *	keyCode,
		SHORT	shift
	)

A key was pressed while the control has the focus

Will be fired if the user presses a key while the control has the focus.

Parameters:

`[in,out]`	keyCode	The pressed key. Any of the values defined by VB's `KeyCodeConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.

Remarks:: You may set keyCode to 0 to eat the message.
This event may be disabled.

See also:: KeyUp, KeyPress, ICommandButton::DisabledEvents

void KeyPress ( SHORT * keyAscii )

An alphanumeric key was pressed and released while the control has the focus

Will be fired if the user presses and releases an alphanumeric key while the control has the focus.

Parameters:

[in,out] keyAscii The pressed key's ASCII code.

Remarks:: You may set keyAscii to 0 to eat the message.
This event may be disabled.

See also:: KeyDown, KeyUp, ICommandButton::DisabledEvents

void KeyUp	(	SHORT *	keyCode,
		SHORT	shift
	)

A key was released while the control has the focus

Will be fired if the user releases a key while the control has the focus.

Parameters:

`[in,out]`	keyCode	The released key. Any of the values defined by VB's `KeyCodeConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.

Remarks:: You may set keyCode to 0 to eat the message.
This event may be disabled.

See also:: KeyDown, KeyPress, ICommandButton::DisabledEvents

void MClick	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The user clicked into the control's client area

Will be fired if the user clicks into the control's client area using the middle mouse button.

Parameters:

`[in]`	button	The mouse buttons that were pressed during the click. This should always be `vbMiddleButton` (defined by VB's `MouseButtonConstants` enumeration).
`[in]`	shift	The modifier keys (Shift, Ctrl, Alt) that were pressed during the click. Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the click's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the click's position relative to the control's upper-left corner.

Remarks:: This event may be disabled.

See also:: MDblClick, Click, RClick, ICommandButton::DisabledEvents

void MDblClick	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The user double-clicked into the control's client area

Will be fired if the user double-clicks into the control's client area using the middle mouse button.

Parameters:

`[in]`	button	The mouse buttons that were pressed during the double-click. This should always be `vbMiddleButton` (defined by VB's `MouseButtonConstants` enumeration).
`[in]`	shift	The modifier keys (Shift, Ctrl, Alt) that were pressed during the double-click. Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the double-click's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the double-click's position relative to the control's upper-left corner.

Remarks:: This event may be disabled.

See also:: MClick, DblClick, RDblClick, ICommandButton::DisabledEvents

void MouseDown	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

A mouse button was pressed over the control's client area

Will be fired if the user presses a mouse button while the mouse cursor is located over the control's client area.

Parameters:

`[in]`	button	The pressed mouse button. Any of the values defined by VB's `MouseButtonConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.

Remarks:: This event may be disabled.

See also:: MouseUp, Click, MClick, RClick, ICommandButton::DisabledEvents

void MouseEnter	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The mouse cursor was moved into the control's client area

Will be fired if the user moved the mouse cursor into the control's client area.

Parameters:

`[in]`	button	The pressed mouse buttons. Any combination of the values defined by VB's `MouseButtonConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.

Remarks:: This event may be disabled.

See also:: MouseLeave, MouseHover, MouseMove, ICommandButton::DisabledEvents

void MouseHover	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The mouse cursor was moved into the control's client area a specified period of time before

Will be fired if the mouse cursor has been located over the control's client area for the number of milliseconds specified by the ICommandButton::HoverTime property.

Parameters:

`[in]`	button	The pressed mouse buttons. Any combination of the values defined by VB's `MouseButtonConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.

Remarks:: This event may be disabled.

See also:: MouseEnter, MouseLeave, MouseMove, ICommandButton::HoverTime, ICommandButton::DisabledEvents

void MouseLeave	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The mouse cursor was moved out of the control's client area

Will be fired if the user moves the mouse cursor out of the control's client area.

Parameters:

`[in]`	button	The pressed mouse buttons. Any combination of the values defined by VB's `MouseButtonConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.

Remarks:: This event may be disabled.

See also:: MouseEnter, MouseHover, MouseMove, ICommandButton::DisabledEvents

void MouseMove	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The mouse cursor was moved over the control's client area

Will be fired if the user moves the mouse cursor over the control's client area.

Parameters:

`[in]`	button	The pressed mouse buttons. Any combination of the values defined by VB's `MouseButtonConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.

Remarks:: This event may be disabled.

See also:: MouseEnter, MouseLeave, MouseDown, MouseUp, ICommandButton::DisabledEvents

void MouseUp	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

A mouse button was released over the control's client area

Will be fired if the user releases a mouse button while the mouse cursor is located over the control's client area.

Parameters:

`[in]`	button	The released mouse button. Any of the values defined by VB's `MouseButtonConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.

Remarks:: This event may be disabled.

See also:: MouseDown, Click, MClick, RClick, ICommandButton::DisabledEvents

void OLEDragDrop	(	IOLEDataObject *	data,
		OLEDropEffectConstants *	effect,
		SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The data was dropped onto the control during OLE drag'n'drop

Will be fired during OLE drag'n'drop if the user completes the operation while the mouse cursor is located over the control's client area.

Parameters:

`[in]`	data	The dropped data.
`[in,out]`	effect	On entry, a bit field of the drop effects (defined by the `OLEDropEffectConstants` enumeration) supported by the drag source. On return, this paramter must be set to the drop effect that the target finally executed.
`[in]`	button	The pressed mouse buttons. Any combination of the values defined by VB's `MouseButtonConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.

Remarks:: Don't forget to release any references that you hold to the data object.

See also:: OLEDragEnter, OLEDragMouseMove, OLEDragLeave, MouseUp, ICommandButton::RegisterForOLEDragDrop, OLEDropEffectConstants

void OLEDragEnter	(	IOLEDataObject *	data,
		OLEDropEffectConstants *	effect,
		SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The data was dragged into the control during OLE drag'n'drop

Will be fired during OLE drag'n'drop if the user moved the mouse cursor into the control's client area.

Parameters:

`[in]`	data	The dragged data.
`[in,out]`	effect	On entry, a bit field of the drop effects (defined by the `OLEDropEffectConstants` enumeration) supported by the drag source. On return, this paramter must be set to the drop effect that the target wants to be used on drop.
`[in]`	button	The pressed mouse buttons. Any combination of the values defined by VB's `MouseButtonConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.

See also:: OLEDragMouseMove, OLEDragLeave, OLEDragDrop, MouseEnter, ICommandButton::RegisterForOLEDragDrop, OLEDropEffectConstants

void OLEDragLeave	(	IOLEDataObject *	data,
		SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The data was dragged out of the control during OLE drag'n'drop

Will be fired during OLE drag'n'drop if the user moves the mouse cursor out of the control's client area or if the user canceled the drag'n'drop operation.

Parameters:

`[in]`	data	The dragged data.
`[in]`	button	The pressed mouse buttons. Any combination of the values defined by VB's `MouseButtonConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.

Remarks:: Don't forget to release any references that you hold to the data object.

See also:: OLEDragEnter, OLEDragMouseMove, OLEDragDrop, MouseLeave, ICommandButton::RegisterForOLEDragDrop

void OLEDragMouseMove	(	IOLEDataObject *	data,
		OLEDropEffectConstants *	effect,
		SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The data was dragged over the control during OLE drag'n'drop

Will be fired during OLE drag'n'drop if the user moves the mouse cursor over the control's client area.

Parameters:

`[in]`	data	The dragged data.
`[in,out]`	effect	On entry, a bit field of the drop effects (defined by the `OLEDropEffectConstants` enumeration) supported by the drag source. On return, this paramter must be set to the drop effect that the target wants to be used on drop.
`[in]`	button	The pressed mouse buttons. Any combination of the values defined by VB's `MouseButtonConstants` enumeration is valid.
`[in]`	shift	The pressed modifier keys (Shift, Ctrl, Alt). Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the mouse cursor's position relative to the control's upper-left corner.

See also:: OLEDragEnter, OLEDragLeave, OLEDragDrop, MouseMove, ICommandButton::RegisterForOLEDragDrop, OLEDropEffectConstants

void OwnerDraw	(	OwnerDrawActionConstants	requiredAction,
		OwnerDrawControlStateConstants	controlState,
		LONG	hDC,
		RECTANGLE *	drawingRectangle
	)

The control must be drawn

Will be fired if the Style property is set to sOwnerDrawn and the control needs to be drawn.

Parameters:

`[in]`	requiredAction	Specifies the required drawing action. Any combination of the values defined by the `OwnerDrawActionConstants` enumeration is valid.
`[in]`	controlState	Specifies the control's current state (focused, selected etc.). Any combination of the values defined by the `OwnerDrawControlStateConstants` enumeration are valid.
`[in]`	hDC	The handle of the device context in which all drawing should take place.
`[in]`	drawingRectangle	The bounding rectangle of the area that must be drawn.

See also:: ICommandButton::Style, CustomDraw, RECTANGLE, OwnerDrawActionConstants, OwnerDrawControlStateConstants

void RClick	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The user clicked into the control's client area

Will be fired if the user clicks into the control's client area using the right mouse button.

Parameters:

`[in]`	button	The mouse buttons that were pressed during the click. This should always be `vbRightButton` (defined by VB's `MouseButtonConstants` enumeration).
`[in]`	shift	The modifier keys (Shift, Ctrl, Alt) that were pressed during the click. Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the click's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the click's position relative to the control's upper-left corner.

Remarks:: This event may be disabled.

See also:: ContextMenu, RDblClick, Click, MClick, ICommandButton::DisabledEvents

void RDblClick	(	SHORT	button,
		SHORT	shift,
		OLE_XPOS_PIXELS	x,
		OLE_YPOS_PIXELS	y
	)

The user double-clicked into the control's client area

Will be fired if the user double-clicks into the control's client area using the right mouse button.

Parameters:

`[in]`	button	The mouse buttons that were pressed during the double-click. This should always be `vbRightButton` (defined by VB's `MouseButtonConstants` enumeration).
`[in]`	shift	The modifier keys (Shift, Ctrl, Alt) that were pressed during the double-click. Any combination of the values defined by VB's `ShiftConstants` enumeration is valid.
`[in]`	x	The x-coordinate (in twips) of the double-click's position relative to the control's upper-left corner.
`[in]`	y	The y-coordinate (in twips) of the double-click's position relative to the control's upper-left corner.

Remarks:: This event may be disabled.

See also:: RClick, DblClick, MDblClick, ICommandButton::DisabledEvents

void RecreatedControlWindow ( LONG hWnd )

The control window was recreated

Will be fired after the control window was destroyed and recreated.
Some properties can't be changed after the control window was created. If such a property is changed and the control window already exists, it is destroyed and recreated.

Parameters:

[in] hWnd The control's window handle.

See also:: DestroyedControlWindow, ICommandButton::hWnd

void ResizedControlWindow ( void )

The control window was resized

Will be fired after the control window was resized.

_ICommandButtonEvents Interface Reference

Public Member Functions

Detailed Description

Member Function Documentation