CMFCShellTreeCtrl Sınıfı

sınıfı, CMFCShellTreeCtrl Kabuk öğelerinin hiyerarşisini görüntüleyerek CTreeCtrl Sınıfı işlevselliğini genişletir.

Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.

Sözdizimi

class CMFCShellTreeCtrl : public CTreeCtrl

Üyeler

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMFCShellTreeCtrl::EnableShellContextMenu	Kısayol menüsünü etkinleştirir veya devre dışı bırakır.
CMFCShellTreeCtrl::GetFlags	IShellFolder::EnumObjects'e geçirilen bayrakların bir bileşimini döndürür.
CMFCShellTreeCtrl::GetItemPath	Bir öğenin yolunu alır.
CMFCShellTreeCtrl::GetRelatedList	Gezgin benzeri bir pencere oluşturmak için bu CMFCShellTreeCtrl nesneyle birlikte kullanılan CMFCShellListCtrl Sınıf nesnesine bir işaretçi döndürür.
CMFCShellTreeCtrl::OnChildNotify	Bu üye işlevi, bu pencere için geçerli olan bir bildirim iletisi aldığında bu pencerenin üst penceresi tarafından çağrılır. (Geçersiz Kılmalar CWnd::OnChildNotify.)
CMFCShellTreeCtrl::OnGetItemIcon
CMFCShellTreeCtrl::OnGetItemText
CMFCShellTreeCtrl::Refresh	Geçerli CMFCShellTreeCtrl nesneyi yeniler ve yeniden boyar.
CMFCShellTreeCtrl::SelectPath	Sağlanan PIDL veya dize yolunu temel alarak uygun ağaç denetim öğesini seçer.
CMFCShellTreeCtrl::SetFlags	Ağaç bağlamını filtrelemek için bayrakları ayarlar (tarafından IShellFolder::EnumObjectskullanılan bayraklara benzer).
CMFCShellTreeCtrl::SetRelatedList	Geçerli CMFCShellTreeCtrl nesne ile nesne arasında bir CMFCShellListCtrl ilişki ayarlar.

Açıklamalar

Bu sınıf, programınızın ağaçta CTreeCtrl Windows Kabuğu öğelerini içermesini sağlayarak sınıfını genişletir. Bu sınıf, eksiksiz bir Gezgin penceresi oluşturmak için bir CMFCShellListCtrl nesneyle ilişkilendirilebilir. Ardından, ağaçta bir öğe seçildiğinde ilişkili listede Windows Kabuğu öğelerinin listesi görüntülenir.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CTreeCtrl

CMFCShellTreeCtrl

Gereksinimler

Üst bilgi: afxshelltreeCtrl.h

Örnek

Aşağıdaki örnekte sınıfının bir nesnesinin nasıl oluşturulacağı gösterilmektedir CMFCShellTreeCtrl . Bu kod parçacığı Explorer örneğinin bir parçasıdır.

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

Kısayol menüsünü etkinleştirir.

void EnableShellContextMenu(BOOL bEnable = TRUE);

Parametreler

bEnable
[in] Kısayol menüsünün etkinleştirilip etkinleştirilmeymeyeceğini belirten boole değeri.

CMFCShellTreeCtrl::GetFlags

CMFCShellTreeCtrl Sınıfı nesnesi için ayarlanan bayrakları döndürür.

DWORD GetFlags() const;

Dönüş Değeri

Şu anda ayarlanmış bayrakların birleşimini belirten bir DWORD değeri.

Açıklamalar

içinde CMFCShellTreeCtrl ayarlanan bayraklar, nesne her yenilendiğinde IShellFolder::EnumObjects yöntemine gönderilir. CMFCShellTreeCtrl::SetFlags yöntemiyle bayrakları değiştirebilirsiniz.

CMFCShellTreeCtrl::GetItemPath

CMFCShellTreeCtrl Sınıfı nesnesindeki bir öğenin yolunu alır.

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

Parametreler

strPath
[out] Dize parametresine başvuru. yöntemi, öğenin yolunu bu parametreye yazar.

htreeItem
[in] yöntemi bu ağaç denetim öğesinin yolunu alır.

Dönüş Değeri

Başarılı olursa sıfır olmayan; 0 aksi takdirde.

Açıklamalar

Bu yöntem başarısız olursa strPath boş dizeyi içerir.

hTreeItem belirtmezseniz, bu yöntem seçili durumdaki öğenin dizesini almaya çalışır. Hiçbir öğe seçilmezse ve hTreeItem NULL ise, bu yöntem başarısız olur.

CMFCShellTreeCtrl::GetRelatedList

Bu CMFCShellTreeCtrl nesnesiyle ilişkilendirilmiş CMFCShellListCtrl Sınıfı nesnesine bir işaretçi döndürür.

CMFCShellListCtrl* GetRelatedList() const;

Dönüş Değeri

Bu ağaç denetim nesnesiyle ilişkili nesnenin işaretçisi CMFCShellListCtrl .

Açıklamalar

Nesneyi bir CMFCShellListCtrl nesneyle CMFCShellTreeCtrl birlikte kullanarak Gezgin benzeri bir pencere oluşturabilirsiniz. İki sınıfı ilişkilendirmek için CMFCShellTreeCtrl::SetRelatedList yöntemini kullanın. Bunlar ilişkilendirildikten sonra, çerçeve, seçim CMFCShellTreeCtrl değişikliklerinin olup olmadığını otomatik olarak güncelleştirirCMFCShellListCtrl.

CMFCShellTreeCtrl::OnChildNotify

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

Parametreler

[in] İleti
[in] wParam
[in] lParam
[in] pLResult

Dönüş Değeri

Açıklamalar

CMFCShellTreeCtrl::OnGetItemIcon

virtual int OnGetItemIcon(
    LPAFX_SHELLITEMINFO pItem,
    BOOL bSelected);

Parametreler

[in] pItem
[in] bSelected

Dönüş Değeri

Açıklamalar

CMFCShellTreeCtrl::OnGetItemText

virtual CString OnGetItemText(LPAFX_SHELLITEMINFO pItem);

Parametreler

[in] pItem

Dönüş Değeri

Açıklamalar

CMFCShellTreeCtrl::Refresh

CMFCShellTreeCtrl'yi yeniler ve yeniden boyar.

void Refresh();

Açıklamalar

içinde görüntülenen öğelerin hiyerarşisini yenilemek için bu yöntemi çağırın CMFCShellTreeCtrl.

CMFCShellTreeCtrl::SelectPath

Sağlanan yola göre CMFCShellTreeCtrl Sınıfında bir öğe seçer.

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

Parametreler

lpszPath
[in] Bir öğenin yolunu belirten dize.

lpidl
[in] Öğeyi belirten bir PIDL

Dönüş Değeri

Başarılı olursa S_OK; E_FAIL.

CMFCShellTreeCtrl::SetFlags

Ağaç bağlamını filtrelemek için bayrakları ayarlar.

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

Parametreler

dwFlags
[in] Ayarlanacağı bayraklar.

bRefresh
[in] öğesinin hemen yenilenip yenilenmeyeceğini CMFCShellTreeCtrl belirten bir Boole değeri.

Açıklamalar

tüm CMFCShellTreeCtrl ayar bayraklarını IShellFolder::EnumObjects'e geçirir. Farklı bayrakların değerleri hakkında daha fazla bilgi için bkz . IShellFolder::EnumObjects.

CMFCShellTreeCtrl::SetRelatedList

CMFCShellListCtrl nesnesini bir CMFCShellTreeCtrl nesnesiyle ilişkilendirir.

void SetRelatedList(CMFCShellListCtrl* pShellList);

Parametreler

pShellList
[in] Nesne işaretçisi CMFCShellListCtrl .

Açıklamalar

Bu yöntem bir CMFCShellListCtrl ile CMFCShellTreeCtrlilişkilendirir. Bu nesneler Gezgin benzeri bir pencere olarak görüntülenebilir: kullanıcı içinde CMFCShellTreeCtrlbir nesne seçerse içindeki ilişkili öğeler CMFCShellListCtrl otomatik olarak güncelleştirilir.

cmFCShellTreeCtrl::GetRelatedList yöntemini kullanarak ile CMFCShellTreeCtrlilişkili öğesini CMFCShellListCtrl alın.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CTreeCtrl Sınıfı
CMFCShellListCtrl Sınıfı