COleControl Members

Article
04/22/2008

Base Class Members

Construction/Destruction

COleControl	Creates a COleControl object.
RecreateControlWindow	Destroys and re-creates the control's window.

Initialization

InitializeIIDs	Informs the base class of the IIDs the control will use.
ReparentControlWindow	Resets the parent of the control window.
ResetStockProps	Initializes COleControl stock properties to their default values.
ResetVersion	Initializes the version number to a given value.
SetInitialSize	Sets the size of an OLE control when first displayed in a container.

Control Modification Functions

GetControlFlags	Retrieves the control flag settings.
IsModified	Determines if the control state has changed.
SetModifiedFlag	Changes the modified state of a control.

Persistence

ExchangeExtent	Serializes the control's width and height.
ExchangeStockProps	Serializes the control's stock properties.
ExchangeVersion	Serializes the control's version number.
IsConvertingVBX	Allows specialized loading of an OLE control.
SerializeExtent	Serializes or initializes the display space for the control.
SerializeStockProps	Serializes or initializes the COleControl stock properties.
SerializeVersion	Serializes or initializes the control's version information.
SetModifiedFlag	Changes the modified state of a control.
WillAmbientsBeValidDuringLoad	Determines whether ambient properties will be available the next time the control is loaded.

Update/Painting Functions

DoSuperclassPaint	Redraws an OLE control that has been subclassed from a Windows control.
InvalidateControl	Invalidates an area of the displayed control, causing it to be redrawn.
IsOptimizedDraw	Indicates whether the container supports optimized drawing for the current drawing operation.
SelectFontObject	Selects a custom Font property into a device context.
SelectStockFont	Selects the stock Font property into a device context.
TranslateColor	Converts an OLE_COLOR value to a COLORREF value.

Dispatch Exceptions

GetNotSupported	Prevents access to a control's property value by the user.
SetNotPermitted	Indicates that an edit request has failed.
SetNotSupported	Prevents modification to a control's property value by the user.
ThrowError	Signals that an error has occurred in an OLE control.
WindowProc	Provides a Windows procedure for a COleControl object.

Ambient Property Functions

AmbientAppearance	Retrieves the current appearance of the control.
AmbientBackColor	Returns the value of the ambient BackColor property.
AmbientDisplayName	Returns the name of the control as specified by the container.
AmbientFont	Returns the value of the ambient Font property.
AmbientForeColor	Returns the value of the ambient ForeColor property.
AmbientLocaleID	Returns the container's locale ID.
AmbientScaleUnits	Returns the type of units used by the container.
AmbientShowGrabHandles	Determines if grab handles should be displayed.
AmbientShowHatching	Determines if hatching should be displayed.
AmbientTextAlign	Returns the type of text alignment specified by the container.
AmbientUIDead	Determines if the control should respond to user-interface actions.
AmbientUserMode	Determines the mode of the container.
GetAmbientProperty	Returns the value of the specified ambient property.

Event Firing Functions

FireClick	Fires the stock Click event.
FireDblClick	Fires the stock DblClick event.
FireError	Fires the stock Error event.
FireEvent	Fires a custom event.
FireKeyDown	Fires the stock KeyDown event.
FireKeyPress	Fires the stock KeyPress event.
FireKeyUp	Fires the stock KeyUp event.
FireMouseDown	Fires the stock MouseDown event.
FireMouseMove	Fires the stock MouseMove event.
FireMouseUp	Fires the stock MouseUp event.
FireReadyStateChange	Fires an event when the control's ready state changes.

Stock Methods/Properties

DoClick	Implementation of the stock DoClick method.
GetAppearance	Returns the value of the stock Appearance property.
GetBackColor	Returns the value of the stock BackColor property.
GetBorderStyle	Returns the value of the stock BorderStyle property.
GetEnabled	Returns the value of the stock Enabled property.
GetFont	Returns the value of the stock Font property.
GetFontTextMetrics	Returns the metrics of a CFontHolder object.
GetForeColor	Returns the value of the stock ForeColor property.
GetHwnd	Returns the value of the stock hWnd property.
GetStockTextMetrics	Returns the metrics of the stock Font property.
GetText	Returns the value of the stock Text or Caption property.
InternalGetFont	Returns a CFontHolder object for the stock Font property.
InternalGetText	Retrieves the stock Caption or Text property.
Refresh	Forces a repaint of a control's appearance.
SelectStockFont	Selects the control's stock Font property into a device context.
SetAppearance	Sets the value of the stock Appearance property.
SetBackColor	Sets the value of the stock BackColor property.
SetBorderStyle	Sets the value of the stock BorderStyle property.
SetEnabled	Sets the value of the stock Enabled property.
SetFont	Sets the value of the stock Font property.
SetForeColor	Sets the value of the stock ForeColor property.
SetText	Sets the value of the stock Text or Caption property.

OLE Control Sizing Functions

GetControlSize	Returns the position and size of the OLE control.
GetRectInContainer	Returns the control's rectangle relative to its container.
SetControlSize	Sets the position and size of the OLE control.
SetRectInContainer	Sets the control's rectangle relative to its container.

OLE Data Binding Functions

BoundPropertyChanged	Notifies the container that a bound property has been changed.
BoundPropertyRequestEdit	Requests permission to edit the property value.

Simple Frame Functions

EnableSimpleFrame

Enables simple frame support for a control.

OLE Control Site Functions

ControlInfoChanged	Call this function after the set of mnemonics handled by the control has changed.
GetClientSite	Queries an object for the pointer to its current client site within its container.
GetExtendedControl	Retrieves a pointer to an extended control object belonging to the container.
LockInPlaceActive	Determines if your control can be deactivated by the container.
TransformCoords	Transforms coordinate values between a container and the control.

Modal Dialog Functions

PostModalDialog	Notifies the container that a modal dialog box has been closed.
PreModalDialog	Notifies the container that a modal dialog box is about to be displayed.

Windowless Operations

ClipCaretRect	Adjusts a caret rectangle if it is overlapped by a control.
GetCapture	Determines whether a windowless, activated control object has the mouse capture.
GetClientRect	Retrieves the size of the control's client area.
GetDC	Provides a means for a windowless control to get a device context from its container.
GetFocus	Determines whether the control has the focus.
GetWindowlessDropTarget	Override to allow a windowless control to be the target of drag and drop operations.
InvalidateRgn	Invalidates the container window's client area within the given region. Can be used to redraw windowless controls in the region.
OnWindowlessMessage	Processes window messages (other than mouse and keyboard messages) for windowless controls.
ReleaseCapture	Releases mouse capture.
ReleaseDC	Releases the display device context of a container of a windowless control.
ScrollWindow	Allows a windowless control to scroll an area within its in-place active image on the display.
SetCapture	Causes the control's container window to take possession of the mouse capture on the control's behalf.
SetFocus	Causes the control's container window to take possession of the input focus on the control's behalf.

Inactive Pointer Handling Functions

ClientToParent	Translates a point relative to the control's origin to a point relative to its container's origin.
GetActivationPolicy	Alters the default activation behavior of a control that supports the IPointerInactive interface.
GetClientOffset	Retrieves the difference between the upper left corner of the control's rectangular area and the upper left corner of its client area.
OnInactiveMouseMove	Override to have the container for the inactive control under the mouse pointer dispatch WM_MOUSEMOVE messages to the control.
OnInactiveSetCursor	Override to have the container for the inactive control under the mouse pointer dispatch WM_SETCURSOR messages to the control.
ParentToClient	Translates a point relative to the container's origin to a point relative to the control's origin.

Asynchronous Control Functions

GetReadyState	Returns the control's readiness state.
InternalSetReadyState	Sets the control's readiness state and fires the ready-state-change event.
Load	Resets any previous asynchronous data and initiates a new load of the control's asynchronous property.

Overridables

DisplayError	Displays stock Error events to the control's user.
DoPropExchange	Serializes the properties of a COleControl object.
GetClassID	Retrieves the OLE class ID of the control.
GetMessageString	Provides status bar text for a menu item.
IsInvokeAllowed	Enables automation method invocation.
IsSubclassedControl	Called to determine if the control subclasses a Windows control.
OnClick	Called to fire the stock Click event.
OnDoVerb	Called after a control verb has been executed.
OnDraw	Called when a control is requested to redraw itself.
OnDrawMetafile	Called by the container when a control is requested to redraw itself using a metafile device context.
OnEdit	Called by the container to UI Activate an OLE control.
OnEnumVerbs	Called by the container to enumerate a control's verbs.
OnEventAdvise	Called when event handlers are connected or disconnected from a control.
OnKeyDownEvent	Called after the stock KeyDown event has been fired.
OnKeyPressEvent	Called after the stock KeyPress event has been fired.
OnKeyUpEvent	Called after the stock KeyUp event has been fired.
OnProperties	Called when the control's "Properties" verb has been invoked.
OnResetState	Resets a control's properties to the default values.

Change Notification Functions

OnAppearanceChanged	Called when the stock Appearance property is changed.
OnBackColorChanged	Called when the stock BackColor property is changed.
OnBorderStyleChanged	Called when the stock BorderStyle property is changed.
OnEnabledChanged	Called when the stock Enabled property is changed.
OnFontChanged	Called when the stock Font property is changed.
OnForeColorChanged	Called when the stock ForeColor property is changed.
OnTextChanged	Called when the stock Text or Caption property is changed.

OLE Interface Notification Functions

OnAmbientPropertyChange	Called when an ambient property is changed.
OnClose	Notifies the control that IOleControl::Close has been called.
OnFreezeEvents	Called when a control's events are frozen or unfrozen.
OnGetControlInfo	Provides mnemonic information to the container.
OnMnemonic	Called when a mnemonic key of the control has been pressed.
OnRenderData	Called by the framework to retrieve data in the specified format.
OnRenderFileData	Called by the framework to retrieve data from a file in the specified format.
OnRenderGlobalData	Called by the framework to retrieve data from global memory in the specified format.
OnSetClientSite	Notifies the control that IOleControl::SetClientSite has been called.
OnSetData	Replaces the control's data with another value.
OnSetExtent	Called after the control's extent has changed.
OnSetObjectRects	Called after the control's dimensions have been changed.

IViewObject Interface Notification Overridables

OnGetColorSet	Notifies the control that IOleObject::GetColorSet has been called.
OnGetNaturalExtent	Override to retrieve the control's display size closest to the proposed size and extent mode.
OnGetViewExtent	Override to retrieve the size of the control's display areas (can be used to enable two-pass drawing).
OnGetViewRect	Override to convert control's size into a rectangle starting at a specific position.
OnGetViewStatus	Override to retrieve the control's view status.
OnQueryHitPoint	Override to query whether a control's display overlaps a given point.
OnQueryHitRect	Override to query whether a control's display overlaps any point in a given rectangle.

In-Place Activation Functions

OnGetInPlaceMenu	Requests the handle of the control's menu that will be merged with the container menu.
OnHideToolBars	Called by the container when the control is UI deactivated.
OnShowToolBars	Called when the control has been UI activated.

Property Browsing Functions

OnGetDisplayString	Called to obtain a string to represent a property value.
OnGetPredefinedStrings	Returns strings representing possible values for a property.
OnGetPredefinedValue	Returns the value corresponding to a predefined string.
OnMapPropertyToPage	Indicates which property page to use for editing a property.

COleControl Members

See Also

Concepts

Ressources supplémentaires