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

標題

資料類型： 字串

存取類型：唯讀

限定詞： 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「) ，Units (」pixel「)

圖示之間的間距。

範例：75

IconTitleFaceName

資料類型： 字串

存取類型：唯讀

限定詞：MappingStrings (「Win32Registry|。DEFAULT\\主控台\\Desktop\\WindowMetrics|IconFont「)

用於圖示名稱的字型。

範例：「MS San Serif」

IconTitleSize

資料類型： uint32

存取類型：唯讀

限定詞： MappingStrings (「Win32API|字型和文字結構|LOGFONTW|lfHeight「) ， Units (」point「)

圖示字型大小。

範例：9

IconTitleWrap

資料類型： 布林值

存取類型：唯讀

限定詞：MappingStrings (「Win32Registry|。DEFAULT\\主控台\\Desktop\\WindowMetrics|IconTitleWrap「)

圖示的標題文字會換行至下一行。

名稱

資料類型： 字串

存取類型：唯讀

限定詞： 索引鍵、 MappingStrings (「WMI」)

識別目前桌面設定檔的名稱。

範例：「MainProf」

模式

資料類型： 字串

存取類型：唯讀

限定詞：MappingStrings (「Win32Registry|。DEFAULT\\主控台\\Desktop|模式「)

用來作為桌面背景的模式名稱。

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「) ，Units (」seconds「)

在螢幕保護裝置程式開始之前經過的時間量。

SettingID

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (256)

已知目前物件的識別碼。

此屬性繼承自 CIM_Setting。

桌布

資料類型： 字串

存取類型：唯讀

限定詞：MappingStrings (「Win32Registry|。DEFAULT\\主控台\\Desktop|背景圖樣「)

桌面背景上背景的桌布設計的檔案名。

範例：「WINNT.BMP」

背景圖樣

資料類型： 布林值

存取類型：唯讀

限定詞：MappingStrings (「Win32Registry|。DEFAULT\\主控台\\Desktop|WallpaperStyle「)

背景圖樣會延展以填滿整個螢幕。 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

作業系統類別