COleControl选件类

项目
03/01/2013

开发的OLE控件的功能强大的基类。

class COleControl : public CWnd

成员

公共构造函数

名称	说明
COleControl::COleControl	创建一个 COleControl 对象。

公共方法

名称	说明
COleControl::AmbientAppearance	检索该控件的当前外观。
COleControl::AmbientBackColor	返回环境BackColor属性的值。
COleControl::AmbientDisplayName	返回控件的名称为指定的容器。
COleControl::AmbientFont	返回环境字体属性的值。
COleControl::AmbientForeColor	返回环境ForeColor属性的值。
COleControl::AmbientLocaleID	返回容器的区域设置ID.
COleControl::AmbientScaleUnits	返回容器使用的单位的类型。
COleControl::AmbientShowGrabHandles	确定抓取控点是否应显示。
COleControl::AmbientShowHatching	确定阴影是否应显示。
COleControl::AmbientTextAlign	返回容器指定的文本对齐的类型。
COleControl::AmbientUIDead	确定控件是否应响应用户界面事件。
COleControl::AmbientUserMode	确定容器的模式。
COleControl::BoundPropertyChanged	通知容器更改了绑定属性。
COleControl::BoundPropertyRequestEdit	请求权限编辑属性值。
COleControl::ClientToParent	转换点相对于控件的原点为点相对于其容器的原点。
COleControl::ClipCaretRect	如果它由控件，重叠调整插入符号矩形。
COleControl::ControlInfoChanged	在以后调用此函数控件处理的设置助记键已更改。
COleControl::DisplayError	显示股票错误事件对控件的用户。
COleControl::DoClick	股票 DoClick 方法的实现。
COleControl::DoPropExchange	序列化 COleControl 对象的属性。
COleControl::DoSuperclassPaint	重绘从Windows control子类的一个OLE控件。
COleControl::EnableSimpleFrame	启用简单的帧对控件的支持。
COleControl::ExchangeExtent	序列化控件的宽度和高度。
COleControl::ExchangeStockProps	序列化控件股票属性。
COleControl::ExchangeVersion	序列化控件的版本号。
COleControl::FireClick	激发股票 Click 事件。
COleControl::FireDblClick	激发股票 DblClick 事件。
COleControl::FireError	激发股票 Error 事件。
COleControl::FireEvent	引发自定义事件。
COleControl::FireKeyDown	激发股票 KeyDown 事件。
COleControl::FireKeyPress	激发股票 KeyPress 事件。
COleControl::FireKeyUp	激发股票 KeyUp 事件。
COleControl::FireMouseDown	激发股票 MouseDown 事件。
COleControl::FireMouseMove	激发股票 MouseMove 事件。
COleControl::FireMouseUp	激发股票 MouseUp 事件。
COleControl::FireReadyStateChange	当控件的就绪状态更改时，激发事件。
COleControl::GetActivationPolicy	更改支持 IPointerInactive 界面控件的默认启动行为。
COleControl::GetAmbientProperty	返回指定的单个属性的值。
COleControl::GetAppearance	返回常用外观属性的值。
COleControl::GetBackColor	返回库存BackColor属性的值。
COleControl::GetBorderStyle	返回库存BorderStyle属性的值。
COleControl::GetCapture	确定一个无窗口，激活的控件对象是否具有鼠标捕获。
COleControl::GetClassID	检索控件的OLE选件类ID。
COleControl::GetClientOffset	检索控件的矩形区域的左上角和其工作区之间的左上角的差异。
COleControl::GetClientRect	检索控件的工作区的大小。
COleControl::GetClientSite	查询指针的对象传递给其在其容器内的当前客户端站点。
COleControl::GetControlFlags	检索控制标志设置为。
COleControl::GetControlSize	返回OLE控件的位置和大小。
COleControl::GetDC	为无窗口控件获取提供方法从其容器的设备上下文。
COleControl::GetEnabled	返回一个库存enabled特性的值。
COleControl::GetExtendedControl	检索指向属于容器中扩展控件对象。
COleControl::GetFocus	确定控件是否具有焦点。
COleControl::GetFont	返回常用字体属性的值。
COleControl::GetFontTextMetrics	返回 CFontHolder 对象的指标。
COleControl::GetForeColor	返回ForeColor常用属性的值。
COleControl::GetHwnd	返回库存HWND属性的值。
COleControl::GetMessageString	为菜单项提供状态栏文本。
COleControl::GetNotSupported	由用户以防止控件的属性值的访问。
COleControl::GetReadyState	返回控件为就绪状态。
COleControl::GetRectInContainer	返回控件的矩形相对于其容器。
COleControl::GetStockTextMetrics	返回常用字体属性的指标。
COleControl::GetText	返回常用文本或description属性的值。
COleControl::GetWindowlessDropTarget	允许无窗口控件的重写为拖放操作的目标。
COleControl::InitializeIIDs	通知该控件将使用的基类IIDs。
COleControl::InternalGetFont	返回常用字体属性的一 CFontHolder 对象。
COleControl::InternalGetText	检索股票声明或文本属性。
COleControl::InternalSetReadyState	将控件的状态和激发准备就绪状态更改事件。
COleControl::InvalidateControl	无效显示控件的大小，使其重新绘制。
COleControl::InvalidateRgn	无效在给定区域内的容器窗口的工作区。在区域可以使用重绘无窗口控件。
COleControl::IsConvertingVBX	允许专用OLE控件的填充。
COleControl::IsModified	确定控件是否已更改。
COleControl::IsOptimizedDraw	指示容器是支持当前绘图操作的优化绘图。
COleControl::IsSubclassedControl	调用确定是否控件子类Windows控件。
COleControl::Load	重置所有以前的异步数据并启动控件的异步属性的新负载。
COleControl::LockInPlaceActive	确定您的控件是否能容器停用。
COleControl::OnAmbientPropertyChange	调用，更改一个环境属性。
COleControl::OnAppearanceChanged	调用，更改常用外观属性。
COleControl::OnBackColorChanged	调用，更改股票BackColor属性。
COleControl::OnBorderStyleChanged	调用，更改股票BorderStyle属性。
COleControl::OnClick	调用激发库存单击事件。
COleControl::OnClose	通知该控件 IOleControl::Close 调用。
COleControl::OnDoVerb	调用，在控件谓词执行之后。
COleControl::OnDraw	调用，当控件请求重绘自身。
COleControl::OnDrawMetafile	调用由容器使用图元文件设备上下文，那么，当控件请求重绘自身。
COleControl::OnEdit	调用由容器对用户界面中才能OLE控件。
COleControl::OnEnabledChanged	当更改时将调用，该股票enabled特性。
COleControl::OnEnumVerbs	调用由容器枚举控件上的谓词。
COleControl::OnEventAdvise	调用时，事件处理程序将从控件连接或断开。
COleControl::OnFontChanged	调用，更改常用字体属性。
COleControl::OnForeColorChanged	调用，更改股票ForeColor属性。
COleControl::OnFreezeEvents	调用，当控件的事件冻结或解冻。
COleControl::OnGetColorSet	通知该控件 IOleObject::GetColorSet 调用。
COleControl::OnGetControlInfo	提供助记键信息到容器。
COleControl::OnGetDisplayString	调用获取字符串表示属性值。
COleControl::OnGetInPlaceMenu	请求与容器菜单将控制菜单的句柄。
COleControl::OnGetNaturalExtent	检索控件显示范围的重写最接近建议的大小和界限模式。
COleControl::OnGetPredefinedStrings	返回表示属性的字符串可能的值。
COleControl::OnGetPredefinedValue	返回值与预定义的字符串相对应。
COleControl::OnGetViewExtent	检索控件的显示区域的大小重写(可以使用启用两阶段的绘图）。
COleControl::OnGetViewRect	将控件的大小的重写为开始在特定位置的矩形。
COleControl::OnGetViewStatus	检索控件的视图状态的重写。
COleControl::OnHideToolBars	调用由容器，当控件处于停用的UI。
COleControl::OnInactiveMouseMove	重写具有非活动控件的容器是在鼠标指针计划 WM_MOUSEMOVE 消息下到控件。
COleControl::OnInactiveSetCursor	重写具有非活动控件的容器是在鼠标指针计划 WM_SETCURSOR 消息下到控件。
COleControl::OnKeyDownEvent	调用，在股票KeyDown事件会激发之后。
COleControl::OnKeyPressEvent	调用，在股票KeyPress事件会激发之后。
COleControl::OnKeyUpEvent	调用，在股票KeyUp事件会激发之后。
COleControl::OnMapPropertyToPage	指示要使用的属性页为编辑属性。
COleControl::OnMnemonic	调用，当控件的助记键按下了。
COleControl::OnProperties	调用，当控件的“属性” er调用。
COleControl::OnQueryHitPoint	查询的重写控件的显示是否重叠给定的点。
COleControl::OnQueryHitRect	查询的重写控件的显示是否重叠任何在特定矩形点。
COleControl::OnRenderData	调用由框架中检索数据。指定的格式。
COleControl::OnRenderFileData	调用由框架从一个文件中检索数据。指定的格式。
COleControl::OnRenderGlobalData	调用由框架从全局内存中检索数据。指定的格式。
COleControl::OnResetState	重置控件的属性设置为默认值。
COleControl::OnSetClientSite	通知该控件 IOleControl::SetClientSite 调用。
COleControl::OnSetData	用另一个值替换控件数据。
COleControl::OnSetExtent	调用控件的区域后已更改。
COleControl::OnSetObjectRects	调用，在更改之后控件的尺寸。
COleControl::OnShowToolBars	调用，当控件处于激活的UI。
COleControl::OnTextChanged	调用，更改常用文本或description属性。
COleControl::OnWindowlessMessage	处理windows消息(除了鼠标和键盘消息外)无窗口控件的。
COleControl::ParentToClient	转换点相对于容器的原点为点相对于控件的原点。
COleControl::PostModalDialog	通知容器模式对话框已关闭。
COleControl::PreModalDialog	通知容器模式将显示对话框。
COleControl::RecreateControlWindow	销毁并重新创建控件的窗口。
COleControl::Refresh	强制控件外观的重新绘制。
COleControl::ReleaseCapture	版本鼠标捕获。
COleControl::ReleaseDC	释放无窗口控件的容器的显示设备上下文。
COleControl::ReparentControlWindow	重置控制窗口的父级。
COleControl::ResetStockProps	初始化 COleControl 常用属性设置为默认值。
COleControl::ResetVersion	初始化版本号为特定值。
COleControl::ScrollWindow	允许无窗口控件移动到其就地活动的映像内的区域在显示。
COleControl::SelectFontObject	选择自定义字体属性设置为设备上下文。
COleControl::SelectStockFont	选择常用字体属性设置为设备上下文。
COleControl::SerializeExtent	序列化或初始化控件的显示空间。
COleControl::SerializeStockProps	序列化或初始化 COleControl 股票属性。
COleControl::SerializeVersion	序列化或初始化控件的版本信息。
COleControl::SetAppearance	一组常用外观属性的值。
COleControl::SetBackColor	一组常用BackColor属性的值。
Windows 服务应用程序介绍	一组常用BorderStyle属性的值。
COleControl::SetCapture	使控件的容器窗口个委托控件的鼠标捕获。
COleControl::SetControlSize	设置OLE控件的位置和大小。
COleControl::SetEnabled	将库存enabled特性的值。
COleControl::SetFocus	使控件的容器窗口个委托控件的输入焦点。
COleControl::SetFont	一组常用字体属性的值。
COleControl::SetForeColor	一组常用ForeColor属性的值。
COleControl::SetInitialSize	在容器一套OLE控件的大小，在第一次显示。
COleControl::SetModifiedFlag	更改控件的已修改状态。
COleControl::SetNotPermitted	指示编辑请求失败。
COleControl::SetNotSupported	由用户以防止控件的属性值的修改。
COleControl::SetRectInContainer	将控件的矩形相对于其容器。
COleControl::SetText	一组常用文本或description属性的值。
COleControl::ThrowError	信号错误在OLE控件生成的。
COleControl::TransformCoords	将容器和控件大小的坐标值。
COleControl::TranslateColor	转换 OLE_COLOR 值转换为 COLORREF 值。
COleControl::WillAmbientsBeValidDuringLoad	确定环境属性是否将可用控件下次加载。
COleControl::WindowProc	为 COleControl 对象的Windows程序。

受保护的方法

名称	说明
COleControl::DrawContent	调用由结构，并根据需要更新控件的外观。
COleControl::DrawMetafile	调用由结构，当使用图元文件设备上下文。
COleControl::IsInvokeAllowed	启用自动化方法调用。
COleControl::SetInitialDataFormats	调用framework初始化数据格式列表控件支持的。

备注

从 CWnd派生，此选件类继承的Windows窗口对象的所有功能和其他功能特定于OLE，如事件激发并且能够支持方法和属性。

OLE控件可插入到OLE容器应用程序并与容器使用事件激发一个双向系统和显示方法和属性传递到该容器。请注意标准OLE容器只支持OLE控件的基本功能。它们不支持OLE控件的扩展功能。当事件发送到容器由于出现在控件时，的某些事件激发时发生。反过来，容器与控件进行通信通过使用显示的方法，并且属性类似于c. C++的成员函数和数据成员类别。在某些事件发生时，此方法允许开发人员控件的外观和通知容器。

无窗口控件

OLE控件可用于就地活动状态，而无需窗口。无窗口控件具有明显的好处:

无窗口控件可以是透明和非矩形
无窗口控件减少实例大小和对象的创建时间

控件不需要窗口。窗口提供的服务可以通过单个共享的窗口(通常容器的)和个计划代码轻松提供。具有窗口位于对象的主要不必要的问题。

当使用时无窗口的启动，包含一个窗口)的容器(为控件提供自己的windows另外提供的服务负责。例如，在中，如果控件需要查询键盘焦点，查询鼠标捕获或获取设备上下文，这些操作由容器管理。 COleControl无窗口操作成员函数调用容器中的这些操作。

当无窗口的启动启用时，容器将输入消息发送到控件的 IOleInPlaceObjectWindowless 接口( IOleInPlaceObject 扩展无窗口的支持）。此接口的COleControl的实现通过控件的消息映射进行安排这些消息，在相应调整鼠标坐之后。您可以通过将对应项处理类似普通的窗口消息的这些消息，向消息映射。

在无窗口控件，应始终使用 COleControl 成员函数而不是相应的 CWnd 成员函数或其相关Windows API函数。

OLE控件对象还可以在窗口中，才会变为活动状态时，但是，对于非活动有效转换所需的工作量引发，并且该转换的速度断开连接。这是问题时，会用例:例如，请考虑文本框网格。当向上或向下cursoring通过列时，每个控件都必须就地激活然后再停用。非活动/有效转换的速度将直接影响滚动速度。

有关开发OLE控制结构的更多信息，请参见位于 MFC ActiveX控件和概述:创建MFC ActiveX控件程序。有关优化OLE控件的信息，包括无窗口和无闪烁的控件的信息，请参见 MFC ActiveX控件:优化。