Bagikan melalui


Kelas CRecentFileList

Mendukung kontrol daftar file (MRU) yang terakhir digunakan.

Sintaks

class CRecentFileList

Anggota

Konstruktor Publik

Nama Deskripsi
CRecentFileList::CRecentFileList Membuat CRecentFileList objek.

Metode Publik

Nama Deskripsi
CRecentFileList::Add Menambahkan file ke daftar file MRU.
CRecentFileList::GetDisplayName Menyediakan nama tampilan untuk tampilan menu nama file MRU.
CRecentFileList::GetSize Mengambil jumlah file dalam daftar file MRU.
CRecentFileList::ReadList Membaca daftar file MRU dari registri atau . File INI.
CRecentFileList::Remove Menghapus file dari daftar file MRU.
CRecentFileList::UpdateMenu Memperbarui tampilan menu daftar file MRU.
CRecentFileList::WriteList Menulis daftar file MRU dari registri atau . File INI.

Operator Publik

Nama Deskripsi
CRecentFileList::operator [ ] Mengembalikan CString objek pada posisi tertentu.

Keterangan

File dapat ditambahkan atau dihapus dari daftar file MRU, daftar file dapat dibaca dari atau ditulis ke registri atau . File INI, dan menu yang menampilkan daftar file MRU dapat diperbarui.

Hierarki Warisan

CRecentFileList

Persyaratan

Header: afxadv.h

CRecentFileList::Add

Menambahkan file ke daftar file yang terakhir digunakan (MRU).

virtual void Add(LPCTSTR lpszPathName);

virtual void Add(
    LPCTSTR lpszPathName,
    LPCTSTR lpszAppID);

void Add(
    IShellItem* pItem,
    LPCTSTR lpszAppID);

void Add(
    IShellLink* pLink,
    LPCTSTR lpszAppID);

void Add(
    PIDLIST_ABSOLUTE pidl,
    LPCTSTR lpszAppID);

Parameter

lpszPathName
Menentukan nama jalur yang akan ditambahkan ke daftar.

lpszAppID
Menentukan ID Model Pengguna Aplikasi untuk aplikasi.

pItem
Menentukan penunjuk ke Item Shell yang akan ditambahkan ke daftar.

pLink
Menentukan penunjuk ke Tautan Shell untuk ditambahkan ke daftar.

pidl
Menentukan IDLIST untuk item shell yang harus ditambahkan ke folder dokumen terbaru.

Keterangan

Nama file akan ditambahkan ke bagian atas daftar MRU. Jika nama file sudah ada dalam daftar MRU, nama file akan dipindahkan ke bagian atas.

CRecentFileList::CRecentFileList

Membuat CRecentFileList objek.

CRecentFileList(
    UINT nStart,
    LPCTSTR lpszSection,
    LPCTSTR lpszEntryFormat,
    int nSize,
    int nMaxDispLen = AFX_ABBREV_FILENAME_LEN);

Parameter

nStart
Offset untuk penomoran di tampilan menu daftar file MRU (yang terakhir digunakan).

lpszSection
Menunjuk ke nama bagian registri atau aplikasi . File INI tempat daftar file MRU dibaca dan/atau ditulis.

lpszEntryFormat
Menunjuk ke string format yang akan digunakan untuk nama entri yang disimpan dalam registri atau aplikasi . File INI.

nSize
Jumlah maksimum file dalam daftar file MRU.

nMaxDispLen
Panjang maksimum, dalam karakter, tersedia untuk tampilan menu nama file di daftar file MRU.

Keterangan

String format yang diarahkan oleh lpszEntryFormat harus berisi "%d", yang akan digunakan untuk mengganti indeks setiap item MRU. Misalnya, jika string format adalah "file%d" maka entri akan diberi nama file0, , file1dan sebagainya.

CRecentFileList::GetDisplayName

Mendapatkan nama tampilan untuk file dalam daftar file MRU, untuk digunakan dalam tampilan menu daftar MRU.

virtual BOOL GetDisplayName(
    CString& strName,
    int nIndex,
    LPCTSTR lpszCurDir,
    int nCurDir,
    BOOL bAtLeastName = TRUE) const;

Parameter

strName
Jalur lengkap file yang namanya akan ditampilkan dalam daftar menu file MRU.

nIndex
Indeks file berbasis nol dalam daftar file MRU.

lpszCurDir
String yang memegang direktori saat ini.

nCurDir
Panjang string direktori saat ini.

bAtLeastName
Jika bukan nol, menunjukkan bahwa nama dasar file harus dikembalikan, bahkan jika melebihi panjang tampilan maksimum (diteruskan sebagai parameter nMaxDispLen ke CRecentFileList konstruktor).

Tampilkan Nilai

FALSE jika tidak ada nama file pada indeks yang ditentukan dalam daftar file yang terakhir digunakan (MRU).

Keterangan

Jika file berada di direktori saat ini, fungsi akan meninggalkan direktori dari tampilan. Jika nama file terlalu panjang, direktori dan ekstensi akan dilucuti. Jika nama file masih terlalu panjang, nama tampilan diatur ke string kosong kecuali bAtLeastName bukan nol.

CRecentFileList::GetSize

Mengambil jumlah file dalam daftar file MRU.

int GetSize() const;

Tampilkan Nilai

Jumlah file dalam daftar file yang terakhir digunakan (MRU) saat ini.

CRecentFileList::operator [ ]

Operator subskrip yang kelebihan beban ([]) mengembalikan satu CString yang ditentukan oleh indeks berbasis nol di nIndex.

CString& operator[ ](int nindex);

Parameter

nIndex
Indeks berbasis nol dalam CString satu set CString.

CRecentFileList::ReadList

Membaca daftar file yang terakhir digunakan (MRU) dari registri atau aplikasi . File INI.

virtual void ReadList();

CRecentFileList::Remove

Menghapus file dari daftar file MRU.

virtual void Remove(int nIndex);

Parameter

nIndex
Indeks berbasis nol dari file yang akan dihapus dari daftar file (MRU) yang terakhir digunakan.

CRecentFileList::UpdateMenu

Memperbarui tampilan menu daftar file MRU.

virtual void UpdateMenu(CCmdUI* pCmdUI);

Parameter

pCmdUI
Penunjuk ke objek CCmdUI untuk menu daftar file (MRU) yang terakhir digunakan.

CRecentFileList::WriteList

Menulis daftar file yang terakhir digunakan (MRU) ke dalam registri atau aplikasi . File INI.

virtual void WriteList();

Lihat juga

Bagan Hierarki