Windows 7編程新特性Shell Library接口介紹
目前看來很多Windows 7編程新特性都是圍繞.NET平臺進(jìn)行的，畢竟都是微軟一家的東西。
下文所用到的示例代碼來源于微軟一站式開發(fā)技術(shù)框架解決方案。你可以通過http://cfx.codeplex.com/Release/ProjectReleases.aspx下載到Windows7ShellLibrary相關(guān)的sample。其中包含C++、C#、VB.NET對ShellLibrary操作的示例代碼：CppWin7ShellLibrary,C#Win7ShellLibrary,VBWin7ShellLibrary。
為了幫助用戶更加有效地對硬盤上的文件進(jìn)行管理，Windows7中引入了新的文件管理方式：庫(Library)。庫自然演化自以往操作系統(tǒng)中MyDocuments文件夾這個概念。有了庫，我們就可以將多個相關(guān)的文件夾組織到同一個庫下，從而更快更便捷地管理和搜索數(shù)據(jù)。
創(chuàng)建Windows Shell Library
Windows 7提供了SHCreateLibrary API用來創(chuàng)建一個Shell Library：
C++ CreateShellLibrary /**//*! * Create a new shell libraryunderthe users Libraries folder. if a library *with the same namealready exists, the new one overrides theexisting one. * * \parampwszLibraryName * The name of the shelllibrary to be created. */BOOLCreateShellLibrary( LPWSTR pwszLibraryName){/**////////////////////////////////////////////////////////////////////////////Create the shell library COM object. // IShellLibrary* pShellLib=NULL; HRESULT hr =SHCreateLibrary(IID_PPV_ARGS(&pShellLib)); if(FAILED(hr)) {_tprintf(_T(SHCreateLibrary failed to create theshell library )\ _T(COM object w/err 0x%08lx\n), hr);returnjiacubiaoj ijiacubiaoj ifalse;}/**///////////////////////////////////////////////////////////////////////////Save the new library under the users Libraries folder.//IShellItem* pSavedTo = NULL; hr=pShellLib->SaveInKnownFolder(FOLDERID_UsersLibraries,pwszLibraryName,LSF_OVERRIDEEXISTING, &pSavedTo); if (FAILED(hr)){_tprintf(_T(IShellLibrary::SaveInKnownFolder failed to save the)\ _T(library w/err 0x%08lx\n), hr); returnjiacubiaojijiacubiaoj ifalse;}/**////////////////////////////////////////////////////////////////////////////Clean up. // if (pShellLib != NULL)pShellLib->Release(); if(pSavedTo !=NULL) pSavedTo->Release(); return true;}/**////////////////////////////////////////////////////////////////////////Create a shell library. // using (ShellLibrary library =newShellLibrary(libraryName, true)) { }
管理Windows Shell Library
你可以通過調(diào)用SHShowManageLibraryUI API顯示出Windows標(biāo)準(zhǔn)的ShellLibrary管理對話框。值得注意的是，在調(diào)用SHShowManageLibraryUI前請確保shelllibrary沒有被以可寫方式打開。否則在SHShowManageLibraryUI中對shelllibrary的修改將無法被保存。
C++ ShowManageLibraryUI
C++ ShowManageLibraryUI
/**//*!
* Shows the library management dialog box of thespec ifiedlibrary, which
* enables users to manage the library folders and defaultsavelocation.
*
* \param pwszLibraryName
* The name of the shell library
*/
BOOL ShowManageLibraryUI( LPWSTR pwszLibraryName)
{
// Get the shell item that represents the library.
IShellItem2* pShellItem=GetShellLibraryItem(pwszLibraryName);
HRESULT hr = SHShowManageLibraryUI(pShellItem, NULL,
LCppWin7ShellLibrary, LManage Library foldersandsettings,
LMD_ALLOWUNINDEXABLENETWORKLOCATIONS);
// Clean up
if (pShellItem != NULL)
pShellItem->Release();
return SUCCEEDED(hr);
}
C# ShowManageLibraryUI
// ShowManageLibraryUI requires that the library isnotcurrently
// opened with write permission.
ShellLibrary.ShowManageLibraryUI(libraryName, IntPtr.Zero,
CSWin7ShellLibrary, Manage Library folders and settings,true);
向Shell Library中添加文件夾
SHAddFolderPathToLibrary可用來向指定的Shell Library中添加文件夾。
C++ AddFolderToShellLibrary
/**//*!
* Add a folder to an existing shell library.
*
* \param pShellLib
* The IShellLibrary interface of the shell library
*
* \param pwszFolderPath
* The path of the folder to be added into the shell library
*
* \param bSaveLocation
* if bSaveLocation is true, set thefolder as the save location ofthe shell
* library
*/
BOOL AddFolderToShellLibrary(IShellLibrary* pShellLib,
LPWSTR pwszFolderPath, BOOL bSaveLocation)
{
HRESULT hr =SHAddFolderPathToLibrary(pShellLib,pwszFolderPath);
if (FAILED(hr))
{
_tprintf(_T(SHAddFolderPathToLibrary failed to add a folder)\
_T(to the shell library w/err 0x%08lx\n), hr);
return jiacubiaoj ijiacubiaoj ifalse;
}
// Save the folder as the save location of the shell library
if (bSaveLocation)
{
// Create shell item from folder path
IShellItem2* pShellItemSaveFolder = NULL;
hr = SHCreateItemFromParsingName(pwszFolderPath, 0,
IID_PPV_ARGS(&pShellItemSaveFolder));
if (FAILED(hr))
{
_tprintf(_T(SHCreateItemFromParsingName failed w/err ) \
_T(0x%08lx\n), hr);
return jiacubiaoj ijiacubiaoj ifalse;
}
// Set the folder as the save location
pShellLib->SetDefaultSaveFolder(DSFT_DETECT,pShellItemSaveFolder);
if (pShellItemSaveFolder != NULL)
pShellItemSaveFolder->Release();
if (FAILED(hr))
{
_tprintf(_T(IShellLibrary::SetDefaultSaveFolder failed ) \
_T(w/err 0x%08lx\n), hr);
return jiacubiaoj ijiacubiaoj ifalse;
}
}
// Commit the change of the shell library
pShellLib->Commit();
return true;
}
C# AddFolderToShellLibrary
using (ShellLibrary library =ShellLibrary.Load(libraryName,jiacubiaoj ijiacubiaoj ifalse))
{
/**//////////////////////////////////////////////////////////////////
// Add a folder to the shell library.
//
// Add the folder to the shell library
library.Add(folderPath);
library.DefaultSaveFolder = folderPath;
}
枚舉Shell Library中的文件夾
IShellLibrary::GetFolders可用來得到Shell Library中的文件夾。
刪除一個Shell Library
Windows 7編程新特性Shell Library接口介紹就到這里吧。
【編輯推薦】
