Win32_Desktop 类

Win32_DesktopWMI 类表示用户桌面的常见特征。 用户可以修改此类的属性以自定义桌面。

以下语法从托管对象格式 (MOF) 代码中简化,包括所有继承的属性。 属性按字母顺序列出,而不是按 MOF 顺序列出。

语法

[Dynamic, Provider("CIMWin32"), Privileges("SeRestorePrivilege"), UUID("{8502C4E3-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Desktop : CIM_Setting
{
  string  Caption;
  string  Description;
  string  SettingID;
  uint32  BorderWidth;
  boolean CoolSwitch;
  uint32  CursorBlinkRate;
  boolean DragFullWindows;
  uint32  GridGranularity;
  uint32  IconSpacing;
  string  IconTitleFaceName;
  uint32  IconTitleSize;
  boolean IconTitleWrap;
  string  Name;
  string  Pattern;
  boolean ScreenSaverActive;
  string  ScreenSaverExecutable;
  boolean ScreenSaverSecure;
  uint32  ScreenSaverTimeout;
  string  Wallpaper;
  boolean WallpaperStretched;
  boolean WallpaperTiled;
};

成员

Win32_Desktop 类具有以下类型的成员:

属性

Win32_Desktop 类具有这些属性。

BorderWidth

数据类型: uint32

访问类型:只读

限定符:MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop\\WindowMetrics |BorderWidth“)

所有窗口周围的边框宽度,边框可调整。

示例:3

Caption

数据类型: 字符串

访问类型:只读

限定符: MaxLen (64)

当前对象的简短文本说明。

此属性继承自 CIM_Setting

CoolSwitch

数据类型: 布尔值

访问类型:只读

限定符:MappingStrings (“Win32Registry|控制面板\\Desktop|CoolSwitch“)

快速任务切换已打开。 快速任务切换允许用户使用 ALT+TAB 键盘组合在窗口之间切换。

CursorBlinkRate

数据类型: uint32

访问类型:只读

限定符:MappingStrings (“Win32Registry|控制面板\\Desktop|CursorBlinkRate“) ,单位 (”毫秒“)

连续光标闪烁之间的时间长度。

示例:530

描述

数据类型: 字符串

访问类型:只读

当前对象的文本说明。

此属性继承自 CIM_Setting

DragFullWindows

数据类型: 布尔值

访问类型:只读

限定符:MappingStrings (“Win32Registry|控制面板\\Desktop|DragFullWindows“)

当用户移动窗口时,将显示窗口的内容。

GridGranularity

数据类型: uint32

访问类型:只读

限定符:MappingStrings (“Win32Registry|控制面板\\Desktop|GridGranularity“) ,单位 (”8 像素“)

窗口在桌面上绑定到的网格间距。 这样一来,组织窗口就更容易了。 间距通常足够精细,用户不会注意到它。

示例:1

IconSpacing

数据类型: uint32

访问类型:只读

限定符:MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop\\WindowMetrics |IconSpacing“) ,单位 (”像素“)

图标之间的间距。

示例:75

IconTitleFaceName

数据类型: 字符串

访问类型:只读

限定符:MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop\\WindowMetrics |IconFont“)

用于图标名称的字体。

示例:“MS San Serif”

IconTitleSize

数据类型: uint32

访问类型:只读

限定符: MappingStrings (“Win32API|字体和文本结构 |LOGFONTW|lfHeight“) , 单位 (”point“)

图标字号。

示例:9

IconTitleWrap

数据类型: 布尔值

访问类型:只读

限定符:MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop\\WindowMetrics |IconTitleWrap“)

图标的标题文本换行到下一行。

名称

数据类型: 字符串

访问类型:只读

限定符: keyMappingStrings (“WMI”)

标识当前桌面配置文件的名称。

示例:“MainProf”

模式

数据类型: 字符串

访问类型:只读

限定符:MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop|Pattern“)

用作桌面背景的模式的名称。

ScreenSaverActive

数据类型: 布尔值

访问类型:只读

限定符:MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop|ScreenSaveActive“)

屏幕保护程序处于活动状态。

ScreenSaverExecutable

数据类型: 字符串

访问类型:只读

限定符:MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop|SCRNSAVE.EXE“)

当前屏幕保护程序可执行文件的名称。

示例:“LOGON。SCR”

ScreenSaverSecure

数据类型: 布尔值

访问类型:只读

限定符:MappingStrings (“Win32Registry|。DEFAULT\\控制面板\\Desktop|ScreenSaverIsSecure“)

为屏幕保护程序启用了密码。

ScreenSaverTimeout

数据类型: uint32

访问类型:只读

限定符:MappingStrings (“Win32Registry|。DEFAULT\\控制面板\\Desktop|ScreenSaveTimeOut“) ,单位 (”秒“)

屏幕保护程序启动前经过的时间量。

SettingID

数据类型: string

访问类型:只读

限定符: MaxLen (256)

已知当前对象的标识符。

此属性继承自 CIM_Setting

壁纸

数据类型: string

访问类型:只读

限定符:MappingStrings (“Win32Registry|。DEFAULT\\控制面板\\Desktop|壁纸“)

桌面背景上的壁纸设计的文件名。

示例:“WINNT.BMP”

WallpaperStretched

数据类型: 布尔值

访问类型:只读

限定符:MappingStrings (“Win32Registry|。DEFAULT\\控制面板\\Desktop|壁纸风格“)

壁纸被拉伸以填满整个屏幕。 Microsoft Plus! 必须先安装此选项,然后才能使用此选项。 如果 为 FALSE,则壁纸在桌面背景上保留其原始尺寸。

壁纸平铺

数据类型: 布尔值

访问类型:只读

限定符:MappingStrings (“Win32Registry|。DEFAULT\\控制面板\\Desktop|TileWallpaper“)

壁纸平铺或居中。

备注

Win32_Desktop 类派生自 CIM_Setting

使用此类的调用进程必须在注册表所在的计算机上具有 SE_RESTORE_NAME 特权。 例如,如果在本地计算机上枚举此类,则运行应用程序的帐户必须具有此特权。 有关详细信息,请参阅 执行特权操作

示例

以下代码示例介绍如何检索桌面信息。

$desktops = Get-WmiObject win32_desktop

"This system has {0} desktop objects" -f $desktops.length
Foreach ($dt in $desktops) {
"Desktop {0}" -f $i++
"  BorderWidth           : {0}" -f $dt.BorderWidth 
"  Caption               : {0}" -f $dt.Caption
"  CoolSwitch            : {0}" -f $dt.CoolSwitch
"  CursorBlinkRate       : {0}" -f $dt.CursorBlinkRate
"  Description           : {0}" -f $dt.Description 
"  DragFullWindows       : {0}" -f $dt.DragFullWindows
"  GridGranularity       : {0}" -f $dt.GridGranularity 
"  IconSpacing           : {0}" -f $dt.IconSpacing
"  IconTitleFaceName     : {0}" -f $dt.IconTitleFaceName
"  IconTitleSize         : {0}" -f $dt.IconTitleSize
"  IconTitleWrap         : {0}" -f $dt.conTitleWrap
"  Name                  : {0}" -f $dt.Name
"  Pattern               : {0}" -f $dt.Pattern 
"  ScreenSaverActive     : {0}" -f $dt.ScreenSaverActive
"  ScreenSaverExecutable : {0}" -f $dt.ScreenSaverExecutable
"  ScreenSaverSecure     : {0}" -f $dt.creenSaverSecure
"  ScreenSaverTimeout    : {0}" -f $dt.ScreenSaverTimeout
"  SettingID             : {0}" -f $dt.SettingID
"  Wallpaper             : {0}" -f $dt.Wallpaper
"  WallpaperStretched    : {0}" -f $dt.WallpaperStretched
"  WallpaperTiled        : {0}" -f $dt.WallpaperTiled
""
}

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
命名空间
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另请参阅

CIM_Setting

操作系统类