CMFCShellListCtrl クラス

[アーティクル]
02/21/2013

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 サンプルの一部です。

    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 ();