常规控件参考

  • 项目

本部分包含有关应用于多个控件（而不仅仅是应用于特定控件）的编程元素的参考信息。 大多数控件都支持函数、宏、消息、通知和结构。 例如，大多数控件使用 NM_HOVER 通知来处理鼠标单击。

概述

主题 目录
关于常用控件 公共控件是由公共控件库实现的一组窗口，即 Windows 操作系统随附的 DLL。
常用控件常见问题 此常见问题解答提供有关公共控件的一些常见问题的答案。

函数

主题 目录
DoReaderMode 在窗口中启用读取器模式。
DPA_Clone 复制动态指针数组 (DPA)。
DPA_Create 创建 DPA。
DPA_CreateEx 使用给定的大小和堆位置创建 DPA。
DPA_DeleteAllPtrs 从 DPA 中删除所有项，并相应地收缩 DPA。
DPA_DeletePtr 从 DPA 中删除项。 如果需要，DPA 会收缩以适应删除的项。
DPA_Destroy 释放动态指针数组 (DPA)。
DPA_DestroyCallback 对 DPA 的每个元素调用 pfnCB，然后释放 DPA。
DPA_EnumCallback 循环访问动态指针数组 (DPA)，并对每个项调用 pfnCB。
DPA_GetPtr 从 DPA 获取项。
DPA_GetPtrIndex 获取在 DPA 中找到的匹配项的索引。
DPA_GetSize 获取 DPA 的大小。
DPA_Grow 更改 DPA 中的指针数。
DPA_InsertPtr 在 DPA 中的指定位置插入新项。 如有必要，DPA 会扩展以适应新项。
DPA_LoadStream 通过调用指定的回调函数读取每个元素，从流加载 DPA。
DPA_Merge 合并两个 DPA 的内容。
DPA_SaveStream 通过写出标头，然后调用指定的回调函数来写入每个元素，将 DPA 保存到流。
DPA_Search 在 DPA 中查找项。
DPA_SetPtr 给 DPA 中的项赋值。
DPA_Sort 对动态指针数组 (DPA) 中的项进行排序。
DrawShadowText 绘制具有阴影的文本。
DrawTextExPrivWrap 在指定的矩形中绘制格式化文本。 此函数整合对 DrawTextEx 的调用。
DrawTextWrap 在指定的矩形中绘制格式化文本。 它根据指定的方法设置文本的格式（展开制表符、对齐字符、断行等）。 此函数整合对 DrawText 的调用。
DSA_Clone 复制动态结构数组 (DSA)。
DSA_Create 创建 DSA。
DSA_DeleteAllItems 从 DSA 中删除所有项。
DSA_DeleteItem 从 DSA 中删除项。
DSA_Destroy 释放 DSA。
DSA_DestroyCallback 循环访问 DSA，对每个项调用指定的回调函数。 到达数组末尾后，将释放 DSA。
DSA_EnumCallback 循环访问 DSA 并对每个项调用 pfnCB。
DSA_GetItem 获取 DSA 中的元素。
DSA_GetItemPtr 获取指向 DSA 中的元素的指针。
DSA_GetSize 获取 DSA 的大小。
DSA_InsertItem 将新项插入 DSA。 如有必要，DSA 会扩展以适应新项。
DSA_SetItem 设置 DSA 中元素的内容。
DSA_Sort 对 DSA 中的项排序。
ExtTextOutWrap 使用当前所选字体、背景色和文本颜色绘制文本。 可以选择提供用于实现剪辑、不透明度或两者的维度。 此函数整合对 ExtTextOut 的调用。
GetEffectiveClientRect 计算包含所有指定控件的工作区中矩形的维度。
GetMUILanguage 获取特定进程的公共控件当前正在使用的语言。
GetTextExtentPoint32Wrap 计算指定文本字符串的宽度和高度。 此函数整合对 GetTextExtentPoint 的调用。
InitCommonControls 注册并初始化某些公共控件窗口类。 此函数已过时。 新应用程序应使用 InitCommonControlsEx 函数。
InitCommonControlsEx 从公共控件 DLL 注册特定的公共控件类。
InitMUILanguage 使应用程序能够指定要与系统语言不同的公共控件使用的语言。
LoadIconMetric 使用客户端指定的系统指标加载指定的图标资源。
LoadIconWithScaleDown 加载图标。 如果图标不是标准大小，此函数会缩减较大的图像，而不是纵向扩展较小的图像。
MirrorIcon 反转（镜像）图标，以便它们正确显示在镜像设备上下文中。
PFNDACOMPARE 定义 DSA_Sort 使用的比较函数的原型。
PFNDACOMPARECONST 定义比较项为常量对象时 DSA_Sort 使用的比较函数的原型。
PFNDAENUMCALLBACK 定义 DSA 和 DPA 函数使用的回调函数的原型。
PFNDAENUMCALLBACKCONST 定义在涉及的项是指向常量数据的指针时 DSA 和 DPA 函数使用的回调函数的原型。
PFNDPACOMPARE 定义 DPA_Sort 和 DPA_Search 使用的比较函数的原型。
PFNDPACOMPARECONST 定义比较项为常量对象时 DPA_Sort 或 DPA_Search 使用的比较函数的原型。
PFNDPAENUMCALLBACK 定义 DPA_EnumCallback 使用的回调函数的原型。
PFNDPAMERGE 定义 DPA_Merge 使用的合并函数的原型。
PFNDPAMERGECONST 使用常量值定义 DPA_Merge 使用的合并函数的原型。
PFNDPASTREAM 定义 DPA_LoadStream 和 DPA_SaveStream 使用的回调函数的原型。
PFNDSAENUMCALLBACK 定义 DSA_DestroyCallback 使用的回调函数的原型。
ReaderScroll 在已声明为活动滚动区域的读取器模式窗口部分内移动鼠标指针时使用的应用程序定义的回调函数。
ShowHideMenuCtl 设置或删除指定的菜单项的复选标记属性，并显示或隐藏相应的控件。 该函数将一个复选标记添加到指定的菜单项（如果没有的话），然后显示相应的控件。 如果菜单项已有复选标记，该函数将删除复选标记并隐藏相应的控件。
Str_GetPtr 将字符串从一个缓冲区复制到另一个缓冲区。
Str_SetPtrW 将 ppszCurrent 设置为 pszNew 的副本，并在必要时释放以前的值。
TranslateDispatch 由 DoReaderMode 函数的客户端用来截获和显式处理针对读取器模式窗口滚动区域的任何窗口消息。 这是一个应用程序定义的回调函数。

宏

主题 目录
DPA_AppendPtr 在 DPA 的末尾插入一个新项。
DPA_FastDeleteLastPtr 从 DPA 中删除最后一个指针。
DPA_FastGetPtr 获取 DPA 中指定指针的值。
DPA_GetPtrCount 获取 DPA 中的指针数。
DPA_GetPtrPtr 获取指向 DPA 的内部指针数组的指针。
DPA_SetPtrCount 设置 DPA 中的指针数。
DPA_SortedInsertPtr 在指定现有项之前或之后插入新项。
DSA_AppendItem 将新项追加到 DSA 的末尾。
DSA_GetItemCount 获取 DSA 中的项数。
FORWARD_WM_NOTIFY 发送或发布 WM_NOTIFY 消息。
HANDLE_WM_NOTIFY 调用处理 WM_NOTIFY 消息的函数。
INDEXTOSTATEIMAGEMASK 准备状态图像的索引，以便树视图控件或列表视图控件可以使用索引检索项的状态图像。

消息

主题 目录
CCM_DPISCALE 在树视图控件、列表视图控件、ComboBoxEx 控件、标题控件、按钮、工具栏控件、动画控件和图像列表中启用每英寸像素数 (dpi) 缩放。
CCM_GETUNICODEFORMAT 获取控件的 Unicode 字符格式标志。
CCM_GETVERSION 获取由最新 CCM_SETVERSION 消息设置的控件的版本号。
CCM_SETUNICODEFORMAT 设置控件的 Unicode 字符格式标志。 此消息允许在运行时更改控件使用的字符集，而无需重新创建控件。
CCM_SETVERSION 此消息用于通知控件期望与特定版本关联的行为。
CCM_SETWINDOWTHEME 设置控件的视觉样式。
WM_NOTIFY 当事件发生或控件需要一些信息时，由公共控件发送到其父窗口。
WM_NOTIFYFORMAT 确定窗口是否接受 WM_NOTIFY 通知消息中的 ANSI 或 Unicode 结构。 WM_NOTIFYFORMAT 消息从公共控件发送到其父窗口，并从父窗口发送到公共控件。

通知

主题 目录
NM_CHAR 处理字符键时，控件发送 NM_CHAR 通知代码。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_CUSTOMDRAW 通知控件的父窗口自定义绘图操作。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_CUSTOMTEXT 通知控件的父窗口自定义文本操作。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_FONTCHANGED 控件更改字体时由列表视图控件发送。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_GETCUSTOMSPLITRECT 由按钮控件发送到其父级，以获取构成拆分按钮的两个矩形的度量值。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_HOVER 鼠标悬停在项上时由控件发送。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_KEYDOWN 控件具有键盘焦点且用户按下某个键时由控件发送。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_KILLFOCUS 通知控件的父窗口控件已失去输入焦点。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_LDOWN 通知控件的父窗口，鼠标左键已按下。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_NCHITTEST 当控件收到 WM_NCHITTEST 消息时，由 rebar 控件发送。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_OUTOFMEMORY 通知控件的父窗口，因为没有足够的内存可用，控件无法完成操作。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_RDOWN 目前尚不支持。
NM_RELEASEDCAPTURE 通知控件的父窗口，控件正在释放鼠标捕获。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_RETURN 通知控件的父窗口，控件具有输入焦点，并且用户已按下 Enter 键。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_SETCURSOR 通知控件的父窗口，控件正在设置光标以响应 NM_SETCURSOR 消息。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_SETFOCUS 通知控件的父窗口，控件已获得输入焦点。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_THEMECHANGED 通知控件的父窗口，主题已更改。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_TOOLTIPSCREATED 通知控件的父窗口，控件已创建工具提示控件。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_TVSTATEIMAGECHANGING 由树视图控件发送到其状态图像正在更改的父窗口。 此通知代码以 WM_NOTIFY 消息的形式发送。

结构

主题 目录
COLORSCHEME 包含工具栏或 rebar 中按钮绘图的信息。
DPASTREAMINFO 包含 PFNDPASTREAM 回调函数使用的流项。
INITCOMMONCONTROLSEX 携带用于从动态链接库 (DLL) 加载公共控件类的信息。 此结构与 InitCommonControlsEx 函数一起使用。
NMCHAR 包含与字符通知消息一起使用的信息。
NMCUSTOMSPLITRECTINFO 包含有关拆分按钮的两个矩形的信息。 随 NM_GETCUSTOMSPLITRECT 通知一起发送。
NMCUSTOMTEXT 包含与自定义文本通知一起使用的信息。
NMHDR 包含有关通知消息的信息。
NMKEY 包含与密钥通知消息一起使用的信息。
NMMOUSE 包含与鼠标通知消息一起使用的信息。
NMOBJECTNOTIFY 包含与 TBN_GETOBJECT、TCN_GETOBJECT 和 PSN_GETOBJECT 通知代码一起使用的信息。
NMTOOLTIPSCREATED 包含与 NM_TOOLTIPSCREATED 通知代码一起使用的信息。
READERMODEINFO 包含初始化 DoReaderMode 函数所需的信息。

常量

主题 目录
CDRF 常量 这些常量用作控件的返回值，以响应 NM_CUSTOMDRAW 通知代码。
样式 本部分列出公共控件样式。 除非另有说明，否则这些样式适用于标题控件、工具栏控件和状态窗口。
窗口类 本部分列出公共控件库提供的窗口类名称。