CStockPropImpl选件类

此选件类支持常用属性值的方法。

重要

此选件类及其成员不能在Windows运行时执行的应用程序。

template <
class T,
class InterfaceName, 
const IID* piid= &_ATL_IIDOF(InterfaceName), 
const GUID* plibid= &CComModule::m_libid, 
WORD wMajor= 1,
WORD wMinor= 0, 
class tihclass= CcomTypeInfoHolder
>
class ATL_NO_VTABLE CStockPropImpl :
public IDispatchImpl< InterfaceName, piid, plibid, wMajor,
   wMinor, tihclass>

参数

• T
  实现控件和从派生 CStockPropImpl的选件类。

• InterfaceName
  显示常用属性的双重接口。

• piid
  为 InterfaceNameIID的指针。

• plibid
  对类型包含 InterfaceName定义的库的LIBID的指针。

• wMajor
  类型库的主版本。 默认值为 1。

• wMinor
  类型库的次版本。 默认值为 0。

• tihclass
  用于的选件类管理 T的类型信息。 默认值为 CComTypeInfoHolder。

成员

公共方法

get_Appearance	调用此方法获取绘制样式使用控件，例如，平面或三维。
get_AutoSize	调用此方法获取指示该值指示控件是否不能是其他范围。
get_BackColor	调用此方法获取控件的背景色。
get_BackStyle	调用此方法获取控件的背景样式，透明或不透明度。
get_BorderColor	调用此方法获取控件的边框颜色。
get_BorderStyle	调用此方法获取控件的边框样式。
get_BorderVisible	调用此方法获取指示该值指示在控件的边框是否可见。
get_BorderWidth	调用此方法获取宽度(以像素为单位)的控件的边框。
get_Caption	调用此方法获取该文本指定在对象的声明。
get_DrawMode	调用此方法获取控件的绘制模式，例如，"异或"笔或反转颜色。
get_DrawStyle	调用此方法获取控件的绘制样式，例如，纯，虚线或虚线。
get_DrawWidth	调用此方法获取绘图宽度(以像素为单位)使用控件的绘制方法。
get_Enabled	调用此方法获取指示该值指示控件是否启用。
get_FillColor	调用此方法获取控件的填充颜色。
get_FillStyle	调用此方法获取控件的填充样式，例如，纯，透明、跨平台的涂绘制。
get_Font	调用此方法获取指向控件的字体属性。
get_ForeColor	调用此方法获取控件的前景色。
get_HWND	调用此方法获取窗口句柄与控件关联。
get_MouseIcon	调用此方法获取(图标、位图、图元文件)的要显示的图片属性图像，当鼠标位于控件时。
get_MousePointer	当鼠标位于控件，例如，箭头、跨或一个沙漏时，调用此方法获取鼠标指针的类型显示。
get_Picture	调用此方法获取指向(图标、位图、图元文件)的要显示的图片属性图像。
get_ReadyState	调用此方法获取控件的就绪状态，例如，加载或加载。
get_TabStop	调用此方法获取指示的标志控件是否是制表位。
get_Text	调用此方法获取使用控件显示的文本。
get_Valid	调用此方法获取指示该值指示控件是否有效。
get_Window	调用此方法获取窗口句柄与控件关联。 与 CStockPropImpl::get_HWND。
put_Appearance	调用此方法将控件，例如，平面或三维使用进行绘制样式。
put_AutoSize	调用此方法设置一个标志的值控件是否不能是其他范围。
put_BackColor	调用此方法将控件的背景色。
put_BackStyle	调用此方法将控件的背景样式。
put_BorderColor	调用此方法将控件的边框颜色。
put_BorderStyle	调用此方法将控件的边框样式。
put_BorderVisible	调用此方法设置一个标志的值的控件的边框是否可见。
put_BorderWidth	调用此方法将控件的边框的宽度。
put_Caption	调用此方法设置中显示的文本与控件。
put_DrawMode	调用此方法将控件的绘图模式，例如，"异或"笔或反转颜色。
put_DrawStyle	调用此方法将控件的绘图样式，例如，纯，虚线或虚线。
put_DrawWidth	调用此方法将控件的绘制方法(以像素为单位)使用的宽度。
put_Enabled	调用此方法设置一个标志控件是否启用。
put_FillColor	调用此方法将控件的填充颜色。
put_FillStyle	调用此方法将控件的填充样式，例如，纯，透明、跨平台的涂绘制。
put_Font	调用此方法将控件的字体属性。
put_ForeColor	调用此方法将控件的前景色。
put_HWND	此方法返回E_FAIL。
put_MouseIcon	调用此方法设置(图标、位图、图元文件)的要显示的图片属性图像，当鼠标位于控件时。
put_MousePointer	当鼠标位于控件，例如，箭头、跨或一个沙漏时，调用此方法定位到突出显示的鼠标指针的类型。
put_Picture	调用此方法设置(图标、位图、图元文件)的要显示的图片属性图像。
put_ReadyState	调用此方法将控件的就绪状态，例如，加载或加载。
put_TabStop	调用此方法设置一个标志的值控件是否是制表位。
put_Text	调用此方法将使用控件显示的文本。
put_Valid	调用此方法设置一个标志控件是否有效。
put_Window	此方法调用 CStockPropImpl::put_HWND，返回E_FAIL。
putref_Font	调用此方法设置控件的字体属性，而引用计数。
putref_MouseIcon	调用此方法设置要显示的图像(图标、位图、图元文件)的图片属性，当鼠标位于控件时，使用引用计数。
putref_Picture	调用此方法设置要显示的图像(图标、位图、图元文件)的图片属性，使用引用计数。

备注

CStockPropImpl 为每个常用属性提供 put 和 get 方法。 这些方法提供必要的代码设置或数据成员与每个属性以及容器通知和同步的访问，当所有属性更改。

Visual C++提供常用属性支持通过其向导。 有关添加常用属性的更多信息传递给控件，请参见 ATL教程。

为了实现向后兼容，CStockPropImpl 分别还显示 get_Window 和调用 get_HWND 和 put_HWND的 put_Window 方法。 因为 HWND 应是只读属性，put_HWND 的默认实现返回 E_FAIL。

以下属性还有一个 putref 实现:

• 字体

• MouseIcon

• 图片

同样三个常用属性需要其对应的数据成员是类型 CComPtr 或提供正确的接口的其他选件类通过赋值运算符引用计数。

继承层次结构

T

IDispatchImpl

CStockPropImpl

要求

Header: atlctl.h

请参见

参考

IDispatchImpl选件类

其他资源

ATL选件类概述