classe Win32_Desktop

Articolo
06/12/2023

La classe WMIWin32_Desktop rappresenta le caratteristiche comuni del desktop di un utente. Le proprietà di questa classe possono essere modificate dall'utente per personalizzare il desktop.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate in ordine alfabetico, non nell'ordine MOF.

Sintassi

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

Members

La classe Win32_Desktop ha questi tipi di membri:

Proprietà

Proprietà

La classe Win32_Desktop ha queste proprietà.

SpessoreBordo

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop\\WindowMetrics| BorderWidth")

Larghezza dei bordi intorno a tutte le finestre con bordi regolabili.

Esempio: 3

Didascalia

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MaxLen (64)

Breve descrizione testuale dell'oggetto corrente.

Questa proprietà viene ereditata da CIM_Setting.

CoolSwitch

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|Pannello di controllo \\Desktop| CoolSwitch")

Il cambio di attività veloce è attivato. Il cambio di attività veloce consente all'utente di passare da una finestra all'altra usando la combinazione di tastiera ALT+TAB .

CursorBlinkRate

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|Pannello di controllo \\Desktop| CursorBlinkRate"), unità ("millisecondi")

Intervallo di tempo tra i lampeggiamenti successivi del cursore.

Esempio: 530

Descrizione

Tipo di dati: string
Tipo di accesso: sola lettura

Descrizione testuale dell'oggetto corrente.

Questa proprietà viene ereditata da CIM_Setting.

DragFullWindows

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|Pannello di controllo \\Desktop| DragFullWindows")

Il contenuto di una finestra viene visualizzato quando un utente sposta la finestra.

GridGranularity

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|Pannello di controllo \\Desktop| GridGranularity"), unità ("8 pixel")

Spaziatura della griglia a cui sono associate le finestre sul desktop. In questo modo, l'organizzazione delle finestre risulta più semplice. La spaziatura è in genere sufficientemente fine che l'utente non lo noterà.

Esempio: 1

IconSpacing

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop\\WindowMetrics| IconSpacing"), unità ("pixel")

Spaziatura tra le icone.

Esempio: 75

IconTitleFaceName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop\\WindowMetrics| IconFont")

Tipo di carattere utilizzato per i nomi delle icone.

Esempio: "MS San Serif"

IconTitleSize

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di tipo di carattere e testo | LOGFONTW|lfHeight"), unità ("punto")

Dimensioni del carattere icona.

Esempio: 9

IconTitleWrap

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop\\WindowMetrics| IconTitleWrap")

Il testo del titolo dell'icona viene disposto alla riga successiva.

Nome

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: key, MappingStrings ("WMI")

Nome che identifica il profilo desktop corrente.

Esempio: "MainProf"

Modello

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop| Pattern")

Nome del modello usato come sfondo per il desktop.

ScreenSaverActive

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop| ScreenSaveActive")

Lo screen saver è attivo.

ScreenSaverExecutable

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop|SCRNSAVE.EXE")

Nome del file eseguibile dello screen saver corrente.

Esempio: "ACCESSO. SCR"

ScreenSaverSecure

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop| ScreenSaverIsSecure")

La password è abilitata per lo screen saver.

ScreenSaverTimeout

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop| ScreenSaveTimeOut"), unità ("secondi")

Tempo trascorso prima dell'avvio dello screen saver.

SettingID

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MaxLen (256)

Identificatore in base al quale è noto l'oggetto corrente.

Questa proprietà viene ereditata da CIM_Setting.

Wallpaper

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop| Sfondo")

Nome file per la progettazione dello sfondo sullo sfondo del desktop.

Esempio: "WINNT.BMP"

WallpaperStretched

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop| WallpaperStyle")

Lo sfondo è allungato per riempire l'intero schermo. Microsoft Plus! deve essere installato prima che questa opzione sia disponibile. Se FALSE, lo sfondo mantiene le dimensioni originali sullo sfondo del desktop.

WallpaperTiled

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32Registry|. DEFAULT\\Pannello di controllo\\Desktop| TileWallpaper")

Lo sfondo è affiancato o centrato.

Commenti

La classe Win32_Desktop è derivata da CIM_Setting.

Il processo chiamante che utilizza questa classe deve avere il privilegio SE_RESTORE_NAME nel computer in cui risiede il Registro di sistema. Ad esempio, se si enumera questa classe nel computer locale, l'account con cui viene eseguita l'applicazione deve avere questo privilegio. Per altre informazioni, vedere Esecuzione di operazioni con privilegi.

Esempio

Nell'esempio di codice seguente viene descritto come recuperare le informazioni sul desktop.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

CIM_Setting
Classi del sistema operativo

Condividi tramite

classe Win32_Desktop

Sintassi

Members

Proprietà

Commenti

Esempio

Requisiti

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive