CMFCShellListCtrl クラス

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

CMFCShellListCtrl クラスは、Windows リストコントロール機能を提供します。また、機能拡張されており、シェル項目の一覧表示機能を備えています。

class CMFCShellListCtrl : public CMFCListCtrl

メンバ

パブリックメソッド

名前	説明
CMFCShellListCtrl::DisplayFolder	指定されたフォルダに含まれている項目の一覧を表示します。
CMFCShellListCtrl::DisplayParentFolder	現在表示されているフォルダの親フォルダに含まれている項目の一覧を表示します。
CMFCShellListCtrl::EnableShellContextMenu	ショートカットメニューを有効または無効にします。
CMFCShellListCtrl::GetCurrentFolder	現在のフォルダのパスを取得します。
CMFCShellListCtrl::GetCurrentFolderName	現在のフォルダの名前を取得します。
CMFCShellListCtrl::GetCurrentItemIdList	現在のリストコントロール項目の PIDL を返します。
CMFCShellListCtrl::GetCurrentShellFolder	現在のシェルフォルダへのポインタを返します。
CMFCShellListCtrl::GetItemPath	項目のパスのテキスト表現を返します。
CMFCShellListCtrl::GetItemTypes	リストコントロールによって表示されるシェル項目の種類を返します。
CMFCShellListCtrl::IsDesktop	現在選択されているフォルダがデスクトップフォルダかどうかを確認します。
CMFCShellListCtrl::OnCompareItems	フレームワークは、2 つの項目を比較するときにこのメソッドを呼び出します。(CMFCListCtrl::OnCompareItems をオーバーライドします。)
CMFCShellListCtrl::OnFormatFileDate	フレームワークがリストコントロールによって表示されるファイルの日付を取得するときに呼び出されます。
CMFCShellListCtrl::OnFormatFileSize	フレームワークがリストコントロールのファイルサイズを変換するときに呼び出されます。
CMFCShellListCtrl::OnGetItemIcon	フレームワークがリストコントロール項目のアイコンを取得するときに呼び出されます。
CMFCShellListCtrl::OnGetItemText	フレームワークがリストコントロール項目のテキストを変換するときに呼び出されます。
CMFCShellListCtrl::OnSetColumns	列の名前を設定するときにフレームワークによって呼び出されます。
CMFCShellListCtrl::Refresh	リストコントロールを更新して再描画します。
CMFCShellListCtrl::SetItemTypes	リストコントロールによって表示される項目の種類を設定します。

解説

CMFCShellListCtrl クラスは CMFCListCtrl クラスの機能を拡張して、プログラムで Windows シェル項目を一覧表示できるようにします。エクスプローラウィンドウの一覧表示のような表示形式が使用されます。

CMFCShellTreeCtrl オブジェクトを CMFCShellListCtrl オブジェクトと関連付けると、まさにエクスプローラのようなウィンドウを作成できます。この状態で CMFCShellTreeCtrl の項目を選択すると、CMFCShellListCtrl オブジェクトによって選択された項目の内容が一覧表示されます。

使用例

次の例は、CMFCShellListCtrl クラスのオブジェクトを作成する方法、および現在表示されているフォルダの親フォルダを表示する方法について説明しています。このコードスニペットは、「Explorer サンプル : MFC Windows エクスプローラアプリケーション」の一部です。

  CMFCShellListCtrl   m_wndList;


...


    CRect rectDummy (0, 0, 0, 0);
    // The this pointer points to CExplorerView class which extends the CView class.
    m_wndList.Create (WS_CHILD | WS_VISIBLE | LVS_REPORT, rectDummy, this, 1);


...


    m_wndList.DisplayParentFolder ();