Classe CMFCShellTreeCtrl

A CMFCShellTreeCtrl classe estende a funcionalidade da classe CTreeCtrl ao exibir uma hierarquia de itens do Shell.

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

Sintaxe

class CMFCShellTreeCtrl : public CTreeCtrl

Membros

Métodos Públicos

Observações

Esta classe estende a CTreeCtrl classe ao permitir que o seu programa inclua itens do Windows Shell na árvore. Esta classe pode ser associada a um CMFCShellListCtrl objeto para criar uma janela completa do Explorador. Depois, ao selecionar um item na árvore, será exibida uma lista de itens do Windows Shell na lista associada.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CTreeCtrl

CMFCShellTreeCtrl

Requerimentos

Cabeçalho: afxshelltreeCtrl.h

Example

O exemplo seguinte demonstra como criar um objeto da CMFCShellTreeCtrl classe. Este excerto de código faz parte do exemplo do Explorer.

CMFCShellTreeCtrl m_wndShellTree;

// const int idTree = 1
CRect rectDummy(0, 0, 0, 0);
const DWORD dwViewStyle = WS_CHILD | WS_VISIBLE | TVS_HASLINES |
                          TVS_LINESATROOT | TVS_HASBUTTONS;

// The this pointer points to CFolderBar class which extends the CDockablePane class
m_wndShellTree.Create(dwViewStyle, rectDummy, this, idTree);

CMFCShellTreeCtrl::EnableShellContextMenu

Ativa o menu de atalhos.

void EnableShellContextMenu(BOOL bEnable = TRUE);

Parâmetros

bEnable
[dentro] Um Booleano que especifica se deve ativar o menu de atalho.

CMFCShellTreeCtrl::GetFlags

Devolve as flags definidas para o objeto CMFCShellTreeCtrl Class .

DWORD GetFlags() const;

Valor de retorno

Um valor DWORD que especifica a combinação de flags atualmente definidos.

Observações

As flags definidas em são CMFCShellTreeCtrl enviadas para o método IShellFolder::EnumObjects sempre que o objeto é atualizado. Podes alterar as flags com o método CMFCShellTreeCtrl::SetFlags .

CMFCShellTreeCtrl::GetItemPath

Recupera o caminho de um item no objeto CMFCShellTreeCtrl Class .

BOOL GetItemPath(
    CString& strPath,
    HTREEITEM htreeItem = NULL) const;

Parâmetros

strPath
[fora] Uma referência a um parâmetro de string. O método escreve o caminho do item para este parâmetro.

htreeItem
[dentro] O método recupera o caminho para este item de controlo da árvore.

Valor de retorno

Não nulo se for bem-sucedido; 0 caso contrário.

Observações

Se este método falhar, strPath contém a cadeia vazia.

Se não especificar hTreeItem, este método tenta obter a string para o item atualmente selecionado. Se nenhum item for selecionado e hTreeItem for NULL, este método falha.

CMFCShellTreeCtrl::GetRelatedList

Devolve um ponteiro para o objeto CMFCShellListCtrl que está associado a este objeto CMFCShellTreeCtrl .

CMFCShellListCtrl* GetRelatedList() const;

Valor de retorno

Um apontador para o CMFCShellListCtrl objeto associado a este objeto de controlo da árvore.

Observações

Ao usar um CMFCShellListCtrl objeto juntamente com um CMFCShellTreeCtrl objeto, pode criar uma janela semelhante ao Explorer. Use o método CMFCShellTreeCtrl::SetRelatedList para associar as duas classes. Depois de estarem associados, o framework atualiza automaticamente o CMFCShellListCtrl se a seleção mudar CMFCShellTreeCtrl .

CMFCShellTreeCtrl::OnChildNotify

virtual BOOL OnChildNotify(
    UINT message,
    WPARAM wParam,
    LPARAM lParam,
    LRESULT* pLResult);

Parâmetros

[dentro] Mensagem
[dentro] wParam
[dentro] IParam
[dentro] pLResult

Valor de retorno

Observações

CMFCShellTreeCtrl::OnGetItemIcon

virtual int OnGetItemIcon(
    LPAFX_SHELLITEMINFO pItem,
    BOOL bSelected);

Parâmetros

[dentro] pItem
[dentro] bSelecionado

Valor de retorno

Observações

CMFCShellTreeCtrl::OnGetItemText

virtual CString OnGetItemText(LPAFX_SHELLITEMINFO pItem);

Parâmetros

[dentro] pItem

Valor de retorno

Observações

CMFCShellTreeCtrl::Refresh

Atualiza e repinta o CMFCShellTreeCtrl.

void Refresh();

Observações

Chame este método para atualizar a hierarquia dos itens apresentados no CMFCShellTreeCtrlarquivo .

CMFCShellTreeCtrl::SelectPath

Seleciona um item na Classe CMFCShellTreeCtrl com base no caminho fornecido.

BOOL SelectPath(LPCTSTR lpszPath);
BOOL SelectPath(LPCITEMIDLIST lpidl);

Parâmetros

lpszPath
[dentro] Uma cadeia que especifica o caminho de um item.

lpidl
[dentro] Um PIDL que especifica o item

Valor de retorno

S_OK se for bem-sucedido; E_FAIL caso contrário.

CMFCShellTreeCtrl::SetFlags

Define flags para filtrar o contexto da árvore.

void SetFlags(
    DWORD dwFlags,
    BOOL bRefresh = TRUE);

Parâmetros

dwBandeiras
[dentro] As bandeiras para colocar.

bRefresh
[dentro] Um Booleano que especifica se deve ser atualizado imediatamente CMFCShellTreeCtrl .

Observações

Passa CMFCShellTreeCtrl todas as flags de conjunto para IShellFolder::EnumObjects. Para mais informações sobre os valores de diferentes flags, veja IShellFolder::EnumObjects.

CMFCShellTreeCtrl::SetRelatedList

Associa um objeto CMFCShellListCtrl a um objeto CMFCShellTreeCtrl .

void SetRelatedList(CMFCShellListCtrl* pShellList);

Parâmetros

pShellList
[dentro] Um indicador para um CMFCShellListCtrl objeto.

Observações

Este método associa a CMFCShellListCtrl a um CMFCShellTreeCtrl. Estes objetos podem ser apresentados como uma janela semelhante ao Explorador: se o utilizador selecionar um objeto no CMFCShellTreeCtrl, os itens associados no CMFCShellListCtrl serão automaticamente atualizados.

Use o método CMFCShellTreeCtrl::GetRelatedList para recuperar o associado CMFCShellListCtrl a um CMFCShellTreeCtrl.

Consulte também

Gráfico de Hierarquia
Classes
Classe CTreeCtrl
Classe CMFCShellListCtrl