_Classe de bureau Win32

La classe WMI du _ Bureau Win32 représente les caractéristiques courantes du Bureau d’un utilisateur. Les propriétés de cette classe peuvent être modifiées par l’utilisateur pour personnaliser le bureau.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées par ordre alphabétique, et non par ordre MOF.

Syntaxe

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

Membres

La classe _ Desktop Win32 possède les types de membres suivants :

Propriétés

La classe _ Bureau Win32 possède ces propriétés.

BorderWidth

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . Panneau de configuration par défaut \ \ \ \ Bureau \ \ WindowMetrics | BorderWidth»)

Largeur des bordures autour de toutes les fenêtres avec des bordures réglables.

Exemple : 3

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

Courte description textuelle de l’objet actuel.

Cette propriété est héritée du _ paramètre CIM.

CoolSwitch

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry | panneau de configuration \ \ Desktop | CoolSwitch »)

Le changement rapide de tâches est activé. Le changement rapide de tâches permet à l’utilisateur de basculer entre les fenêtres à l’aide de la combinaison de touches Alt + Tab .

CursorBlinkRate

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | panneau de configuration \ \ | CursorBlinkRate"), unités ("millisecondes")

Durée entre les clignotements successifs du curseur.

Exemple : 530

Description

Type de données : chaîne

Type d'accès : Lecture seule

Description textuelle de l’objet actuel.

Cette propriété est héritée du _ paramètre CIM.

DragFullWindows

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry | panneau de configuration \ \ Desktop | DragFullWindows »)

Le contenu d’une fenêtre s’affiche lorsqu’un utilisateur déplace la fenêtre.

GridGranularity

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | panneau de configuration \ \ | GridGranularity"), unités ("8 pixels")

Espacement de la grille à laquelle les fenêtres sont liées sur le bureau. Cela facilite l’Organisation des fenêtres. L’espacement est généralement suffisamment précis pour que l’utilisateur ne le remarque pas.

Exemple : 1

IconSpacing

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . Panneau de configuration par défaut \ \ \ \ Desktop \ \ WindowMetrics | IconSpacing "), Units (" pixels ")

Espacement entre les icônes.

Exemple : 75

IconTitleFaceName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . Panneau de configuration par défaut \ \ \ \ Desktop \ \ WindowMetrics | IconFont»)

Police utilisée pour les noms des icônes.

Exemple : « MS San Serif »

IconTitleSize

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | font and Text structures | LOGFONTW | lfHeight"), Units ("point")

Taille de police de l’icône.

Exemple : 9

IconTitleWrap

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . Panneau de configuration par défaut \ \ \ \ Desktop \ \ WindowMetrics | IconTitleWrap»)

Le texte du titre de l’icône revient à la ligne suivante.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé, MappingStrings (« WMI »)

Nom qui identifie le profil de bureau actuel.

Exemple : « MainProf »

Modèle

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . \ \ Modèle de bureau du panneau de configuration par défaut \ \ | ")

Nom du modèle utilisé comme arrière-plan du bureau.

ScreenSaverActive

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . Panneau de configuration par défaut \ \ \ \ Desktop | ScreenSaveActive ")

L’économiseur d’écran est actif.

ScreenSaverExecutable

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . Panneau de configuration par défaut \ \ \ \SCRNSAVE.EXE de bureau | »)

Nom du fichier exécutable de l’économiseur d’écran actuel.

Exemple : «LOGON. SCR

ScreenSaverSecure

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . Panneau de configuration par défaut \ \ \ \ Desktop | ScreenSaverIsSecure ")

Le mot de passe est activé pour l’économiseur d’écran.

ScreenSaverTimeout

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . Panneau de configuration par défaut \ \ \ \ Desktop | ScreenSaveTimeOut "), Units (" seconds ")

Durée écoulée avant le démarrage de l’économiseur d’écran.

SettingID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (256)

Identificateur par lequel l’objet actuel est connu.

Cette propriété est héritée du _ paramètre CIM.

Papier peint

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . Panneau de configuration par défaut \ \ \ \ | Papier peint du bureau ")

Nom de fichier pour la conception du papier peint sur l’arrière-plan du bureau.

Exemple : « WINNT.BMP »

WallpaperStretched

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . Panneau de configuration par défaut \ \ \ \ Desktop | WallpaperStyle ")

Le papier peint est étiré pour remplir tout l’écran. Microsoft plus ! doit être installé pour que cette option soit disponible. Si la valeur est false, le papier peint conserve ses dimensions d’origine sur l’arrière-plan du bureau.

WallpaperTiled

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("Win32Registry | . Panneau de configuration par défaut \ \ \ \ Desktop | TileWallpaper ")

Le papier peint est en mosaïque ou centré.

Notes

La classe _ Bureau Win32 est dérivée du _ paramètre CIM.

le processus appelant qui utilise cette classe doit avoir le privilège SE _ restore _ NAME sur l’ordinateur où se trouve le registre. Par exemple, si vous énumérez cette classe sur l’ordinateur local, le compte sous lequel votre application s’exécute doit disposer de ce privilège. Pour plus d’informations, consultez exécution d’opérations privilégiées.

Exemples

L’exemple de code suivant décrit comment récupérer des informations sur le bureau.

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

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
\Cimv2 racine
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

_Paramètre CIM

Classes du système d’exploitation