Класс Win32_Desktop

Статья
06/12/2023

Класс WMIWin32_Desktop представляет общие характеристики рабочего стола пользователя. Свойства этого класса могут быть изменены пользователем для настройки рабочего стола.

Следующий пример синтаксиса — упрощенный 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 имеет следующие типы членов:

Свойства

Элемент Property

Класс Win32_Desktop имеет следующие свойства.

BorderWidth

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|. DEFAULT\\панель управления\\Desktop\\WindowMetrics| BorderWidth")

Ширина границ вокруг всех окон с настраиваемыми границами.

Пример: 3

Caption

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64)

Краткое текстовое описание текущего объекта.

Это свойство наследуется от CIM_Setting.

CoolSwitch

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|панель управления \\Desktop| CoolSwitch")

Быстрое переключение задач включено. Быстрое переключение задач позволяет пользователю переключаться между окнами с помощью сочетания клавиш ALT+TAB .

CursorBlinkRate

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|панель управления \\Desktop| CursorBlinkRate"), единицы измерения ("миллисекунда")

Продолжительность времени между последовательными миганиями курсора.

Пример: 530

Описание

Тип данных: string
Тип доступа: только для чтения

Текстовое описание текущего объекта.

Это свойство наследуется от CIM_Setting.

DragFullWindows

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|панель управления \\Desktop| DragFullWindows")

Содержимое окна отображается при перемещении окна пользователем.

GridGranularity

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|панель управления \\Desktop| GridGranularity"), единицы измерения ("8 пикселей")

Интервал сетки, к которому привязаны окна на рабочем столе. Это упрощает упорядочение окон. Интервал, как правило, достаточно точен, чтобы пользователь не заметил его.

Пример: 1

IconSpacing

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|. DEFAULT\\панель управления\\Desktop\\WindowMetrics| IconSpacing"), Единицы измерения ("пиксели")

Интервал между значками.

Пример: 75

IconTitleFaceName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|. DEFAULT\\панель управления\\Desktop\\WindowMetrics| IconFont")

Шрифт, используемый для имен значков.

Пример: "MS San Serif"

IconTitleSize

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры шрифта и текста| LOGFONTW|lfHeight"), единицы измерения ("точка")

Размер шрифта значка.

Пример: 9

IconTitleWrap

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|. DEFAULT\\панель управления\\Desktop\\WindowMetrics| IconTitleWrap")

Текст заголовка значка переносится на следующую строку.

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: key, MappingStrings ("WMI")

Имя, идентифицирующее текущий профиль рабочего стола.

Пример: "MainProf"

Шаблон

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|. DEFAULT\\панель управления\\Desktop| Шаблон")

Имя шаблона, используемого в качестве фона для рабочего стола.

ScreenSaverActive

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|. DEFAULT\\панель управления\\Desktop| ScreenSaveActive")

Заставка активна.

ScreenSaverExecutable

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|. DEFAULT\\панель управления\\Desktop|SCRNSAVE.EXE")

Имя текущего исполняемого файла заставки экрана.

Пример: "ВХОД. SCR"

ScreenSaverSecure

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: 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"

ОбоиСтянутые

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|. DEFAULT\\панель управления\\Desktop| WallpaperStyle")

Обои растягиваются, чтобы заполнить весь экран. Microsoft Plus! Необходимо установить, прежде чем этот параметр станет доступен. Если задано значение FALSE, фоновые рисунки сохраняют исходные размеры на фоне рабочего стола.

WallpaperTiled

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32Registry|. DEFAULT\\панель управления\\Desktop| TileWallpaper")

Обои облицованы плиткой или по центру.

Вызывающий процесс, использующий этот класс, должен иметь привилегию 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
Классы операционной системы

Класс Win32_Desktop

Синтаксис

Члены

Элемент Property

Комментарии

Примеры

Требования

См. также раздел

Обратная связь

Обратная связь

Дополнительные ресурсы