classe Win32_Desktop
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
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 |
|
| DLL |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de