Win32_Desktop classe

La classe WMI Win32_Desktop représente les caractéristiques communes 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 dans l’ordre alphabétique, et non dans l’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 Win32_Desktop a les types de membres suivants :

• Propriétés

Propriétés

La classe Win32_Desktop a ces propriétés.

BorderWidth

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop\\WindowMetrics| BorderWidth »)

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

Exemple : 3

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

Brève description textuelle de l’objet actuel.

Cette propriété est héritée de CIM_Setting.

CoolSwitch

Type de données : booléen

Type d'accès : Lecture seule

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

Le basculement rapide des tâches est activé. Le basculement rapide des tâches permet à l’utilisateur de basculer entre les fenêtres à l’aide de la combinaison clavier ALT+TAB .

CursorBlinkRate

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry|Panneau de configuration \\Desktop| CursorBlinkRate »), Unités (« millisecondes »)

Durée entre les curseurs successifs clignote.

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 de CIM_Setting.

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 \\Desktop| GridGranularity »), Units (« 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|. DEFAULT\\Panneau de configuration\\Desktop\\WindowMetrics| IconSpacing »), Unités (« pixels »)

Espacement entre les icônes.

Exemple : 75

IconTitleFaceName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\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| Structures de police et de texte | LOGFONTW|lfHeight »), Unités (« 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|. DEFAULT\\Panneau de configuration\\Desktop\\WindowMetrics| IconTitleWrap »)

Le texte de titre de l’icône est renvoyé à la ligne suivante.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : key, 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|. DEFAULT\\Panneau de configuration\\Desktop| Modèle « )

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

ScreenSaverActive

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop| ScreenSaveActive »)

L’économiseur d’écran est actif.

ScreenSaverExecutable

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop|SCRNSAVE.EXE »)

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|. DEFAULT\\Panneau de configuration\\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|. DEFAULT\\Panneau de configuration\\Desktop| ScreenSaveTimeOut »), Unités (« secondes »)

Durée qui s’écoule 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 de CIM_Setting.

Papier peint

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop| Papier peint »)

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|. DEFAULT\\Panneau de configuration\\Desktop| WallpaperStyle »)

Le papier peint est étiré pour remplir l’intégralité de l’écran. Microsoft Plus ! doit être installé avant 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|. DEFAULT\\Panneau de configuration\\Desktop| TileWallpaper »)

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

Notes

La classe Win32_Desktop est dérivée de CIM_Setting.

Le processus appelant qui utilise cette classe doit avoir le privilège SE_RESTORE_NAME sur l’ordinateur sur lequel réside 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 de 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

Voir aussi

CIM_Setting

Classes du système d’exploitation