Difference between revisions of "User:Petr-akhlamov/Shell"

From ReactOS Wiki
Jump to: navigation, search
(Links)
(Grammar fixes. Thanks for this precious article!)
Line 2: Line 2:
 
[http://winehq.org.ru/ROS_Shell (on russian)]
 
[http://winehq.org.ru/ROS_Shell (on russian)]
 
==Progress==
 
==Progress==
*13.07.2014 - CMergedFolder was completed
+
*13.07.2014 - CMergedFolder was completed.
 
*24.08.2014 - hotkeys Ctrl+C, Ctrl+X, Ctrl+V was implemented.
 
*24.08.2014 - hotkeys Ctrl+C, Ctrl+X, Ctrl+V was implemented.
*28.09.2014 - IPC was implemented
+
*28.09.2014 - IPC was implemented.
  
 
==Shell32 components scheme==
 
==Shell32 components scheme==
Line 18: Line 18:
  
 
==Reorganization of shell resources==
 
==Reorganization of shell resources==
As part of its work (<s>{{JIRA|10030}}</s>) Robert Naumann:
+
As part of his work (<s>{{JIRA|10030}}</s>), Robert Naumann:
*reworked the property dialogs, maked them nicer, add missing resources and remove unneded ones
+
*Reworked the property dialogs, made them nicer, added missing resources and removed unneeded ones
*Changed the start menu Icon from an icon to a bitmap resource
+
*Changed the start menu icon from an icon to a bitmap resource
 
*Fixed existing and add missing icons
 
*Fixed existing and add missing icons
*reorganized the resource folder structure
+
*Reorganized the resource folder structure
  
 
==Components==
 
==Components==
 
===Browseui.dll===
 
===Browseui.dll===
 
As of 13.07.2017:
 
As of 13.07.2017:
*content of current folder are displayed
+
*contents of current folder are displayed
 
*icon is displayed in the header
 
*icon is displayed in the header
 
*buttons are displayed
 
*buttons are displayed
*buttons are have icons
+
*buttons have icons
*list mode have sort arrows
+
*list mode has sort arrows
 
====Button implementations====
 
====Button implementations====
 
The buttons in the file browser toolbar can be subdivided into 4 groups:
 
The buttons in the file browser toolbar can be subdivided into 4 groups:
 
*The navigation buttons, with history back/forward and “up”,
 
*The navigation buttons, with history back/forward and “up”,
 
*The sidebar buttons, with “folders” and “search”,
 
*The sidebar buttons, with “folders” and “search”,
*The file operations, with “copy to”, “move to”, “delete” and “undo”, and lastly
+
*The file operations, with “copy to”, “move to”, “delete” and “undo”,
 
*The view mode, which shows a dropdown to select the listview style.
 
*The view mode, which shows a dropdown to select the listview style.
  
Line 44: Line 44:
 
*folders
 
*folders
  
Implementing:
+
In progress
 
*copy to/move to ({{JIRA|11132}})
 
*copy to/move to ({{JIRA|11132}})
  
 
===Shdocvw===
 
===Shdocvw===
Shdocvw.dll - library, which contains the user interface portions of both Internet Explorer and the file system. In this context, the file system is the Windows Explorer accessory that you use to look at Windows folders and files. The "SHDocVw.dll" library is a COM object, it is not managed.
+
Shdocvw.dll is a library which contains the user interface portions of both Internet Explorer and the file system. In this context, the file system is the Windows Explorer accessory that you use to browse Windows folders and files. The "SHDocVw.dll" library is a COM object, it is not managed.
 
*[http://www.geoffchappell.com/studies/windows/ie/shdocvw/api/index.htm?tx=17,48 SHDOCVW Functions List]
 
*[http://www.geoffchappell.com/studies/windows/ie/shdocvw/api/index.htm?tx=17,48 SHDOCVW Functions List]
 
*[http://github.com/reactos/reactos/blob/master/dll/win32/shdocvw/shdocvw_main.c Implemented functions]
 
*[http://github.com/reactos/reactos/blob/master/dll/win32/shdocvw/shdocvw_main.c Implemented functions]
  
 
===Dynamic Data Exchange===
 
===Dynamic Data Exchange===
24.08.2014 DDE base code was imported from trunk.
+
24.08.2014: DDE base code was imported from trunk.
  
29.09.2014 work on it was started.
+
29.09.2014: Work on it was started.
  
After test and debugg of component in Windows, Gigaherz add it to Shell32 and test it in ReactOS.
+
After test and debug of component in Windows, Gigaherz added it to Shell32 and test it in ReactOS.
  
Due bugs in the win32k, DDE implementation is badly broken and developer set it aside, waiting while they will fixed.[http://reactos.org/node/891]
+
Due to bugs in the win32k, DDE implementation is badly broken and developer set it aside, they needs to be fixed. [http://reactos.org/node/891]
  
 
===IPC===
 
===IPC===
IPC mechanism used by browseui to open new windows in the existing process. This function was implemented 28.09.2014[http://reactos.org/node/884].
+
IPC mechanism is used by browseui to open new windows in the existing process. This function was implemented on 28.09.2014[http://reactos.org/node/884].
  
 
*{{JIRA|12577}} - disable IPC via registry
 
*{{JIRA|12577}} - disable IPC via registry
  
 
===Sidebar===
 
===Sidebar===
03.12.2014 implementation of CExplorerBand class was started , which needed for sidebar. Gigaherz was add this class for research sidebar implementation in Windows.  
+
03.12.2014: Implementation of CExplorerBand class was started , which needed for sidebar. Gigaherz added this class to research sidebar implementation in Windows.  
  
05.02.2016 patch (<s>{{JIRA|10838}}</s>) with initial implementation of classes BaseBar и CBaseBarSite was published .
+
05.02.2016: Patch (<s>{{JIRA|10838}}</s>) with initial implementation of classes BaseBar and CBaseBarSite was published .
  
19.02.2016 Sylvain Deverre started work on sidebar in github-repo.
+
19.02.2016: Sylvain Deverre started working on sidebar in github-repo.
  
30.05.2016 Results of his work was add to trunk.
+
30.05.2016: Results of his work was added to trunk.
  
01.06.2016 Sidebar was implemented.
+
01.06.2016: Sidebar was implemented.
  
26.07.2016 In the sidebar was implements expand the tree view to the current folder when a new folder is browser and showing the context menu on right click.
+
26.07.2016: In the sidebar, expanding the tree view to the current folder when a new folder is being browsed and showing the context menu on right click was implemented.
  
02.08.2016 In the sidebar was implemented displaying of disk name.
+
02.08.2016: In the sidebar, displaying of disk name was implemented.
  
01.02.2017 In the sidebar was implemented rudimentary support for drag icons.
+
01.02.2017: In the sidebar, rudimentary support for drag icons was implemented.
  
 
===Command line parameters===
 
===Command line parameters===
08.09.2014 base of parser of [http://support.microsoft.com/en-us/help/152457/windows-explorer-command-line-options command line parameters] was writes.
+
08.09.2014: Base of parser of [http://support.microsoft.com/en-us/help/152457/windows-explorer-command-line-options command line parameters] was written.
  
 
The report <s>{{JIRA|12163}}</s> was closed 07.11.2016.
 
The report <s>{{JIRA|12163}}</s> was closed 07.11.2016.
  
Now, explorer supports next parameters:
+
Now, explorer supports these parameters:
 
*/separate
 
*/separate
 
*/e
 
*/e
Line 94: Line 94:
  
 
===Desktop===
 
===Desktop===
05.02.2017 in the trunk [http://github.com/reactos/reactos/commit/2ee2be0a07df3fa381065cf6471dea4b82af6c52 was implemented] auto update of desktop after change his content.
+
05.02.2017: In the trunk, [http://github.com/reactos/reactos/commit/2ee2be0a07df3fa381065cf6471dea4b82af6c52 auto updating of desktop after its content changed] was implemented.
 
====Hide desktop icons====
 
====Hide desktop icons====
*[http://yadi.sk/d/mF_j0Mj73QGnZw reg-files] for parameters changing
+
*[http://yadi.sk/d/mF_j0Mj73QGnZw reg-files] for changing parameters
 
*{{JIRA|8427}}
 
*{{JIRA|8427}}
  
 
===Taskbar===
 
===Taskbar===
15.05.2014 work on taskbar was started.
+
15.05.2014: Work on taskbar was started.
 
[[File:Taskbar.png|center]]
 
[[File:Taskbar.png|center]]
 
As of 31.07.2017:
 
As of 31.07.2017:
*windows list is displaying
+
*windows list displays
*you can windows minimize/restore with left-click
+
*you can minimize/restore windows with left-click
 
*you can call windows action-list with right-click
 
*you can call windows action-list with right-click
 
*taskbar autohide is implemented
 
*taskbar autohide is implemented
Line 110: Line 110:
  
 
====Taskbar settings====
 
====Taskbar settings====
14.07.2017 Robert Naumann [http://github.com/reactos/reactos/commit/8bf97b3a3d6b2ad90a8f276d603bc6cf12461bb8 was started] implementation of taskbar settings saving/loading. ({{JIRA|11498}})
+
14.07.2017: Robert Naumann [http://github.com/reactos/reactos/commit/8bf97b3a3d6b2ad90a8f276d603bc6cf12461bb8 started] implementation of taskbar settings saving/loading. ({{JIRA|11498}})
  
01.11.2017 in revision [http://github.com/reactos/reactos/commit/2ed535da8ab490b53bb496f3ac25fd1fd03f4965 2ed535d] (0.4.8-dev-46) Giannis implemented some taskbar settings (lock, keep on top of other windows, auto-hide, show clock, show seconds). Other will implemented later.
+
01.11.2017: in revision [http://github.com/reactos/reactos/commit/2ed535da8ab490b53bb496f3ac25fd1fd03f4965 2ed535d] (0.4.8-dev-46) Giannis implemented some taskbar settings (lock, keep on top of other windows, auto-hide, show clock, show seconds). Others will be implemented later.
  
 
===The notification area===
 
===The notification area===
The notification area was implemented 5 июля 2014 г. Now:
+
The notification area was implemented on 05.07.2014. Now:
*in the tray displayed apps icons
+
*in the tray, apps icons are displayed
*you can app minimize/restore with left-click
+
*you can minimize/restore apps with left-click
 
*you can call app action-list with right-click
 
*you can call app action-list with right-click
 
*hiding of inactive icons is not implemented
 
*hiding of inactive icons is not implemented
 
====Shell service objects====
 
====Shell service objects====
Shell service objects - component, which implement in the tray icons of sound, battery, safely remove and others. His implementation was started 23.07.2014.  
+
Shell service objects is a component, which implements sound, battery, safely remove and other icons in the system tray. Its implementation was started on 23.07.2014.  
  
17.08.2014 basic functions was implemented.
+
17.08.2014: basic functions was implemented.
  
 
=====Next work=====
 
=====Next work=====
23-24.03.2017 Eric Kohl implemented:
+
23-24.03.2017: Eric Kohl implemented:
 
*[http://github.com/reactos/reactos/commit/a9265410de5160cdf06bb6f43956321e37bb9dca r74225] - Implement code to show and hide the power and volume icons in the notification area aka systray.
 
*[http://github.com/reactos/reactos/commit/a9265410de5160cdf06bb6f43956321e37bb9dca r74225] - Implement code to show and hide the power and volume icons in the notification area aka systray.
 
*[http://github.com/reactos/reactos/commit/3bce3e3e487cc421a886362cc3a5b355a8a4babf r74226] - Show and hide the power systray icon.
 
*[http://github.com/reactos/reactos/commit/3bce3e3e487cc421a886362cc3a5b355a8a4babf r74226] - Show and hide the power systray icon.
Line 133: Line 133:
  
 
===Address bar===
 
===Address bar===
04.05.2014 work on address bar was started.
+
04.05.2014: Work on address bar was started.
 
[[File:Shell-adress.png|center]]
 
[[File:Shell-adress.png|center]]
 
As of 25.08.2016:
 
As of 25.08.2016:
 
*implemented:
 
*implemented:
**current path displaying
+
**displaying current path
 
**icon
 
**icon
 
**recognition support
 
**recognition support
**system folder name are displayed instead GUID/CLSID
+
**system folder name is displayed instead GUID/CLSID
**address is entered with Enter pressed
+
**when pressing Enter, browsing to adress
 
**addressbar autoresizing
 
**addressbar autoresizing
 
**addressbar combobox
 
**addressbar combobox
Line 151: Line 151:
 
! Color and value
 
! Color and value
 
|-
 
|-
| style="background:salmon;"| Not function
+
| style="background:salmon;"| Not functioning
 
|-
 
|-
 
| style="background:#a0e75a;"| Implemented
 
| style="background:#a0e75a;"| Implemented
Line 216: Line 216:
 
! Color and value
 
! Color and value
 
|-
 
|-
| style="background:salmon;"| Not function
+
| style="background:salmon;"| Not functioning
 
|-
 
|-
 
| style="background:#a0e75a;"| Implemented
 
| style="background:#a0e75a;"| Implemented
Line 286: Line 286:
 
*{{JIRA|12906}} - Folder Options: File Types: Implement
 
*{{JIRA|12906}} - Folder Options: File Types: Implement
  
05.02.2017 folder properties dialog was implemented in [http://github.com/reactos/reactos/commit/029cc4a9a1594eaf2358af2512e624162b7694e2 r73703] with all available settings.
+
05.02.2017: folder properties dialog was implemented in [http://github.com/reactos/reactos/commit/029cc4a9a1594eaf2358af2512e624162b7694e2 r73703] with all available settings.
  
 
=====Copy to / Move to=====
 
=====Copy to / Move to=====
18.04.2016 Barrett Karish was publish patch with implementation of this function.
+
18.04.2016: Barrett Karish sent a patch with implementation of this function.
 
*{{JIRA|11132}}
 
*{{JIRA|11132}}
  
 
=====Connect/disconnect network drive=====
 
=====Connect/disconnect network drive=====
03.07.2017 Jared Smudde started implementation of ''netplwiz.dll'' library, which perform this function.
+
03.07.2017: Jared Smudde started implementation of ''netplwiz.dll'' library, which performs this function.
 
*{{JIRA|13518}}
 
*{{JIRA|13518}}
 
*[http://youtu.be/NGYQ1CVDmWQ video]
 
*[http://youtu.be/NGYQ1CVDmWQ video]
Line 300: Line 300:
 
====Start setting====
 
====Start setting====
 
[[File:classicconf.png|right|300px]]
 
[[File:classicconf.png|right|300px]]
*21.11.2015 in [http://code.reactos.org/changelog/reactos?cs=69992 r69992] was started implementation of setting dialog of classic start menu
+
*21.11.2015: in [http://code.reactos.org/changelog/reactos?cs=69992 r69992], implementation of setting dialog of classic start menu was started.
*22.11.2015 in [http://code.reactos.org/changelog/reactos?cs=70001 r70001] was implemented buttons:
+
*22.11.2015: in [http://code.reactos.org/changelog/reactos?cs=70001 r70001], these buttons were implemented:
 
**Add > open shortcut wizard
 
**Add > open shortcut wizard
 
**Advancad  > open '''''%username%/Start menu'''''
 
**Advancad  > open '''''%username%/Start menu'''''
Line 308: Line 308:
 
====Shutdown dialog====
 
====Shutdown dialog====
 
[[File:Shell-poweroff.png|350px|center]]
 
[[File:Shell-poweroff.png|350px|center]]
29.09.2014 in shell-experiments was applied [http://jira.reactos.org/browse/CORE-7559 patch] with new shutdown dialog.
+
29.09.2014: in shell-experiments, a [http://jira.reactos.org/browse/CORE-7559 patch] with new shutdown dialog was applied.
  
 
==Additional features==
 
==Additional features==
 
===Copy dialog===
 
===Copy dialog===
 
[[File:Copydialog.png|350px|center]]
 
[[File:Copydialog.png|350px|center]]
Work on copy dialog was started in november 2014. (<s>{{JIRA|4476}}</s>)
+
Work on copy dialog was started in November 2014. (<s>{{JIRA|4476}}</s>)
*23-feb-2015 it was implemented, but without animation
+
*23.02.2015: It was implemented, but without animation.
*23-apr-2015 was implemented animation
+
*23.04.2015: Animation was implemented.
  
 
===Show of hidden files===
 
===Show of hidden files===
Implementation of this feature was start 17.02.2015 and finished 14.03.2015. (<s>{{JIRA|9207}}</s>)
+
Implementation of this feature was started on 17.02.2015 and finished on 14.03.2015. (<s>{{JIRA|9207}}</s>)
  
 
===Shell extensions===
 
===Shell extensions===
====Browser of registry и NT-objects====
+
====Browser of registry and NT-objects====
15.03.2015 was implemented replace for explorer registry and NT-objects from old explorer as shell-extensions. <s>{{JIRA|9244}}</s>
+
15.03.2015: Exploring registry and NT objects from explorer was implemented. <s>{{JIRA|9244}}</s>
 
<center>
 
<center>
 
[[File:Reg_new.png|350px]]
 
[[File:Reg_new.png|350px]]
Line 329: Line 329:
  
 
====Virtual desktops====
 
====Virtual desktops====
Maybe, this function [http://jira.reactos.org/browse/CORE-8730 will implemented] as shell extension.
+
This function [http://jira.reactos.org/browse/CORE-8730 may be implemented] as a shell extension.
  
 
====Improve support for shell extensions====
 
====Improve support for shell extensions====
Line 337: Line 337:
 
*shell32: rewrite shell folders implementation ({{JIRA|7585}})
 
*shell32: rewrite shell folders implementation ({{JIRA|7585}})
 
=====Zip folder namespace extension=====
 
=====Zip folder namespace extension=====
One of five extensions, which implementation is started.
+
It's the one of five extensions, which implementation is started.
 
*{{JIRA|7684}}
 
*{{JIRA|7684}}
 
*http://github.com/learn-more/reactos/tree/zipfldr
 
*http://github.com/learn-more/reactos/tree/zipfldr
  
 
====Taskbar extensions====
 
====Taskbar extensions====
They was implemented on GSoC. (quick start panel, battery state, and  usb-ejecter)
+
They were implemented in GSoC. (quick start panel, battery state, and  usb-ejecter)
  
18.08.2017 USB-ejecter extension [http://code.reactos.org/changelog/reactos?cs=75611 was added] to trunk.
+
18.08.2017: USB-ejecter extension [http://code.reactos.org/changelog/reactos?cs=75611 was added] to trunk.
 
*<s>{{JIRA|13841}}</s> - implementation of eject CD/DVD/USB
 
*<s>{{JIRA|13841}}</s> - implementation of eject CD/DVD/USB
  
 
=====QuickLaunch panel=====
 
=====QuickLaunch panel=====
20.10.2017 [http://github.com/reactos/reactos/commit/37e6151b40178a2cbea3fc17999eaa35d328666c was implemented] quick launch panel extension.  
+
20.10.2017: [http://github.com/reactos/reactos/commit/37e6151b40178a2cbea3fc17999eaa35d328666c Quick launch panel extension] was implemented.
  
For filling panel need to add shortcuts to folder '''C:\Documents and Settings\%username%\Application Data\Microsoft\Internet Explorer\Quick Launch'''.
+
For filling panel, adding shortcuts to '''C:\Documents and Settings\%username%\Application Data\Microsoft\Internet Explorer\Quick Launch''' folder is needed.
  
 
Also, you can create user bar.
 
Also, you can create user bar.
  
The panel is created on the right. You can't move it. Shortcuts runs. You can show/hide text, title, close panel. You can do reduce the panel, but hidden icons don't restored. Bug: you can't without errors swap quickstart panel and taskbar.
+
The panel is created on the right. You can't move it. Shortcuts runs You can show/hide text and title, close panel. You can reduce the panel, but hidden icons aren't restored. Bug: you can't swap without errors quickstart panel and taskbar.
  
 
===Sort arrows===
 
===Sort arrows===
13.07.2017 in the shell [http://code.reactos.org/changelog/reactos?cs=75325 was implemented] [http://jira.reactos.org/browse/CORE-11776 sort arrows] in the list.
+
13.07.2017: In the shell, [http://code.reactos.org/changelog/reactos?cs=75325 was implemented] [http://jira.reactos.org/browse/CORE-11776 sort arrows] in the list.
  
 
===HotKeys===
 
===HotKeys===
Line 365: Line 365:
 
! Color and value
 
! Color and value
 
|-
 
|-
| style="background:salmon;"| Not function
+
| style="background:salmon;"| Not functioning
 
|-
 
|-
 
| style="background:#a0e75a;"| Implemented
 
| style="background:#a0e75a;"| Implemented
Line 509: Line 509:
 
==Other classes==
 
==Other classes==
 
===CMergedFolder===
 
===CMergedFolder===
The CMergedFolder class structure is set of classes, whose primary purpose of the merged folder is the ability to aggregate the contents of multiple shell folders into one virtual folder that includes items from all of the sources, and also merges the child items of the same name into one virtual item.
+
The CMergedFolder class structure is a set of classes, whose primary purpose of the merged folder is the ability to aggregate the contents of multiple shell folders into one virtual folder that includes items from all of the sources, and also merges the child items of the same name into one virtual item.
  
Implementation was started 28.06.2014 and finished 13.07.2014.
+
Implementation was started on 28.06.2014 and finished on 13.07.2014.
  
It used in:
+
It is used in:
 
====Programs====
 
====Programs====
CMergedFolder allows displayed in the start menu the shortcuts from two folders:
+
CMergedFolder allows displaying shortcuts in the start menu from two folders:
 
*"Programs" (content of ''%userprofile%/Start menu/Programs'' and ''All Users/Start menu/Programs'').
 
*"Programs" (content of ''%userprofile%/Start menu/Programs'' and ''All Users/Start menu/Programs'').
 
*"Start menu" (content of ''%userprofile%/Start menu'' and ''All Users/Start menu'')
 
*"Start menu" (content of ''%userprofile%/Start menu'' and ''All Users/Start menu'')
 
====Favourites====
 
====Favourites====
Favourites displayed shortcuts from ''%userprofile%/Favourites''.
+
Favourites displays shortcuts from ''%userprofile%/Favourites''.
 
==== Recent documents ====
 
==== Recent documents ====
Recent documents in the Start, with using CMergedFolder show files from ''%userprofile%/Recent''.
+
Recent documents in the start menu, with using CMergedFolder to show files from ''%userprofile%/Recent''.
  
 
===CFocusManager===
 
===CFocusManager===
This class needed for determination and set focus area and for setting elements, which have focus on menu panel. His implementation was started together with menu panel.
+
This class is needed for determination and set focus area and for setting elements, which have focus on menu panel. Its implementation was started together with menu panel.
  
 
===CShellDispatch===
 
===CShellDispatch===
CShellDispatch implements objects of [http://msdn.microsoft.com/en-us/library/windows/desktop/gg537707(v=vs.85).aspx IShellDispatch] v1-6. Since ReactOS seeks to compatibility with Win2k3, then in her will implemented v1-4. ({{JIRA|6892}})
+
CShellDispatch implements objects of [http://msdn.microsoft.com/en-us/library/windows/desktop/gg537707(v=vs.85).aspx IShellDispatch] v1-6. Since ReactOS seeks to compatibility with Win2k3, then it will be implemented as v1-4. ({{JIRA|6892}})
  
The IShellDispatch 2 is planned to taken from Wine, converted it to C++, added to ReactOS and finalized.
+
The IShellDispatch2 is planned to be taken from Wine, converted it to C++, added to ReactOS and finalized.
  
Also, in shldisp.idl are missing IShellDispatch3 and IShellDispatch4 (and v5 and v6, but they not include in W2k3). They and tests, which will be written later, will send to Wine.
+
Also, in shldisp.idl, IShellDispatch3 and IShellDispatch4 are missing (and v5 and v6, but they are not included in W2k3). These and tests, which will be written later, will be sent to Wine.
  
First commits was in rr71116 and 71117.
+
First commits was in r71116 and 71117.
  
 
*{{JIRA|12955}} - implementation:
 
*{{JIRA|12955}} - implementation:
 
**''ShellExecute'' - performs a specified operation on a specified file[http://msdn.microsoft.com/en-us/library/windows/desktop/bb774148(v=vs.85).aspx]
 
**''ShellExecute'' - performs a specified operation on a specified file[http://msdn.microsoft.com/en-us/library/windows/desktop/bb774148(v=vs.85).aspx]
 
**''IsServiceRunning'' - returns a value that indicates whether a particular service is running.[http://msdn.microsoft.com/en-us/library/windows/desktop/bb774142(v=vs.85).aspx]
 
**''IsServiceRunning'' - returns a value that indicates whether a particular service is running.[http://msdn.microsoft.com/en-us/library/windows/desktop/bb774142(v=vs.85).aspx]
*''ShutdownWindows'' was implemented 02.04.2017 in r74268 - show shutdown dialog[http://msdn.microsoft.com/en-us/library/windows/desktop/gg537727(v=vs.85).aspx]
+
*''ShutdownWindows'' was implemented on 02.04.2017 in r74268 - shows shutdown dialog[http://msdn.microsoft.com/en-us/library/windows/desktop/gg537727(v=vs.85).aspx]
  
 
===PaintMenuBar===
 
===PaintMenuBar===
31.03.2017 Giannis [http://github.com/reactos/reactos/commit/cf6d69d369b6661fc359621996873b18259b77fb was added] the prototype of function [http://documentation.devexpress.com/#windowsforms/DevExpressXtraBarsPopupMenu_PaintMenuBartopic PaintMenuBar], which draw gradient and text on the side of menu (for example Start).
+
31.03.2017: Giannis [http://github.com/reactos/reactos/commit/cf6d69d369b6661fc359621996873b18259b77fb added] the prototype of function [http://documentation.devexpress.com/#windowsforms/DevExpressXtraBarsPopupMenu_PaintMenuBartopic PaintMenuBar], which draws gradient and text on the side of menu (for example Start).
  
 
===DirectUI===
 
===DirectUI===
Task pane <s>{{JIRA|11401}}</s> - will not implemented
+
Task pane <s>{{JIRA|11401}}</s> - will not be implemented in near future
  
 
==Themes in new explorer==
 
==Themes in new explorer==
*27.08.2017 - was fixed support of alpha-channels in the themes (<s>{{JIRA|13464}}</s>, [http://code.reactos.org/changelog/reactos?cs=75688 r75688])
+
*27.08.2017: Support of alpha-channels in the themes (<s>{{JIRA|13464}}</s> was fixed in [http://code.reactos.org/changelog/reactos?cs=75688 r75688])
  
 
==Settings via registry==
 
==Settings via registry==
Line 553: Line 553:
  
 
'''HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced\'''
 
'''HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced\'''
*Hidden - show hidden folders and files
+
*Hidden - shows hidden folders and files
*HideFileExt - hide files extensions
+
*HideFileExt - hides files extensions
 
*ListviewShadow - shadows at icons text on the desktop
 
*ListviewShadow - shadows at icons text on the desktop
 
*StartMenuLogoff - "Logoff" item in the Start
 
*StartMenuLogoff - "Logoff" item in the Start

Revision as of 06:56, 27 December 2017

About Shell

(on russian)

Progress

  • 13.07.2014 - CMergedFolder was completed.
  • 24.08.2014 - hotkeys Ctrl+C, Ctrl+X, Ctrl+V was implemented.
  • 28.09.2014 - IPC was implemented.

Shell32 components scheme

Shellclasses 2.png

Unimplemented features

  • DDE

Reports in the bugtracker

  • shell/explorer issues (CORE-5620)
  • Major unimplemented features of the shell (CORE-9277)
  • shell32: shell icon cache and icon extractors need to be rewritten (CORE-7563)

Reorganization of shell resources

As part of his work (CORE-10030), Robert Naumann:

  • Reworked the property dialogs, made them nicer, added missing resources and removed unneeded ones
  • Changed the start menu icon from an icon to a bitmap resource
  • Fixed existing and add missing icons
  • Reorganized the resource folder structure

Components

Browseui.dll

As of 13.07.2017:

  • contents of current folder are displayed
  • icon is displayed in the header
  • buttons are displayed
  • buttons have icons
  • list mode has sort arrows

Button implementations

The buttons in the file browser toolbar can be subdivided into 4 groups:

  • The navigation buttons, with history back/forward and “up”,
  • The sidebar buttons, with “folders” and “search”,
  • The file operations, with “copy to”, “move to”, “delete” and “undo”,
  • The view mode, which shows a dropdown to select the listview style.

Works:

  • navigation
  • view mode
  • folders

In progress

Shdocvw

Shdocvw.dll is a library which contains the user interface portions of both Internet Explorer and the file system. In this context, the file system is the Windows Explorer accessory that you use to browse Windows folders and files. The "SHDocVw.dll" library is a COM object, it is not managed.

Dynamic Data Exchange

24.08.2014: DDE base code was imported from trunk.

29.09.2014: Work on it was started.

After test and debug of component in Windows, Gigaherz added it to Shell32 and test it in ReactOS.

Due to bugs in the win32k, DDE implementation is badly broken and developer set it aside, they needs to be fixed. [1]

IPC

IPC mechanism is used by browseui to open new windows in the existing process. This function was implemented on 28.09.2014[2].

Sidebar

03.12.2014: Implementation of CExplorerBand class was started , which needed for sidebar. Gigaherz added this class to research sidebar implementation in Windows.

05.02.2016: Patch (CORE-10838) with initial implementation of classes BaseBar and CBaseBarSite was published .

19.02.2016: Sylvain Deverre started working on sidebar in github-repo.

30.05.2016: Results of his work was added to trunk.

01.06.2016: Sidebar was implemented.

26.07.2016: In the sidebar, expanding the tree view to the current folder when a new folder is being browsed and showing the context menu on right click was implemented.

02.08.2016: In the sidebar, displaying of disk name was implemented.

01.02.2017: In the sidebar, rudimentary support for drag icons was implemented.

Command line parameters

08.09.2014: Base of parser of command line parameters was written.

The report CORE-12163 was closed 07.11.2016.

Now, explorer supports these parameters:

  • /separate
  • /e
  • /select

Desktop

05.02.2017: In the trunk, auto updating of desktop after its content changed was implemented.

Hide desktop icons

Taskbar

15.05.2014: Work on taskbar was started.

Taskbar.png

As of 31.07.2017:

  • windows list displays
  • you can minimize/restore windows with left-click
  • you can call windows action-list with right-click
  • taskbar autohide is implemented
  • taskbar size changing to certain step

Taskbar settings

14.07.2017: Robert Naumann started implementation of taskbar settings saving/loading. (CORE-11498)

01.11.2017: in revision 2ed535d (0.4.8-dev-46) Giannis implemented some taskbar settings (lock, keep on top of other windows, auto-hide, show clock, show seconds). Others will be implemented later.

The notification area

The notification area was implemented on 05.07.2014. Now:

  • in the tray, apps icons are displayed
  • you can minimize/restore apps with left-click
  • you can call app action-list with right-click
  • hiding of inactive icons is not implemented

Shell service objects

Shell service objects is a component, which implements sound, battery, safely remove and other icons in the system tray. Its implementation was started on 23.07.2014.

17.08.2014: basic functions was implemented.

Next work

23-24.03.2017: Eric Kohl implemented:

  • r74225 - Implement code to show and hide the power and volume icons in the notification area aka systray.
  • r74226 - Show and hide the power systray icon.
    • r74228 - Implement the power schemes popup menu.
  • r74227 - Show and hide the volume systray icon.

Address bar

04.05.2014: Work on address bar was started.

Shell-adress.png

As of 25.08.2016:

  • implemented:
    • displaying current path
    • icon
    • recognition support
    • system folder name is displayed instead GUID/CLSID
    • when pressing Enter, browsing to adress
    • addressbar autoresizing
    • addressbar combobox
Shell adresslist.png

CLSID

Color and value
Not functioning
Implemented
Missing in Windows XP

About unimplemented CLSIDs:

  • Network Computers - in Windows XP opens "search results of computers"
  • Scheduled Tasks - opens the relevant folder

Other CLSIDs are missing in NT5.

CLSID
Administrative Tools
Briefcase
Control Panel
Fonts
History
Inbox
MS Network
My Computer
My Documents
My Network Places
Network Computers
Network Connections
Printers and Faxes
Programs Folder
Recycle Bin
Scanners and Cameras
Scheduled Tasks
Start Menu Folder
Temporary Internet Files
Web Folders

Menu bar

Unimplemented items are displayed as inactive. It works with keyboard control.

Missing

Menu items implementation

Color and value
Not functioning
Implemented
Menu
File Close
Edit Undo
Cut
Copy
Paste
Paste Shortcut
Copy To Folder...
Move To Folder...
Select All
Invert Selection
View Toolbars
Status Bar
Explorer Bar
Icon sizes
Go to
Refresh
Favorites Add to Favorites
Organize Favorites
Tools Map Network Drive
Disconnect Network Drive
Synchronize
Folder Options
Help About ReactOS
Folder options
Folder-options.png
  • CORE-10837 - Unable to launch Folder Options due to missing class
  • CORE-11141 - FolderOptions are unimplemented
  • CORE-10800 - Improvements to Folder Options
  • CORE-1246 - Changing or creating new file associations in Folder options is missing
  • CORE-12540 - Implement TreeView of Folder Options
  • CORE-12906 - Folder Options: File Types: Implement

05.02.2017: folder properties dialog was implemented in r73703 with all available settings.

Copy to / Move to

18.04.2016: Barrett Karish sent a patch with implementation of this function.

Connect/disconnect network drive

03.07.2017: Jared Smudde started implementation of netplwiz.dll library, which performs this function.

"Start"

Start setting

Classicconf.png
  • 21.11.2015: in r69992, implementation of setting dialog of classic start menu was started.
  • 22.11.2015: in r70001, these buttons were implemented:
    • Add > open shortcut wizard
    • Advancad > open %username%/Start menu
    • Clear > Clears %username%/Recent

Shutdown dialog

Shell-poweroff.png

29.09.2014: in shell-experiments, a patch with new shutdown dialog was applied.

Additional features

Copy dialog

Copydialog.png

Work on copy dialog was started in November 2014. (CORE-4476)

  • 23.02.2015: It was implemented, but without animation.
  • 23.04.2015: Animation was implemented.

Show of hidden files

Implementation of this feature was started on 17.02.2015 and finished on 14.03.2015. (CORE-9207)

Shell extensions

Browser of registry and NT-objects

15.03.2015: Exploring registry and NT objects from explorer was implemented. CORE-9244

Reg new.png NTObj new.png

Virtual desktops

This function may be implemented as a shell extension.

Improve support for shell extensions

Shell Namespace Extensions

  • shell32: rewrite shell folders implementation (CORE-7585)
Zip folder namespace extension

It's the one of five extensions, which implementation is started.

Taskbar extensions

They were implemented in GSoC. (quick start panel, battery state, and usb-ejecter)

18.08.2017: USB-ejecter extension was added to trunk.

QuickLaunch panel

20.10.2017: Quick launch panel extension was implemented.

For filling panel, adding shortcuts to C:\Documents and Settings\%username%\Application Data\Microsoft\Internet Explorer\Quick Launch folder is needed.

Also, you can create user bar.

The panel is created on the right. You can't move it. Shortcuts runs You can show/hide text and title, close panel. You can reduce the panel, but hidden icons aren't restored. Bug: you can't swap without errors quickstart panel and taskbar.

Sort arrows

13.07.2017: In the shell, was implemented sort arrows in the list.

HotKeys

Color and value
Not functioning
Implemented
Not tested
Missing in Windows XP (or only in programs)
Hotkeys
CTRL
CTRL + A
CTRL + C
CTRL + F
CTRL + G
CTRL + N
CTRL + O
CTRL + P
CTRL + S
CTRL + V
CTRL + X
CTRL + Z
CTRL + F4
CTRL + while dragging an item
CTRL + SHIFT with arrow keys
CTRL + ESC
CTRL + F6
ALT
ALT+ENTER
ALT+F4
ALT+SPACEBAR
ALT+TAB
ALT+ESC
FUN
F1
F2
F3
F4
F5
F6
F10
WIN
Windows Logo
Windows Logo+BREAK
Windows Logo+D
Windows Logo+M
Windows Logo+SHIFT+M
Windows Logo+E
Windows Logo+F
CTRL+Windows Logo+F
Windows Logo+F1
Windows Logo+ L
Windows Logo+R
Windows Logo+U
dialogue
TAB
SHIFT+TAB
CTRL+TAB
CTRL+SHIFT+TAB
ALT+Underlined letter
ENTER
SPACEBAR
F1
F4
Arrow keys
BACKSPACE
Explorer
END
HOME
NUM LOCK+Asterisk sign (*)
NUM LOCK+Plus sign (+)
NUM LOCK+Minus sign (-)
LEFT ARROW
RIGHT ARROW

Other classes

CMergedFolder

The CMergedFolder class structure is a set of classes, whose primary purpose of the merged folder is the ability to aggregate the contents of multiple shell folders into one virtual folder that includes items from all of the sources, and also merges the child items of the same name into one virtual item.

Implementation was started on 28.06.2014 and finished on 13.07.2014.

It is used in:

Programs

CMergedFolder allows displaying shortcuts in the start menu from two folders:

  • "Programs" (content of %userprofile%/Start menu/Programs and All Users/Start menu/Programs).
  • "Start menu" (content of %userprofile%/Start menu and All Users/Start menu)

Favourites

Favourites displays shortcuts from %userprofile%/Favourites.

Recent documents

Recent documents in the start menu, with using CMergedFolder to show files from %userprofile%/Recent.

CFocusManager

This class is needed for determination and set focus area and for setting elements, which have focus on menu panel. Its implementation was started together with menu panel.

CShellDispatch

CShellDispatch implements objects of IShellDispatch v1-6. Since ReactOS seeks to compatibility with Win2k3, then it will be implemented as v1-4. (CORE-6892)

The IShellDispatch2 is planned to be taken from Wine, converted it to C++, added to ReactOS and finalized.

Also, in shldisp.idl, IShellDispatch3 and IShellDispatch4 are missing (and v5 and v6, but they are not included in W2k3). These and tests, which will be written later, will be sent to Wine.

First commits was in r71116 and 71117.

  • CORE-12955 - implementation:
    • ShellExecute - performs a specified operation on a specified file[3]
    • IsServiceRunning - returns a value that indicates whether a particular service is running.[4]
  • ShutdownWindows was implemented on 02.04.2017 in r74268 - shows shutdown dialog[5]

PaintMenuBar

31.03.2017: Giannis added the prototype of function PaintMenuBar, which draws gradient and text on the side of menu (for example Start).

DirectUI

Task pane CORE-11401 - will not be implemented in near future

Themes in new explorer

  • 27.08.2017: Support of alpha-channels in the themes (CORE-13464 was fixed in r75688)

Settings via registry

You can change some parameters in registry.

HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced\

  • Hidden - shows hidden folders and files
  • HideFileExt - hides files extensions
  • ListviewShadow - shadows at icons text on the desktop
  • StartMenuLogoff - "Logoff" item in the Start

Links