GetSystemMetrics详解
GetSystemMetrics 得到被定义的系统数据或者系统配置信息
int GetSystemMetrics( int nIndex );
MSDN 原文链接:
https://msdn.microsoft.com/zh-cn/library/windows/desktop/ms724385(v=vs.85).aspx
请注意,所有SM_CX *值都是宽度,所有SM_CY *值都是高度。 另请注意,所有用于返回布尔数据的设置都表示TRUE为任何非零值,FALSE表示为零值。
值 |
解释 |
SM_ARRANGE 56 |
指定系统如何排列最小化窗口的标志。 有关更多信息,请参阅本主题中的"备注"部分 |
SM_CLEANBOOT 67 |
指示系统的启动方式:
故障安全启动(也称为SafeBoot,安全模式或干净启动)会绕过用户启动文件 |
SM_CMONITORS 80 |
桌面上的显示器数量。 有关更多信息,请参阅本主题中的"备注"部分。 |
SM_CMOUSEBUTTONS 43 |
鼠标上的按钮数量,如果没有安装鼠标,则为零。 |
SM_CONVERTIBLESLATEMODE 0x2003 |
反映笔记本电脑或平板模式的状态,0表示平板模式,否则为非零。 当此系统指标发生变化时,系统通过WM_SETTINGCHANGE在LPARAM中发送带有"ConvertibleSlateMode"的广播消息。 请注意,此系统指标不适用于台式PC。 在这种情况下,请使用GetAutoRotationState。 |
SM_CXBORDER 5 |
窗口边框的宽度(以像素为单位)。 这相当于具有3-D外观的窗口的SM_CXEDGE值。 |
SM_CXCURSOR 13 |
光标的宽度,以像素为单位。 系统无法创建其他大小的游标。 |
SM_CXDLGFRAME 7 |
同 SM_CXFIXEDFRAME. |
SM_CXDOUBLECLK 36 |
双击序列中第一次单击位置周围的矩形宽度(以像素为单位)。 第二次单击必须出现在由SM_CXDOUBLECLK和SM_CYDOUBLECLK定义的矩形内,以便系统考虑双击两次单击。 两次单击也必须在指定时间内发生。 要设置双击矩形的宽度,请使用SPI_SETDOUBLECLKWIDTH调用SystemParametersInfo。 |
SM_CXDRAG 68 |
鼠标指针在拖动操作开始之前可以移动的鼠标指向任意一侧的像素数。 这允许用户轻松地单击和释放鼠标按钮而不会无意中开始拖动操作。 如果此值为负,则从鼠标按下点的左侧减去该值并将其添加到其右侧。 |
SM_CXEDGE 45 |
三维边框的宽度(以像素为单位)。 该指标是SM_CXBORDER的3-D对应物。 |
SM_CXFIXEDFRAME 7 |
围绕窗口周边的框架的厚度,其具有标题但不是相当大的像素。 SM_CXFIXEDFRAME是水平边框的高度,SM_CYFIXEDFRAME是垂直边框的宽度。 该值与SM_CXDLGFRAME相同。 |
SM_CXFOCUSBORDER 83 |
DrawFocusRect绘制的焦点矩形的左右边缘的宽度。 该值以像素为单位。 Windows 2000:不支持此值。 |
SM_CXFRAME 32 |
同 SM_CXSIZEFRAME. |
SM_CXFULLSCREEN 16 |
主显示器监视器上全屏窗口的客户端区域宽度(以像素为单位)。 要获取未被系统任务栏或应用程序桌面工具栏遮挡的屏幕部分的坐标,请使用SPI_GETWORKAREA值调用SystemParametersInfo函数。 |
SM_CXHSCROLL 21 |
水平滚动条上箭头位图的宽度(以像素为单位)。 |
SM_CXHTHUMB 10 |
水平滚动条中拇指框的宽度,以像素为单位。 |
SM_CXICON 11 |
图标的默认宽度(以像素为单位)。 LoadIcon函数只能加载具有SM_CXICON和SM_CYICON指定维度的图标。 |
SM_CXICONSPACING 38 |
大图标视图中项目的网格单元格的宽度,以像素为单位。 安排时,每个项目都适合SM_CYICONSPACING的SM_CXICONSPACING大小的矩形。 该值始终大于或等于SM_CXICON。 |
SM_CXMAXIMIZED 61 |
主显示器上最大化顶级窗口的默认宽度(以像素为单位)。 |
SM_CXMAXTRACK 59 |
具有标题和大小调整边框的窗口的默认最大宽度(以像素为单位)。 此指标指的是整个桌面。 用户无法将窗口框架拖动到大于这些尺寸的尺寸。 窗口可以通过处理WM_GETMINMAXINFO消息来覆盖此值。 |
SM_CXMENUCHECK 71 |
默认菜单复选标记位图的宽度(以像素为单位)。 |
SM_CXMENUSIZE 54 |
菜单栏按钮的宽度,例如多文档界面中使用的子窗口关闭按钮,以像素为单位。 |
SM_CXMIN 28 |
窗口的最小宽度(以像素为单位)。 |
SM_CXMINIMIZED 57 |
最小化窗口的宽度(以像素为单位)。 |
SM_CXMINSPACING 47 |
最小化窗口的网格单元格的宽度(以像素为单位)。 每个最小化的窗口在排列时都适合这个尺寸的矩形。 该值始终大于或等于SM_CXMINIMIZED。 |
SM_CXMINTRACK 34 |
窗口的最小跟踪宽度(以像素为单位)。 用户无法将窗口框架拖动到小于这些尺寸的尺寸。 窗口可以通过处理WM_GETMINMAXINFO消息来覆盖此值。 |
SM_CXPADDEDBORDER 92 |
标题窗口的边框填充量(以像素为单位)。 Windows XP / 2000:不支持此值。 |
SM_CXSCREEN 0 |
主显示器屏幕的宽度,以像素为单位。 这是通过调用GetDeviceCaps获得的相同值,如下所示:GetDeviceCaps(hdcPrimaryMonitor,HORZRES)。 |
SM_CXSIZE 30 |
窗口标题或标题栏中按钮的宽度(以像素为单位)。 |
SM_CXSIZEFRAME 32 |
围绕窗口周边的大小调整边框的粗细,可以调整大小,以像素为单位。 SM_CXSIZEFRAME是水平边框的宽度,SM_CYSIZEFRAME是垂直边框的高度。 该值与SM_CXFRAME相同。 |
SM_CXSMICON 49 |
建议的小图标宽度(以像素为单位)。 小图标通常出现在窗口标题和小图标视图中。 |
SM_CXSMSIZE 52 |
小字幕按钮的宽度,以像素为单位。 |
SM_CXVIRTUALSCREEN 78 |
虚拟屏幕的宽度(以像素为单位)。 虚拟屏幕是所有显示器的边界矩形。 SM_XVIRTUALSCREEN度量标准是虚拟屏幕左侧的坐标。 |
SM_CXVSCROLL 2 |
垂直滚动条的宽度(以像素为单位)。 |
SM_CYBORDER 6 |
窗口边框的高度(以像素为单位)。 这相当于具有3-D外观的窗口的SM_CYEDGE值。 |
SM_CYCAPTION 4 |
标题区域的高度,以像素为单位。 |
SM_CYCURSOR 14 |
光标的高度,以像素为单位。 系统无法创建其他大小的游标。 |
SM_CYDLGFRAME 8 |
同 SM_CYFIXEDFRAME. |
SM_CYDOUBLECLK 37 |
双击序列中第一次单击位置周围的矩形高度,以像素为单位。 第二次单击必须在SM_CXDOUBLECLK和SM_CYDOUBLECLK定义的矩形内进行,系统才能考虑双击两次单击。 两次单击也必须在指定时间内发生。 要设置双击矩形的高度,请使用SPI_SETDOUBLECLKHEIGHT调用SystemParametersInfo。 |
SM_CYDRAG 69 |
在拖动操作开始之前鼠标指针可以移动的鼠标按下点上方和下方的像素数。 这允许用户轻松地单击和释放鼠标按钮而不会无意中开始拖动操作。 如果此值为负值,则从鼠标按下点上方减去它并在其下方添加。 |
SM_CYEDGE 46 |
三维边框的高度(以像素为单位)。 这是SM_CYBORDER的3D对应物。 |
SM_CYFIXEDFRAME 8 |
围绕窗口周边的框架的厚度,其具有标题但不是相当大的像素。 SM_CXFIXEDFRAME是水平边框的高度,SM_CYFIXEDFRAME是垂直边框的宽度。 该值与SM_CYDLGFRAME相同。 |
SM_CYFOCUSBORDER 84 |
DrawFocusRect绘制的焦点矩形的顶部和底部边缘的高度。 该值以像素为单位。 Windows 2000:不支持此值。 |
SM_CYFRAME 33 |
同 SM_CYSIZEFRAME. |
SM_CYFULLSCREEN 17 |
主显示器监视器上全屏窗口的客户端区域高度(以像素为单位)。 要使屏幕部分的坐标不被系统任务栏或应用程序桌面工具栏遮挡,请使用SPI_GETWORKAREA值调用SystemParametersInfo函数。 |
SM_CYHSCROLL 3 |
水平滚动条的高度,以像素为单位。 |
SM_CYICON 12 |
图标的默认高度(以像素为单位)。 LoadIcon函数只能加载尺寸为SM_CXICON和SM_CYICON的图标。 |
SM_CYICONSPACING 39 |
大图标视图中项目的网格单元格的高度,以像素为单位。 安排时,每个项目都适合SM_CYICONSPACING的SM_CXICONSPACING大小的矩形。 该值始终大于或等于SM_CYICON。 |
SM_CYKANJIWINDOW 18 |
对于系统的双字节字符集版本,这是屏幕底部的汉字窗口的高度,以像素为单位。 |
SM_CYMAXIMIZED 62 |
主显示监视器上最大化顶级窗口的默认高度(以像素为单位)。 |
SM_CYMAXTRACK 60 |
具有标题和大小调整边框的窗口的默认最大高度(以像素为单位)。 此指标指的是整个桌面。 用户无法将窗口框架拖动到大于这些尺寸的尺寸。 窗口可以通过处理WM_GETMINMAXINFO消息来覆盖此值。 |
SM_CYMENU 15 |
单行菜单栏的高度(以像素为单位)。 |
SM_CYMENUCHECK 72 |
默认菜单复选标记位图的高度(以像素为单位)。 |
SM_CYMENUSIZE 55 |
菜单栏按钮的高度,例如多文档界面中使用的子窗口关闭按钮,以像素为单位。 |
SM_CYMIN 29 |
窗口的最小高度(以像素为单位)。 |
SM_CYMINIMIZED 58 |
最小化窗口的高度(以像素为单位)。 |
SM_CYMINSPACING 48 |
最小化窗口的网格单元格的高度,以像素为单位。 每个最小化的窗口在排列时都适合这个尺寸的矩形。 此值始终大于或等于SM_CYMINIMIZED。 |
SM_CYMINTRACK 35 |
窗口的最小跟踪高度(以像素为单位)。 用户无法将窗口框架拖动到小于这些尺寸的尺寸。 窗口可以通过处理WM_GETMINMAXINFO消息来覆盖此值。 |
SM_CYSCREEN 1 |
主显示器屏幕的高度,以像素为单位。 这是通过调用GetDeviceCaps获得的相同值,如下所示:GetDeviceCaps(hdcPrimaryMonitor,VERTRES)。 |
SM_CYSIZE 31 |
窗口标题或标题栏中按钮的高度(以像素为单位)。 |
SM_CYSIZEFRAME 33 |
围绕窗口周边的大小调整边框的粗细,可以调整大小,以像素为单位。 SM_CXSIZEFRAME是水平边框的宽度,SM_CYSIZEFRAME是垂直边框的高度。 该值与SM_CYFRAME相同。 |
SM_CYSMCAPTION 51 |
小标题的高度,以像素为单位。 |
SM_CYSMICON 50 |
建议的小图标高度(以像素为单位)。 小图标通常出现在窗口标题和小图标视图中。 |
SM_CYSMSIZE 53 |
小字幕按钮的高度,以像素为单位。 |
SM_CYVIRTUALSCREEN 79 |
虚拟屏幕的高度,以像素为单位。 虚拟屏幕是所有显示器的边界矩形。 SM_YVIRTUALSCREEN指标是虚拟屏幕顶部的坐标。 |
SM_CYVSCROLL 20 |
垂直滚动条上箭头位图的高度,以像素为单位。 |
SM_CYVTHUMB 9 |
垂直滚动条中拇指框的高度,以像素为单位。 |
SM_DBCSENABLED 42 |
如果User32.dll支持DBCS,则为非零; 否则,0。 |
SM_DEBUG 22 |
如果安装了User.exe的调试版本,则为非零; 否则,0。 |
SM_DIGITIZER 94 |
如果当前操作系统是Windows 7或Windows Server 2008 R2且Tablet PC输入服务已启动,则为非零; 返回值是一个位掩码,指定设备支持的数字化仪输入的类型。 有关更多信息,请参阅备注。 Windows Server 2008,Windows Vista和Windows XP / 2000:不支持此值。 |
SM_IMMENABLED 82 |
如果启用了输入法管理器/输入法编辑器功能,则为非零; 否则,0。 SM_IMMENABLED指示系统是否已准备好在Unicode应用程序上使用基于Unicode的IME。 要确保依赖于语言的IME正常工作,请检查SM_DBCSENABLED和系统ANSI代码页。 否则,可能无法正确执行ANSI到Unicode转换,或者可能不存在某些组件(如字体或注册表设置)。 |
SM_MAXIMUMTOUCHES 95 |
如果系统中有数字化仪,则为非零; 否则,0。 SM_MAXIMUMTOUCHES返回系统中每个数字化仪支持的最大联系数的最大值。 如果系统只有单触式数字化仪,则返回值为1.如果系统具有多点触摸数字化仪,则返回值是硬件可以提供的同时触点数。 Windows Server 2008,Windows Vista和Windows XP / 2000:不支持此值。 |
SM_MEDIACENTER 87 |
如果当前操作系统是Windows XP,Media Center Edition则为非零,否则为0。 |
SM_MENUDROPALIGNMENT 40 |
如果下拉菜单与相应的菜单栏项右对齐,则为非零; 如果菜单左对齐,则为0。 |
SM_MIDEASTENABLED 74 |
如果系统启用了希伯来语和阿拉伯语,则为非零,否则为0。 |
SM_MOUSEPRESENT 19 |
如果安装了鼠标,则为非零; 否则,0。该值很少为零,因为支持虚拟鼠标,并且因为某些系统检测到端口的存在而不是鼠标的存在。 |
SM_MOUSEHORIZONTALWHEELPRESENT 91 |
如果安装了带水平滚轮的鼠标,则为非零; 否则为0。 |
SM_MOUSEWHEELPRESENT 75 |
如果安装了带垂直滚轮的鼠标,则为非零; 否则为0。 |
SM_NETWORK 63 |
如果存在网络,则设置最低有效位; 否则,它被清除。 其他位保留供将来使用。 |
SM_PENWINDOWS 41 |
如果安装了Microsoft Windows for Pen计算扩展,则为非零; 否则为零。 |
SM_REMOTECONTROL 0x2001 |
此系统度量标准用于终端服务环境,以确定是否正在远程控制当前的终端服务器会话。 如果当前会话是远程控制的,它的值是非零的; 否则,0。 您可以使用终端服务管理工具(如终端服务管理器(tsadmin.msc)和shadow.exe)来控制远程会话。 当远程控制会话时,另一个用户可以查看该会话的内容并可能与其进行交互。 |
SM_REMOTESESSION 0x1000 |
此系统度量标准用于终端服务环境中。 如果调用进程与终端服务客户端会话关联,则返回值为非零。 如果调用进程与终端服务控制台会话关联,则返回值为0。 Windows Server 2003和Windows XP:控制台会话不一定是物理控制台。 有关更多信息,请参阅WTSGetActiveConsoleSessionId。 |
SM_SAMEDISPLAYFORMAT 81 |
如果所有显示器具有相同的颜色格式,则为非零,否则为0.两个显示器可以具有相同的位深度,但颜色格式不同。 例如,红色,绿色和蓝色像素可以用不同数量的比特编码,或者那些比特可以位于像素颜色值中的不同位置。 |
SM_SECURE 44 |
应忽略此系统指标; 它总是返回0。 |
SM_SERVERR2 89 |
如果系统是Windows Server 2003 R2,则为内部版本号; 否则,0。 |
SM_SHOWSOUNDS 70 |
非零,如果用户要求应用程序以可视方式呈现信息,否则它将仅以可听形式呈现信息; 否则,0。 |
SM_SHUTTINGDOWN 0x2000 |
如果当前会话正在关闭,则为非零; 否则,0。 Windows 2000:不支持此值。 |
SM_SLOWMACHINE 73 |
如果计算机具有低端(慢)处理器,则为非零; 否则,0。 |
SM_STARTER 88 |
如果当前操作系统是Windows 7 Starter Edition,Windows Vista Starter或Windows XP Starter Edition,则为非零; 否则,0。 |
SM_SWAPBUTTON 23 |
如果交换了鼠标左键和右键的含义,则为非零; 否则,0。 |
SM_SYSTEMDOCKED 0x2004 |
反映停靠模式的状态,0表示未锁定模式,否则为非零。 当此系统指标发生变化时,系统通过WM_SETTINGCHANGE通过LPARAM中的"SystemDockMode"发送广播消息。 |
SM_TABLETPC 86 |
如果当前操作系统是Windows XP Tablet PC版本,或者当前操作系统是Windows Vista或Windows 7且Tablet PC输入服务已启动,则为非零; SM_DIGITIZER设置指示运行Windows 7或Windows Server 2008 R2的设备支持的数字化仪输入类型。 有关更多信息,请参阅备注。 |
SM_XVIRTUALSCREEN 76 |
虚拟屏幕左侧的坐标。 虚拟屏幕是所有显示器的边界矩形。 SM_CXVIRTUALSCREEN指标是虚拟屏幕的宽度。 |
SM_YVIRTUALSCREEN 77 |
虚拟屏幕顶部的坐标。 虚拟屏幕是所有显示器的边界矩形。 SM_CYVIRTUALSCREEN指标是虚拟屏幕的高度。 |
备注
系统指标因显示而异。
GetSystemMetrics(SM_CMONITORS)仅计算可见的显示监视器。 这与EnumDisplayMonitors不同,EnumDisplayMonitors枚举可见显示监视器和与镜像驱动程序关联的不可见伪监视器。 不可见的伪监视器与用于镜像应用程序绘制以进行远程处理或其他目的的伪设备相关联。
SM_ARRANGE设置指定系统如何排列最小化窗口,并包含起始位置和方向。 起始位置可以是以下值之一。
值 |
解释 |
ARW_BOTTOMLEFT |
从屏幕的左下角开始。 默认位置。 |
ARW_BOTTOMRIGHT |
从屏幕的右下角开始。 相当于ARW_STARTRIGHT。 |
ARW_TOPLEFT |
从屏幕的左上角开始。 相当于ARW_STARTTOP。 |
ARW_TOPRIGHT |
从屏幕的右上角开始。 相当于ARW_STARTTOP |SRW_STARTRIGHT。 |
排列最小化窗口的方向可以是以下值之一。
值 |
解释 |
ARW_DOWN |
垂直排列,从上到下排列。 |
ARW_HIDE |
通过将最小化的窗口移出屏幕的可见区域来隐藏它们。 |
ARW_LEFT |
水平排列,从左到右。 |
ARW_RIGHT |
水平排列,从右到左排列。 |
ARW_UP |
垂直排列,从下到上排列。 |
SM_DIGITIZER设置指定运行Windows 7或Windows Server 2008 R2的设备上安装的数字化仪的类型。 返回值是一个位掩码,指定以下一个或多个值。
值 |
解释 |
NID_INTEGRATED_TOUCH 0x01 |
该设备具有集成的触摸数字化仪。 |
NID_EXTERNAL_TOUCH 0x02 |
该设备具有外部触摸数字化仪。 |
NID_INTEGRATED_PEN 0x04 |
该设备具有集成的笔数字化仪。 |
NID_EXTERNAL_PEN 0x08 |
该设备有一个外部笔数字化仪。 |
NID_MULTI_INPUT 0x40 |
该设备支持多个数字转换器输入源。 |
NID_READY 0x80 |
设备已准备好接收数字化仪输入。 |
此API不支持DPI,如果调用线程是每个监视器支持DPI,则不应使用此API。 有关此API的DPI感知版本,请参阅GetSystemMetricsForDPI。 有关DPI感知的详细信息,请参阅Windows High DPI文档。