CShellManager – třída

Implementuje několik metod, které umožňují pracovat s ukazateli na seznamy identifikátorů (PIDLs).

Syntaxe

class CShellManager : public CObject

Členové

Veřejné konstruktory

Jméno	popis
CShellManager::CShellManager	CShellManager Vytvoří objekt.

Veřejné metody

Jméno	popis
CShellManager::BrowseForFolder	Zobrazí dialogové okno, které uživateli umožňuje vybrat složku prostředí.
CShellManager::ConcatenateItem	Zřetězí dva kódy PIN.
CShellManager::CopyItem	Vytvoří nový PIDL a zkopíruje do něj zadaný PIDL.
CShellManager::CreateItem	Vytvoří nový PIDL zadané velikosti.
CShellManager::FreeItem	Odstraní zadaný PIDL.
CShellManager::GetItemCount	Vrátí počet položek v zadaném PIDL.
CShellManager::GetItemSize	Vrátí velikost zadaného PIDL.
CShellManager::GetNextItem	Vrátí další položku z PIDL.
CShellManager::GetParentItem	Načte nadřazenou položku zadané položky.
CShellManager::ItemFromPath	Načte PIDL pro položku identifikovanou zadanou cestou.

Poznámky

Metody CShellManager třídy se týkají kódů PIDL. PIDL je jedinečný identifikátor objektu prostředí.

Objekt byste neměli vytvářet CShellManager ručně. Vytvoří se automaticky v rámci vaší aplikace. Během procesu inicializace aplikace byste však měli volat CWinAppEx::InitShellManager . Pokud chcete získat ukazatel na správce prostředí pro vaši aplikaci, zavolejte CWinAppEx::GetShellManager.

Hierarchie dědičnosti

Objekt CObject

CShellManager

Požadavky

Hlavička: afxshellmanager.h

CShellManager::BrowseForFolder

Zobrazí dialogové okno, které uživateli umožňuje vybrat složku prostředí.

BOOL BrowseForFolder(
    CString& strOutFolder,
    CWnd* pWndParent = NULL,
    LPCTSTR lplszInitialFolder = NULL,
    LPCTSTR lpszTitle = NULL,
    UINT ulFlags = BIF_RETURNONLYFSDIRS,
    LPINT piFolderImage = NULL);

Parametry

strOutFolder
[ven] Řetězec používaný metodou k uložení cesty k vybrané složce.

pWndParent
[v] Ukazatel na nadřazené okno.

lplszInitialFolder
[v] Řetězec obsahující složku, která je ve výchozím nastavení vybrána při zobrazení dialogového okna.

lpszTitle
[v] Název dialogového okna.

ulFlags
[v] Příznaky určující možnosti dialogového okna. Podrobný popis najdete v části BROWSEINFO .

piFolderImage
[ven] Ukazatel na celočíselnou hodnotu, kde metoda zapíše index obrázku vybrané složky.

Vrácená hodnota

Nenulové, pokud uživatel vybere složku z dialogového okna; jinak 0.

Poznámky

Při volání této metody aplikace vytvoří a zobrazí dialogové okno, které uživateli umožní vybrat složku. Metoda zapíše cestu ke složce do parametru strOutFolder .

Příklad

Následující příklad ukazuje, jak načíst odkaz na CShellManager objekt pomocí CWinAppEx::GetShellManager metody a jak použít metodu BrowseForFolder . Tento fragment kódu je součástí ukázky Průzkumníka.

CString strPath;
// The this pointer points to the CExplorerView class which extends the CView class.
// CMFCShellListCtrl m_wndList
if (m_wndList.GetCurrentFolder(strPath) &&
    theApp.GetShellManager()->BrowseForFolder(strPath,
                                              this, strPath, _T("Copy the selected item(s) to the folder:")))
{
   MessageBox(CString(_T("The selected path is: ")) + strPath);
}

CShellManager::ConcatenateItem

Vytvoří nový seznam obsahující dva pidly.

LPITEMIDLIST ConcatenateItem(
    LPCITEMIDLIST pidl1,
    LPCITEMIDLIST pidl2);

Parametry

pidl1
[v] První položka.

pidl2
[v] Druhá položka.

Vrácená hodnota

Ukazatel na nový seznam položek, pokud je funkce úspěšná, jinak NULL.

Poznámky

Tato metoda vytvoří nový ITEMIDLIST dostatečně velký, aby obsahoval pidl1 i pidl2. Pak zkopíruje pidl1 a pidl2 do nového seznamu.

CShellManager::CopyItem

Zkopíruje seznam položek.

LPITEMIDLIST CopyItem(LPCITEMIDLIST pidlSource);

Parametry

pidlSource
[v] Původní seznam položek.

Vrácená hodnota

Ukazatel na nově vytvořený seznam položek v případě úspěchu; jinak NULL.

Poznámky

Nově vytvořený seznam položek má stejnou velikost jako seznam zdrojových položek.

CShellManager::CreateItem

Vytvoří nový PIDL.

LPITEMIDLIST CreateItem(UINT cbSize);

Parametry

CbSize
[v] Velikost seznamu položek.

Vrácená hodnota

Ukazatel na seznam vytvořených položek v případě úspěchu; jinak NULL.

CShellManager::CShellManager

CShellManager Vytvoří objekt.

CShellManager();

Poznámky

Ve většině případů nemusíte vytvářet CShellManager přímo. Ve výchozím nastavení rozhraní vytvoří jednu za vás. Chcete-li získat ukazatel na CShellManager, volání CWinAppEx::GetShellManager. Pokud vytvoříte CShellManager ručně, musíte ji inicializovat pomocí metody CWinAppEx::InitShellManager.

CShellManager::FreeItem

Odstraní seznam položek.

void FreeItem(LPITEMIDLIST pidl);

Parametry

pidl
[v] Seznam položek, který chcete odstranit.

CShellManager::GetItemCount

Vrátí počet položek v seznamu položek.

UINT GetItemCount(LPCITEMIDLIST pidl);

Parametry

pidl
[v] Ukazatel na seznam položek

Vrácená hodnota

Počet položek v seznamu položek

CShellManager::GetItemSize

Vrátí velikost seznamu položek.

UINT GetItemSize(LPCITEMIDLIST pidl);

Parametry

pidl
[v] Ukazatel na seznam položek

Vrácená hodnota

Velikost seznamu položek.

CShellManager::GetNextItem

Načte další položku z ukazatele na seznam identifikátorů položek (PIDL).

LPITEMIDLIST GetNextItem(LPCITEMIDLIST pidl);

Parametry

pidl
[v] Seznam položek, které se mají iterovat.

Vrácená hodnota

Ukazatel na další položku v seznamu.

Poznámky

Pokud v seznamu nejsou žádné další položky, vrátí tato metoda hodnotu NULL.

CShellManager::GetParentItem

Načte nadřazenou položku ukazatele na seznam identifikátorů položek (PIDL).

int GetParentItem(
    LPCITEMIDLIST lpidl,
    LPITEMIDLIST& lpidlParent);

Parametry

lpidl
[v] A PIDL, jehož nadřazený objekt se načte.

lpidlParent
[ven] Odkaz na PIDL, kde metoda uloží výsledek.

Vrácená hodnota

Úroveň nadřazeného PIDL.

Poznámky

Úroveň PIDL je relativní vzhledem k ploše. Desktop PIDL se považuje za úroveň 0.

CShellManager::ItemFromPath

Načte ukazatel na seznam identifikátorů položek (PIDL) z položky identifikované cestou řetězce.

HRESULT ItemFromPath(
    LPCTSTR lpszPath,
    LPITEMIDLIST& pidl);

Parametry

lpszPath
[v] Řetězec, který určuje cestu k položce.

pidl
[ven] Odkaz na PIDL. Metoda používá tento PIDL k uložení ukazatele na jeho návratovou hodnotu.

Vrácená hodnota

Vrátí chybu NOERROR, pokud je úspěšná; chybová hodnota definovaná ole.

Viz také

Graf hierarchie
Třídy