Shell object

August 25, 2023 · View on GitHub

Represents the objects in the Shell. Methods are provided to control the Shell and to execute commands within the Shell. There are also methods to obtain other Shell-related objects.

Members

The Shell object has these types of members:

Methods

The Shell object has these methods.

MethodDescription
AddToRecentAdds a file to the most recently used (MRU) list.
BrowseForFolderCreates a dialog box that enables the user to select a folder and then returns the selected folder's Folder object.
CanStartStopServiceDetermines if the current user can start and stop the named service.
CascadeWindowsCascades all of the windows on the desktop. This method has the same effect as right-clicking the taskbar and selecting Cascade Windows.
ControlPanelItemRuns the specified Control Panel (*.cpl) application. If the application is already open, it will activate the running instance.
Note: As of Windows Vista, most Control Panel applications are Shell items and cannot be opened with this function. To open those Control Panel applications, pass the canonical name to control.exe. For example:
control.exe /name Microsoft.Personalization

EjectPCEjects the computer from its docking station. This is the same as clicking the Start menu and selecting Eject PC, if your computer supports this command.
ExploreOpens a specified folder in a Windows Explorer window.
ExplorerPolicyGets the value for a specified Internet Explorer policy.
FileRunDisplays the Run dialog to the user. This method has the same effect as clicking the Start menu and selecting Run.
FindComputerDisplays the Search Results: Computers dialog box. The dialog box shows the result of the search for a specified computer.
FindFilesDisplays the Find: All Files dialog box. This is the same as clicking the Start menu and then selecting Search (or its equivalent under systems earlier than Windows XP.
FindPrinterDisplays the Find Printer dialog box.
GetSettingRetrieves a global Shell setting.
GetSystemInformationRetrieves system information.
HelpDisplays the Windows Help and Support Center. This method has the same effect as clicking the Start menu and selecting Help and Support.
IsRestrictedRetrieves a group's restriction setting from the registry.
IsServiceRunningReturns a value that indicates whether a particular service is running.
MinimizeAllMinimizes all of the windows on the desktop. This method has the same effect as right-clicking the taskbar and selecting Minimize All Windows on older systems or clicking the Show Desktop icon in the Quick Launch area of the taskbar in Windows 2000 or Windows XP.
NameSpaceCreates and returns a Folder object for the specified folder.
OpenOpens the specified folder.
RefreshMenuRefreshes the contents of the Start menu. Used only with systems preceding Windows XP.
SearchCommandDisplays the Apps Search pane.
ServiceStartStarts a named service.
ServiceStopStops a named service.
SetTimeDisplays the Date and Time Properties dialog box. This method has the same effect as right-clicking the clock in the taskbar status area and selecting Adjust Date/Time.
ShellExecutePerforms a specified operation on a specified file.
ShowBrowserBarDisplays a browser bar.
ShutdownWindowsDisplays the Shut Down Windows dialog box. This is the same as clicking the Start menu and selecting Shut Down.
Suspendtd
TileHorizontallyTiles all of the windows on the desktop horizontally. This method has the same effect as right-clicking the taskbar and selecting Tile Windows Horizontally.
TileVerticallyTiles all of the windows on the desktop vertically. This method has the same effect as right-clicking the taskbar and selecting Tile Windows Vertically.
ToggleDesktopDisplays or hides the desktop.
TrayPropertiesDisplays the Taskbar and Start Menu Properties dialog box. This method has the same effect as right-clicking the taskbar and selecting Properties.
UndoMinimizeALLRestores all desktop windows to the same state they were in before the last MinimizeAll command. This method has the same effect as right-clicking the taskbar and selecting Undo Minimize All Windows on older systems or a second clicking of the Show Desktop icon in the Quick Launch area of the taskbar in Windows 2000 or Windows XP.
WindowsCreates and returns a ShellWindows object. This object represents a collection of all of the open windows that belong to the Shell.
WindowsSecurityDisplays the Windows Security dialog box.
WindowSwitcherDisplays your open windows in a 3D stack that you can flip through.

 

Properties

The Shell object has these properties.

PropertyAccess typeDescription
Application
Read-only
Contains the object's Application object.
Parent
Read-only
Gets an object that represents the parent of the current object.

 

Requirements

RequirementValue
Minimum supported client
Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Shldisp.h
IDL
Shldisp.idl
DLL
Shell32.dll (version 4.71 or later)