Click here to Skip to main content
Licence 
First Posted 16 Oct 2000
Views 426,142
Downloads 8,481
Bookmarked 117 times

CShellTreeCtrl

By | 18 Dec 2001 | Article
A CWaitingTreeCtrl-derived class to display Shell's resources

CShellTreeCtrl

This is just an example of a content provider class (see article), which overrides the PopulateItem virtual function to show the Shell's resources only when the user wants to access them.

You may easily specify the resource to use as the tree control's root item, or add multiple items at the root level. You have options to display only folders, files, hidden objects, and you can choose how to display the items text. You may also get specific information about the resource associated with an existing item.

User interface features are those offered by the base class and can be further personalized with custom animations.

This version is still under development, in particular there's no support for filtering (I accept ideas).

Demo Application

The demo project shows how to:

  • use the control in a SDI application
  • add root items to the control
  • set item's options
  • display a Shell context menu

You may use the "Test" menu to experiment with the selected item, or see the Shell context menu in the "Shell" menu. Another way to display the Shell context menu is by right-clicking on a tree item (hold on CTRL to see a cascaded popup menu).

Class Reference

CShellTreeCtrl (still subject to change)

CShellTreeCtrl::AddRootItem

void AddRootItem(LPCITEMIDLIST pidl, UINT nFlags = STCF_DEFAULT)
Adds the specified Shell object to the root level of the tree and sets options for the inserted item.

The first argument pidl is the the object you want to add, cannot be NULL. You may use SHGetSpecialFolderLocation to get a valid argument for this function.

The nFlags argument specifies the options to apply to the inserted item and can be one or more of the following values, combined with the bitwise or operator:

STCF_DEFAULT Child items can be only folders and their names refers to the parent item (like Explorer)
STCF_INCLUDEFILES Child items can be also non-folder objects
STCF_INCLUDEHIDDEN Child items can be also hidden objects (like system files)
STCF_INCLUDEALL (STCF_INCLUDEFILES|STCF_INCLUDEHIDDEN)
STCF_SHOWFULLNAME Item's name does not refer to any other folder (like shared directories in the Network Neighboorhood folder)
STCF_SHOWPATH Item's name is a relative path
STCF_SHOWFULLPATH Item's name is an absolute path

(STCF_SHOWPATH|STCF_SHOWFULLNAME)

CShellTreeCtrl::AddRootFolderContent

void AddRootFolderContent(LPCITEMIDLIST pidl, UINT nFlags = STCF_DEFAULT)
Adds the content of the specified Shell folder object to the root level of the tree and sets options for the inserted items.

The first argument pidl is the the folder object you want to enumerate. A value of NULL means that the Desktop virtual folder will be added (not its content). You may use SHGetSpecialFolderLocation to get a valid argument for this function.

The nFlags argument specifies the options to apply to the folder object during enumeration (see the previous function). STCF_SHOWxxx flags currently have no effect.

CShellTreeCtrl::GetItemIDList

CShellPidl GetItemIDList(HTREEITEM hItem)
It retrieves the Shell object associated to the specified item. The returned object is invalid if the function fails.

You may use the Shell's functions to get info about the returned value. See SHGetPathFromIDList, SHGetFileInfo documentation.

CShellTreeCtrl::GetItemContextMenu

BOOL GetItemContextMenu(HTREEITEM hItem, CShellContextMenu &rCtxMenu)
It retrieves the Shell context menu associated to the specified item. The return value is non-zero if the function is successful.

(to do)

CShellTreeCtrl::GetCallbackMask

UINT GetCallbackMask()
It retrieves which parts of a tree view item are handled by callback messages.

(see the next function)

CShellTreeCtrl::SetCallbackMask

void SetCallbackMask(UINT nMask)
It specifies which parts of a tree view item are handled by callback messages.

The nMask argument can be one or more of the following values, combined with the bitwise or operator:

TVIF_TEXT The control provides item text each time it's needed
TVIF_IMAGE same for the image
TVIF_SELECTEDIMAGE same for the selected image
TVIF_CHILDREN same for the item's button

 

Updates

17 Oct 2000

Initial public release.

7 Feb 2000

Fixed a bug with SHGetFileInfo on some machines, now using IShellFolder::GetAttributesOf (thanks to He Yingxia and Markus Axelsson)
Now correctly sort items after insertion

23 Nov 2001

New version of the control (beta)
Added wrapper classes for shell objects and interfaces
Added support for context menu

Conclusion

Please note that this class is not fully functional yet. Any suggestion on how to improve it would be greatly appreciated.

I developed this class also to provide an example of a content provider for my CWaitingTreeCtrl class (see article).

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

About the Author

Paolo Messina

Software Developer
RoboTech srl
Italy Italy

Member

Paolo began programming at the age of 9 with a glorious 8086 and GW-BASIC, then he played a bit with C, ASM and Pascal. He tought himself MFC and Windows programming, to exploit his studies of C++. Always attracted by low-level programming and Assembly, he's beginning to appreciate the joys of templates and STL. At work he changed his mind about Java, discovered Eclipse IDE, and now think it's cool.
 
He lives in Follonica, Italy.
 
He has been abroad in the U.S. to work on his final thesis before graduating. For seven months he was playing with airplanes and automatic control at the Unversity of Illinois at Urbana-Champaign.
 
He graduated in Computer Science Engineering at the University of Pisa, Italy, in December 2003.
 
Currently working for an edutainment robotics company (www.robotechsrl.com).

Sign Up to vote   Poor Excellent
Add a reason or comment to your vote: x
Votes of 3 or less require a comment

Comments and Discussions

 
You must Sign In to use this message board. (secure sign-in)
 
Search this forum  
 FAQ
    Noise  Layout  Per page   
  Refresh
QuestionHow to reliably jump to a network path? Pinmemberjimwillsher22:06 12 Feb '07  
GeneralProblem with adding checkboxes Pinmemberiohanson23:11 21 Jan '07  
QuestionCompile for Unicode? Pinmembervg8open12:31 19 Dec '06  
AnswerRe: Compile for Unicode? Pinmemberppaappuuss6:29 16 Jan '07  
GeneralRe: Compile for Unicode? Pinmembervg8open13:13 20 Jan '07  
QuestionHow to ask the tree control to select a item if I only konw the path of the item? PinmemberAki Wang21:20 17 Sep '06  
AnswerRe: How to ask the tree control to select a item if I only konw the path of the item? PinmemberPaolo Messina1:32 18 Sep '06  
GeneralRe: How to ask the tree control to select a item if I only konw the path of the item? PinmemberAki Wang18:36 20 Sep '06  
QuestionHow to show the Desktop ico as root? PinmemberAki Wang21:02 8 Aug '06  
AnswerRe: How to show the Desktop ico as root? PinmemberPaolo Messina7:55 10 Aug '06  
GeneralRe: How to show the Desktop ico as root? PinmemberAki Wang16:26 10 Aug '06  
General"Shell Controls Lib" cannot be downloaded. Pinmembertakayuki san13:07 19 Jul '06  
GeneralRe: "Shell Controls Lib" cannot be downloaded. PinmemberPaolo Messina1:20 18 Sep '06  
QuestionUnicode Version PinmemberMorpheusX10:48 5 Apr '06  
AnswerRe: Unicode Version PinmemberPaolo Messina22:34 6 Apr '06  
GeneralHi,Dear Paolo Messina , I'd like you to help me this if you are not busy :) PinmemberJimOcean6:16 16 Feb '06  
GeneralWhat's different between your PIDL::GetLength with IMalloc::getsize PinmemberJimOcean4:48 16 Feb '06  
GeneralRe: What's different between your PIDL::GetLength with IMalloc::getsize PinmemberPaolo Messina5:04 16 Feb '06  
GeneralRe: What's different between your PIDL::GetLength with IMalloc::getsize PinmemberJimOcean5:13 16 Feb '06  
GeneralRe: What's different between your PIDL::GetLength with IMalloc::getsize PinmemberJimOcean5:25 16 Feb '06  
GeneralRe: What's different between your PIDL::GetLength with IMalloc::getsize PinmemberPaolo Messina3:01 17 Feb '06  
GeneralI am trying to add Serialize into your great class CShellPidl,I do as follow, PinmemberJimOcean21:44 18 Feb '06  
GeneralRe: I am trying to add Serialize into your great class CShellPidl,I do as follow, PinmemberPaolo Messina23:02 19 Feb '06  
GeneralRe: I am trying to add Serialize into your great class CShellPidl,I do as follow, PinmemberJimOcean3:51 20 Feb '06  
GeneralOld project fails to compile too PinmemberSteve_230934n513k5n132oi512308:59 7 Feb '06  

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Mobile
Web04 | 2.5.120517.1 | Last Updated 19 Dec 2001
Article Copyright 2000 by Paolo Messina
Everything else Copyright © CodeProject, 1999-2012
Terms of Use
Layout: fixed | fluid