Skriptfähige Shellobjekte
Die Windows-Shell bietet einen leistungsstarken Satz von Automatisierungsobjekten, mit denen Sie die Shell mit Microsoft Visual Basic und Skriptsprachen wie Microsoft JScript (kompatibel mit ECMA 262-Sprachspezifikation) und Microsoft Visual Basic Scripting Edition (VBScript) programmieren können. Sie können diese Objekte verwenden, um auf viele Features und Dialogfelder der Shell zuzugreifen. Beispielsweise können Sie auf das Dateisystem zugreifen, Programme starten und Systemeinstellungen ändern.
In diesem Abschnitt werden die skriptfähigen Shellobjekte vorgestellt.
Shell-Versionen
Viele der Shell-Objekte wurden in Version 4.71 der Shell verfügbar. Andere sind in Version 5.00 und höher verfügbar. Version 5.00 wurde mit Windows 2000 verfügbar. In der folgenden Tabelle sind alle Shell-Objekte unter der Version der Shell aufgeführt, in der das Objekt verfügbar wurde.
Instanziieren von Shellobjekten
Um die Shellobjekte in Visual Basic-Anwendungen mit frühzeitiger Bindung zu instanziieren, fügen Sie Verweise auf die folgenden Bibliotheken in Ihrem Projekt hinzu:
- Microsoft Internet Controls (SHDocVw)
- Microsoft Shell-Steuerelemente und Automatisierung (Shell32)
Späte Bindung
Sie können auch viele shell-Objekte mit verspäteter Bindung instanziieren. Dieser Ansatz funktioniert in Visual Basic-Anwendungen und in Skripts. Das folgende Beispiel zeigt, wie Das Shell-Objekt in JScript instanziieren.
<SCRIPT LANGUAGE="JScript">
<!--
function fnCreateShell()
{
// Instantiate the Shell object and invoke its FileRun method.
var oShell = new ActiveXObject("shell.application");
oshell.FileRun;
}
-->
</SCRIPT>
Das folgende Beispiel zeigt, wie sie das Folder-Objekt in VBScript instanziieren.
<SCRIPT LANGUAGE="VBScript">
<!--
function fnCreateFolder()
dim oShell
dim oFolder
dim sDir
sDir = "C:\SomePath"
set oShell = CreateObject("shell.application")
set oFolder = oShell.NameSpace(sDir)
end function
-->
</SCRIPT>
Im vorherigen Beispiel ist sDir der Pfad zum Folder-Objekt . Beachten Sie, dass die ShellSpecialFolderConstants-Enumerationswerte im Skript nicht verfügbar sind.
Die ProgID für jedes Shell-Objekt wird in der folgenden Tabelle angezeigt.
| Object | ProgID |
|---|---|
| DIDiskQuotaUser | Microsoft.DiskQuota.1 |
| DiskQuotaControl | Späte Bindung nicht |
| Ordner | Muschel. Shell_Application.NameSpace("...") |
| Ordner2 | Muschel. Shell_Application.NameSpace("...") |
| FolderItem | Muschel. Shell_Application.NameSpace("..."). Self oder Folder.Items.Item oder Folder.ParseName |
| FolderItems | Folder.Items |
| FolderItems2 | Folder.Items |
| FolderItemVerb | Shell.NameSpace("..."). Self.Verbs.Item() |
| FolderItemVerbs | FolderItem.Verbs oder Shell.NameSpace("..."). Self.Verbs |
| IShellDispatch2 | Muschel. Shell_Application |
| IShellLinkDual2 | Shell.NameSpace("..."). Self.GetLink oder Shell.NameSpace("..."). Items(). GetLink |
| Shell | Muschel. Shell_Application |
| ShellFolderItem | Shell.NameSpace("..."). Self oder Shell.NameSpace("..."). Items() |
| ShellFolderView | Späte Bindung nicht |
| ShellFolderViewOC | Späte Bindung nicht |
| ShellLinkObject | Shell.NameSpace("..."). Self.GetLink oder Shell.NameSpace("..."). Items(). GetLink |
| ShellUIHelper | Späte Bindung nicht |
| ShellWindows | Muschel. Shell_Windows oder ShellWindows._NewEnum |
| WebViewFolderContents | Späte Bindung nicht |
HTML OBJECT-Element
Sie können das OBJECT-Element auch verwenden, um Shellobjekte auf einer HTML-Seite zu instanziieren. Legen Sie dazu das ID-Attribut des OBJECT-Elements auf den Variablennamen fest, den Sie in Ihren Skripts verwenden, und identifizieren Sie das Objekt anhand seiner registrierten Nummer (CLASSID). Der folgende HTML-Code erstellt eine instance des ShellFolderItem-Objekts mithilfe des OBJECT-Elements.
<OBJECT ID="oShFolderItem"
NAME="Shell Folder Item Object"
CLASSID="clsid:2fe352ea-fd1f-11d2-b1f4-00c04f8eeb3e">
</OBJECT>
In der folgenden Tabelle sind jedes Shell-Objekt und die zugehörige CLASSID aufgeführt.
| Shell-Objekt | CLASSID |
|---|---|
| DIDiskQuotaUser | 7988B571-EC89-11cf-9C00-00AA00A14F56 |
| DiskQuotaControl | 7988B571-EC89-11cf-9C00-00AA00A14F56 |
| Ordner | BBCBDE60-C3FF-11CE-8350-444553540000 |
| Ordner2 | f0d2d8ef-3890-11d2-bf8b-00c04fb93661 |
| FolderItem | 744129E0-CBE5-11CE-8350-444553540000 |
| FolderItems | 744129E0-CBE5-11CE-8350-444553540000 |
| FolderItems2 | C94F0AD0-F363-11d2-A327-00C04F8EEC7F |
| FolderItemVerb | 08EC3E00-50B0-11CF-960C-0080C7F4EE85 |
| FolderItemVerbs | 1F8352C0-50B0-11CF-960C-0080C7F4EE85 |
| IShellDispatch2 | A4C6892C-3BA9-11d2-9DEA-00C04FB16162 |
| IShellLinkDual2 | 317EE249-F12E-11d2-B1E4-00C04F8EEB3E |
| Shell | 13709620-C279-11CE-A49E-444553540000 |
| ShellFolderItem | 2fe352ea-fd1f-11d2-b1f4-00c04f8eeb3e |
| ShellFolderView | 62112AA1-EBE4-11cf-A5FB-0020AFE7292D |
| ShellFolderViewOC | 4a3df050-23bd-11d2-939f-00a0c91eedba |
| ShellLinkObject | 11219420-1768-11d1-95BE-00609797EA4F |
| ShellUIHelper | 64AB4BB7-111E-11D1-8F79-00C04FC2FBE1 |
| ShellWindows | 9BA05972-F6A8-11CF-A442-00A0C90A8F39 |
| WebViewFolderContents | 1820FED0-473E-11D0-A96C-00C04FD705A2 |
Shell-Objekt
Das Shell-Objekt stellt die Objekte in der Shell dar. Sie können die vom Shell-Objekt verfügbar gemachten Methoden für Folgendes verwenden:
- Öffnen, durchsuchen und suchen Sie nach Ordnern.
- Minimieren, Wiederherstellen, Kaskadieren oder Kacheln geöffneter Fenster.
- Starten Sie Systemsteuerung Anwendungen.
- Systemdialogfelder anzeigen.
Benutzer sind vielleicht am besten mit den Befehlen vertraut, auf die sie über das Startmenü und das Kontextmenü der Taskleiste zugreifen. Das Kontextmenü der Taskleiste wird angezeigt, wenn Benutzer mit der rechten Maustaste auf die Taskleiste klicken. Die folgende HTML-Anwendung (HTA) erzeugt eine Startseite mit Schaltflächen, die viele Methoden des Shell-Objekts implementieren. Einige dieser Methoden implementieren Features im Startmenü und im Kontextmenü der Taskleiste.
<HTML>
<HEAD>
<TITLE>Start Page</TITLE>
<OBJECT ID="oShell"
CLASSID="clsid:13709620-C279-11CE-A49E-444553540000">
</OBJECT>
<STYLE>
INPUT {width: 200}
</STYLE>
<SCRIPT LANGUAGE="VBScript">
<!--
function fnStart(sMethod)
select case sMethod
case 0
'Minimizes all windows on the desktop
oshell.Shell_MinimizeAll
case 1
'Displays the Run dialog box
oshell.FileRun
case 2
'Displays the Shut Down Windows dialog box
oshell.Shell_ShutdownWindows
case 3
'Displays the Find dialog box
oshell.Shell_FindFilesr
case 4
'Displays the Date/Time dialog box
oshell.Shell_SetTime
case 5
'Displays the Internet Properties dialog box
oshell.Shell_ControlPanelItem "INETCPL.cpl"
case 6
'Explores the My Documents folder
oshell.Shell_Explore "C:\My Documents"
case 7
'Enables user to select folder from Program Files
oshell.Shell_BrowseForFolder 0, "My Programs", 0, "C:\Program Files"
case 8
'Opens the Favorites folder
oshell.Shell_Open "C:\WINDOWS\Favorites"
case 9
'Displays the Taskbar Properties dialog box
oshell.Shell_TrayProperties
end select
end function
-->
</SCRIPT>
</HEAD>
<BODY>
<H1>Start...</H1>
<INPUT type="button" value="Edit Taskbar Properties" onclick="fnStart(9)"><br>
<INPUT type="button" value="Open Favorites Folder" onclick="fnStart(8)"><br>
<INPUT type="button" value="Browse Program Files" onclick="fnStart(7)"><br>
<INPUT type="button" value="Explore My Documents" onclick="fnStart(6)"><br>
<INPUT type="button" value="Modify Internet Properties" onclick="fnStart(5)"><br>
<INPUT type="button" value="Set System Time" onclick="fnStart(4)"><br>
<INPUT type="button" value="Find a File or Folder" onclick="fnStart(3)"><br>
<INPUT type="button" value="Shut Down Windows" onclick="fnStart(2)"><br>
<INPUT type="button" value="Run" onclick="fnStart(1)">
<INPUT type="button" value="Minimize All Windows" onclick="fnStart(0)">
</BODY>
</HTML>
Sicherheit
Als Anwendung wird ein HTA unter einem anderen Sicherheitsmodell als eine Webseite ausgeführt. Um mit einer Webseite zu interagieren, die die Funktionalität der Shell-Objekte implementiert, müssen Benutzer die Option ActiveX-Steuerelemente initialisieren und skripten nicht als sicher markiert für die Sicherheitszone aktivieren, in der sie die Seite anzeigen.
Ordnerobjekte
Das Folder-Objekt stellt einen Shellordner dar. Sie können die vom Folder-Objekt verfügbar gemachten Methoden für Folgendes verwenden:
- Rufen Sie Informationen zu einem Ordner ab.
- Erstellen Sie Unterordner.
- Kopieren und verschieben Sie Dateiobjekte in den Ordner.
Das FolderItem-Objekt stellt ein Element in einem Shellordner dar. Seine Eigenschaften ermöglichen es Ihnen, Informationen über das Element abzurufen. Sie können die von diesem Objekt verfügbar gemachten Methoden verwenden, um die Verben eines Elements auszuführen oder Informationen zum FolderItemVerbs-Objekt eines Elements abzurufen.
Das FolderItems-Objekt stellt eine Auflistung von Elementen in einem Shell-Ordner dar. Ihre Methoden und Eigenschaften ermöglichen es Ihnen, Informationen über die Sammlung abzurufen.
Das folgende Visual Basic-Beispiel zeigt die Beziehung zwischen mehreren Ordnerobjekten und wie sie zusammen verwendet werden können. Wenn der Benutzer auf die Befehlsschaltfläche cmdGetPath klickt, zeigt das Programm ein Dialogfeld an, das es dem Benutzer ermöglicht, einen Ordner unter "Mein Computer" auszuwählen, wobei ssfDRIVES der ShellSpecialFolderConstants-Enumerationswert für "Mein Computer" ist. Wenn der Benutzer einen Ordner auswähelt, wird der Pfad des Ordners im Textfeld txtPath angezeigt.
Private Sub cmdGetPath_Click()
Dim oShell As New Shell
Dim oFolder As Folder
Dim oFolderItem As FolderItem
Set oFolder = oshell.Shell_BrowseForFolder(Me.hWnd, "Select a Folder", 0, ssfDrives)
Set oFolderItem = oFolderItems.Item
txtPath.Text = oFolderItem.Path
End Sub
In VBScript unterscheidet sich diese Funktion geringfügig, da die ShellSpecialFolderConstants-Enumerationswerte im Skript nicht verfügbar sind. Das folgende Beispiel zeigt die VBScript-Entsprechung des vorherigen Beispiels.
<SCRIPT LANGUAGE="VBScript">
<!--
function fnGetMyPathVB()
dim oShell
dim oFolder
dim oFolderItem
set oShell = CreateObject("shell.application")
set oFolder = oshell.Shell_BrowseForFolder(0, "Choose a Folder", 0)
set oFolderItem = oFolder.Items.Item
document.all.item("myPath").innerText = oFolderItem.Path
end function
-->
</SCRIPT>
Beachten Sie im folgenden JScript-Beispiel, bei dem es sich um eine direkte Übersetzung des vorherigen VBScript-Beispiels handelt, wie die leeren Klammern "()" verwendet werden, um die Methoden Items und Item aufzurufen.
<SCRIPT LANGUAGE="JavaScript">
<!--
function fnGetMyPathJ()
{
var oShell = new ActiveXObject("shell.application");
var oFolder = new Object;
oFolder = oshell.Shell_BrowseForFolder(0, "Choose a folder", 0);
var oFolderItem = new Object;
oFolderItem = oFolder.Items().Item();
document.all.item("myPath").innerText = oFolderItem.Path;
}
-->
</SCRIPT>
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für