Kelas CMFCShellListCtrl

Kelas ini CMFCShellListCtrl menyediakan fungsionalitas kontrol daftar Windows dan memperluasnya dengan menyertakan kemampuan untuk menampilkan daftar item shell.

Sintaks

class CMFCShellListCtrl : public CMFCListCtrl

Anggota

Metode Publik

Nama	Deskripsi
CMFCShellListCtrl::D isplayFolder	Menampilkan daftar item yang terkandung dalam folder yang disediakan.
CMFCShellListCtrl::D isplayParentFolder	Menampilkan daftar item yang terkandung dalam folder yang merupakan induk folder yang saat ini ditampilkan.
CMFCShellListCtrl::EnableShellContextMenu	Mengaktifkan atau menonaktifkan menu pintasan.
CMFCShellListCtrl::GetCurrentFolder	Mengambil jalur folder saat ini.
CMFCShellListCtrl::GetCurrentFolderName	Mengambil nama folder saat ini.
CMFCShellListCtrl::GetCurrentItemIdList	Mengembalikan PIDL dari item kontrol daftar saat ini.
CMFCShellListCtrl::GetCurrentShellFolder	Mengembalikan penunjuk ke folder Shell saat ini.
CMFCShellListCtrl::GetItemPath	Mengembalikan jalur tekstual item.
CMFCShellListCtrl::GetItemTypes	Mengembalikan tipe item Shell yang ditampilkan oleh kontrol daftar.
CMFCShellListCtrl::IsDesktop	Memeriksa apakah folder yang saat ini dipilih adalah folder desktop.
CMFCShellListCtrl::OnCompareItems	Kerangka kerja memanggil metode ini ketika membandingkan dua item. (Penimpaan CMFCListCtrl::OnCompareItems.)
CMFCShellListctrl::OnFormatFileDate	Dipanggil saat kerangka kerja mengambil tanggal file yang ditampilkan oleh kontrol daftar.
CMFCShellListctrl::OnFormatFileSize	Dipanggil saat kerangka kerja mengonversi ukuran file kontrol daftar.
CMFCShellListCtrl::OnGetItemIcon	Dipanggil saat kerangka kerja mengambil ikon item kontrol daftar.
CMFCShellListCtrl::OnGetItemText	Dipanggil saat kerangka kerja mengonversi teks item kontrol daftar.
CMFCShellListCtrl::OnSetColumns	Dipanggil oleh kerangka kerja saat mengatur nama kolom.
CMFCShellListCtrl::Refresh	Menyegarkan dan mengecat ulang kontrol daftar.
CMFCShellListCtrl::SetItemTypes	Menyetel tipe item yang ditampilkan oleh kontrol daftar.

Keterangan

Kelas memperluas CMFCShellListCtrl fungsionalitas Kelas CMFCListCtrl dengan mengaktifkan program Anda untuk mencantumkan item shell Windows. Format tampilan yang digunakan seperti tampilan daftar untuk jendela Explorer.

Objek CMFCShellTreeCtrl dapat dikaitkan dengan CMFCShellListCtrl objek untuk membuat jendela Explorer lengkap. Kemudian, memilih item di CMFCShellTreeCtrl akan menyebabkan CMFCShellListCtrl objek mencantumkan konten item yang dipilih.

Contoh

Contoh berikut menunjukkan cara membuat objek CMFCShellListCtrl kelas dan cara menampilkan folder induk folder yang saat ini ditampilkan. Cuplikan kode ini adalah bagian dari sampel 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();

Hierarki Warisan

CObject

CCmdTarget

CWnd

CListCtrl

CMFCListCtrl

CMFCShellListCtrl

Persyaratan

Header: afxshelllistCtrl.h

CMFCShellListCtrl::D isplayFolder

Menampilkan daftar item yang terkandung dalam folder yang disediakan.

virtual HRESULT DisplayFolder(LPCTSTR lpszPath);
virtual HRESULT DisplayFolder(LPAFX_SHELLITEMINFO lpItemInfo);

Parameter

lpszPath
[di] String yang berisi jalur folder.

lpItemInfo
[di] Penunjuk ke LPAFX_SHELLITEMINFO struktur yang menjelaskan folder yang akan ditampilkan.

Tampilkan Nilai

S_OK jika berhasil; E_FAIL sebaliknya.

CMFCShellListCtrl::D isplayParentFolder

Memperbarui objek CMFCShellListCtrl untuk menampilkan folder induk folder yang saat ini ditampilkan.

virtual HRESULT DisplayParentFolder();

Tampilkan Nilai

S_OK jika berhasil; E_FAIL sebaliknya.

CMFCShellListCtrl::EnableShellContextMenu

Mengaktifkan menu pintasan.

void EnableShellContextMenu(BOOL bEnable = TRUE);

Parameter

bEnable
[di] Boolean yang menentukan apakah kerangka kerja mengaktifkan menu pintasan.

CMFCShellListCtrl::GetCurrentFolder

Mengambil jalur folder yang saat ini dipilih di objek CMFCShellListCtrl .

BOOL GetCurrentFolder(CString& strPath) const;

Parameter

strPath
[out] Referensi ke parameter string tempat metode menulis jalur.

Tampilkan Nilai

Bukan nol jika berhasil; 0 jika tidak.

Keterangan

Metode ini gagal jika tidak ada folder yang dipilih di CMFCShellListCtrl.

CMFCShellListCtrl::GetCurrentFolderName

Mengambil nama folder yang saat ini dipilih di objek CMFCShellListCtrl .

BOOL GetCurrentFolderName(CString& strName) const;

Parameter

strName
[out] Referensi ke parameter string tempat metode menulis nama.

Tampilkan Nilai

Bukan nol jika berhasil; 0 jika tidak.

Keterangan

Metode ini gagal jika tidak ada folder yang dipilih di CMFCShellListCtrl.

CMFCShellListCtrl::GetCurrentItemIdList

Mengembalikan PIDL dari item yang saat ini dipilih.

LPITEMIDLIST GetCurrentItemIdList() const;

Tampilkan Nilai

PIDL dari item saat ini.

CMFCShellListCtrl::GetCurrentShellFolder

Mendapatkan penunjuk ke item yang saat ini dipilih di objek CMFCShellListCtrl .

const IShellFolder* GetCurrentShellFolder() const;

Tampilkan Nilai

Penunjuk ke Antarmuka IShellFolder untuk objek yang dipilih.

Keterangan

Metode ini mengembalikan NULL jika tidak ada objek yang saat ini dipilih.

CMFCShellListCtrl::GetItemPath

Mengambil jalur untuk item.

BOOL GetItemPath(
    CString& strPath,
    int iItem) const;

Parameter

strPath
[out] Referensi ke string yang menerima jalur.

iItem
[di] Indeks item daftar.

Tampilkan Nilai

TRUE jika berhasil; FALSE jika tidak.

Keterangan

Indeks yang disediakan oleh iItem didasarkan pada item yang saat ini ditampilkan oleh objek Kelas CMFCShellListCtrl.

CMFCShellListCtrl::GetItemTypes

Mengembalikan jenis item yang ditampilkan oleh objek CMFCShellListCtrl .

SHCONTF GetItemTypes() const;

Tampilkan Nilai

Nilai SHCONTF yang berisi jenis item yang tercantum dalam CMFCShellListCtrl.

Keterangan

Untuk mengatur jenis item yang CMFCShellListCtrltercantum dalam , panggil CMFCShellListCtrl::SetItemTypes.

CMFCShellListCtrl::IsDesktop

Menentukan apakah folder yang ditampilkan di objek CMFCShellListCtrl adalah folder desktop.

BOOL IsDesktop() const;

Tampilkan Nilai

TRUE jika folder yang ditampilkan adalah folder desktop; FALSE jika tidak.

CMFCShellListCtrl::OnCompareItems

Untuk detail selengkapnya, lihat kode sumber yang terletak di folder VC\atlmfc\src\mfc dari penginstalan Visual Studio Anda.

virtual int OnCompareItems(
    LPARAM lParam1,
    LPARAM lParam2,
    int iColumn);

Parameter

[di] lParam1
[di] lParam2
[di] iColumn

Tampilkan Nilai

Keterangan

CMFCShellListctrl::OnFormatFileDate

Kerangka kerja memanggil metode ini ketika harus mengonversi tanggal yang terkait dengan objek menjadi string.

virtual void OnFormatFileDate(
    const CTime& tmFile,
    CString& str);

Parameter

tmFile
[di] Tanggal yang terkait dengan file.

Str
[out] String yang berisi tanggal file yang diformat.

Keterangan

Saat objek Kelas CMFCShellListCtrl menampilkan tanggal yang terkait dengan file, objek harus mengonversi tanggal tersebut menjadi format string. Menggunakan metode ini untuk melakukan konversi tersebut CMFCShellListCtrl . Secara default, metode ini menggunakan lokal saat ini untuk memformat tanggal menjadi string.

CMFCShellListctrl::OnFormatFileSize

Kerangka kerja memanggil metode ini ketika mengonversi ukuran objek menjadi string.

virtual void OnFormatFileSize(
    long lFileSize,
    CString& str);

Parameter

lFileSize
[di] Ukuran file yang akan ditampilkan kerangka kerja.

Str
[out] String yang berisi ukuran file yang diformat.

Keterangan

Ketika objek Kelas CMFCShellListCtrl perlu menampilkan ukuran file, objek perlu mengonversi ukuran file menjadi format string. Menggunakan metode ini untuk melakukan konversi tersebut CMFCShellListCtrl . Secara default, metode ini mengonversi ukuran file dari byte menjadi kilobyte lalu menggunakan lokal saat ini untuk memformat ukuran menjadi string.

CMFCShellListCtrl::OnGetItemIcon

Kerangka kerja memanggil metode ini untuk mengambil ikon yang terkait dengan item daftar shell.

virtual int OnGetItemIcon(
    int iItem,
    LPAFX_SHELLITEMINFO pItem);

Parameter

iItem
[di] Indeks item.

pItem
[di] Parameter LPAFX_SHELLITEMINFO yang menjelaskan item.

Tampilkan Nilai

Indeks gambar ikon jika berhasil; -1 jika fungsi gagal.

Keterangan

Indeks gambar ikon didasarkan pada daftar gambar sistem.

Secara default, metode ini bergantung pada parameter pItem . Nilai iItem tidak digunakan dalam implementasi default. Anda dapat menggunakan iItem untuk menerapkan perilaku kustom.

CMFCShellListCtrl::OnGetItemText

Kerangka kerja memanggil metode ini ketika harus mengambil teks item shell.

virtual CString OnGetItemText(
    int iItem,
    int iColumn,
    LPAFX_SHELLITEMINFO pItem);

Parameter

iItem
[di] Indeks item.

iColumn
[di] Kolom yang diminati.

pItem
[di] Parameter LPAFX_SHELLITEMINFO yang menjelaskan item.

Tampilkan Nilai

Yang CString berisi teks yang terkait dengan item.

Keterangan

Setiap item dalam CMFCShellListCtrl objek mungkin memiliki teks dalam satu atau beberapa kolom. Ketika kerangka kerja memanggil metode ini, kerangka kerja menentukan kolom yang diminatinya. Jika Anda memanggil fungsi ini secara manual, Anda juga harus menentukan kolom yang Anda minati.

Secara default, metode ini bergantung pada parameter pItem untuk menentukan item mana yang akan diproses. Nilai iItem tidak digunakan dalam implementasi default.

CMFCShellListCtrl::OnSetColumns

Kerangka kerja memanggil metode ini ketika menetapkan nama kolom.

virtual void OnSetColumns();

Keterangan

Secara default, kerangka kerja membuat empat kolom dalam objek CMFCShellListCtrl . Nama kolom ini adalah Nama, Ukuran, Jenis, dan Dimodifikasi. Anda dapat mengambil alih metode ini untuk menyesuaikan jumlah kolom dan namanya.

CMFCShellListCtrl::Refresh

Menyegarkan dan mengecat ulang objek CMFCShellListCtrl .

virtual HRESULT Refresh();

Tampilkan Nilai

S_OK jika berhasil; jika tidak, nilai kesalahan.

Keterangan

Panggil metode ini untuk menyegarkan daftar item yang ditampilkan oleh CMFCShellListCtrl objek.

CMFCShellListCtrl::SetItemTypes

Mengatur jenis item yang tercantum dalam objek CMFCShellListCtrl .

void SetItemTypes(SHCONTF nTypes);

Parameter

nTypes
[di] Daftar tipe item yang didukung CMFCShellListCtrl objek.

Keterangan

Untuk informasi selengkapnya tentang daftar jenis item, lihat SHCONTF.

Lihat juga

Bagan Hierarki
Kelas
Kelas CMFCListctrl
Kelas CMFCShellTreeCtrl