classe Win32_Desktop

Artigo
06/12/2023

A classe WMIWin32_Desktop representa as características comuns da área de trabalho de um usuário. As propriedades dessa classe podem ser modificadas pelo usuário para personalizar a área de trabalho.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.

Sintaxe

[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;
};

Membros

A classe Win32_Desktop tem estes tipos de membros:

Propriedades

Propriedades

A classe Win32_Desktop tem essas propriedades.

BorderWidth

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop\\WindowMetrics| BorderWidth")

Largura das bordas ao redor de todas as janelas com bordas ajustáveis.

Exemplo: 3

Legenda

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (64)

Descrição textual curta do objeto atual.

Essa propriedade é herdada de CIM_Setting.

CoolSwitch

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|Painel de Controle \\Desktop| CoolSwitch")

A troca rápida de tarefas está ativada. A troca rápida de tarefas permite que o usuário alterne entre janelas usando a combinação de teclado ALT+TAB .

CursorBlinkRate

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|Painel de Controle \\Desktop| CursorBlinkRate"), Unidades ("milissegundos")

O período de tempo entre o cursor sucessivo pisca.

Exemplo: 530

Descrição

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Descrição textual do objeto atual.

Essa propriedade é herdada de CIM_Setting.

DragFullWindows

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|Painel de Controle \\Desktop| DragFullWindows")

O conteúdo de uma janela é mostrado quando um usuário move a janela.

GridGranularity

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|Painel de Controle \\Desktop| GridGranularity"), Unidades ("8 pixels")

Espaçamento da grade à qual as janelas estão associadas na área de trabalho. Isso facilita a organização de janelas. O espaçamento geralmente é bom o suficiente para que o usuário não o observe.

Example: 1

ÍconeSpacing

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop\\WindowMetrics| IconSpacing"), Unidades ("pixels")

Espaçamento entre ícones.

Exemplo: 75

IconTitleFaceName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop\\WindowMetrics| IconFont")

Fonte usada para os nomes dos ícones.

Exemplo: "MS San Serif"

IconTitleSize

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de fonte e texto | LOGFONTW|lfHeight"), Unidades ("ponto")

Tamanho da fonte do ícone.

Exemplo: 9

IconTitleWrap

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop\\WindowMetrics| IconTitleWrap")

O texto do título do ícone é encapsulado para a próxima linha.

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: key, MappingStrings ("WMI")

Nome que identifica o perfil da área de trabalho atual.

Exemplo: "MainProf"

Padrão

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop| Padrão")

Nome do padrão usado como plano de fundo para a área de trabalho.

ScreenSaverActive

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop| ScreenSaveActive")

O protetor de tela está ativo.

ScreenSaverExecutable

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop|SCRNSAVE.EXE")

Nome do arquivo executável do protetor de tela atual.

Exemplo: "LOGON. SCR"

ScreenSaverSecure

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop| ScreenSaverIsSecure")

A senha está habilitada para a proteção de tela.

ScreenSaverTimeout

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop| ScreenSaveTimeOut"), Unidades ("segundos")

Quantidade de tempo que passa antes do início da proteção de tela.

Settingid

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (256)

Identificador pelo qual o objeto atual é conhecido.

Essa propriedade é herdada de CIM_Setting.

Papel de parede

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop| Papel de parede")

Nome do arquivo para o design de papel de parede na tela de fundo da área de trabalho.

Exemplo: "WINNT.BMP"

Papel de Parede Estendido

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop| WallpaperStyle")

O papel de parede é estendido para preencher a tela inteira. Microsoft Plus! deve ser instalado antes que essa opção esteja disponível. Se FALSE, o papel de parede manterá suas dimensões originais na tela de fundo da área de trabalho.

WallpaperTiled

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32Registry|. DEFAULT\\Painel de Controle\\Desktop| TileWallpaper")

O papel de parede é lado a lado ou centralizado.

Comentários

A classe Win32_Desktop é derivada de CIM_Setting.

O processo de chamada que usa essa classe deve ter o privilégio SE_RESTORE_NAME no computador no qual o registro reside. Por exemplo, se você enumerar essa classe no computador local, a conta sob a qual o aplicativo é executado deverá ter esse privilégio. Para obter mais informações, consulte Executando operações privilegiadas.

Exemplos

O exemplo de código a seguir descreve como recuperar informações da área de trabalho.

$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
""
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

CIM_Setting
Classes do sistema operacional

Compartilhar via

classe Win32_Desktop

Sintaxe

Membros

Propriedades

Comentários

Exemplos

Requisitos

Confira também

Comentários

Recursos adicionais