_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 |
|
| DLL |
|