CRecentFileList クラス

  • [アーティクル]

MRU ファイル リストのコントロールをサポートします。

構文

class CRecentFileList

メンバー

パブリック コンストラクター

名前 説明
CRecentFileList::CRecentFileList CRecentFileList オブジェクトを構築します。

パブリック メソッド

名前 説明
CRecentFileList::Add MRU ファイルの一覧にファイルを追加します。
CRecentFileList::GetDisplayName MRU ファイル名のメニュー表示の表示名を提供します。
CRecentFileList::GetSize MRU ファイル リスト内のファイルの数を取得します。
CRecentFileList::ReadList レジストリから MRU ファイルの一覧を読み取ります。INI ファイル。
CRecentFileList::Remove MRU ファイルリストからファイルを削除します。
CRecentFileList::UpdateMenu MRU ファイル一覧のメニュー表示を更新します。
CRecentFileList::WriteList レジストリから MRU ファイルの一覧を書き込みます。INI ファイル。

パブリック演算子

名前 説明
CRecentFileList::operator [ ] 指定した位置にある CString オブジェクトを返します。

解説

ファイルは、MRUファイルリストに追加または削除することができ、ファイルリストは、レジストリまたはに対して読み取りまたは書き込むことができます.INI ファイルと、MRU ファイルの一覧を表示するメニューを更新できます。

継承階層

CRecentFileList

必要条件

ヘッダー: afxadv.h

CRecentFileList::Add

最近使用した (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);

パラメーター

lpszPathName
リストに追加するパス名を指定します。

lpszAppID
アプリケーションのアプリケーション ユーザー モデル ID を指定します。

pItem
リストに追加するシェル項目へのポインターを指定します。

Plink
リストに追加するシェル リンクへのポインターを指定します。

pidl
最近の docs フォルダーに追加するシェル項目の IDLIST を指定します。

解説

ファイル名が MRU リストの先頭に追加されます。 ファイル名が MRU リストに既に存在する場合は、先頭に移動されます。

CRecentFileList::CRecentFileList

CRecentFileList オブジェクトを構築します。

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

パラメーター

nStart
MRU (最近使用した) ファイルリストのメニュー表示での番号付けのオフセット。

lpszSection
レジストリまたはアプリケーションのセクションの名前をポイントします。MRU ファイル リストが読み取りまたは書き込まれる INI ファイル。

lpszEntryFormat
レジストリまたはアプリケーションに格納されているエントリの名前に使用する書式指定文字列を指します。INI ファイル。

nSize
MRU ファイル リスト内のファイルの最大数。

nMaxDispLen
MRU ファイル リストのファイル名のメニュー表示に使用できる最大長 (文字数)。

解説

lpszEntryFormat が指す書式指定文字列には、各 MRU 項目のインデックスを置き換えるために使用される "%d" を含める必要があります。 たとえば、書式指定文字列の場合、"file%d"エントリには名前がfile1付file0けられます。

CRecentFileList::GetDisplayName

MRU リストのメニュー表示で使用するために、MRU ファイル リスト内のファイルの表示名を取得します。

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

パラメーター

Strname
名前が MRU ファイルのメニュー リストに表示されるファイルの完全パス。

Nindex
MRU ファイル リスト内のファイルの 0 から始まるインデックス。

lpszCurDir
現在のディレクトリを保持する文字列。

nCurDir
現在のディレクトリ文字列の長さ。

bAtLeastName
0 以外の場合は、(nMaxDispLen パラメーターとしてコンストラクターに渡される) 最大表示長を超えた場合でも、ファイルのベース名をCRecentFileList返す必要があることを示します。

戻り値

FAL Standard Edition最近使用した (MRU) ファイル リストの指定したインデックスにファイル名がない場合。

解説

ファイルが現在のディレクトリにある場合、関数はディレクトリを表示から外します。 ファイル名が長すぎると、ディレクトリと拡張子が削除されます。 ファイル名が長すぎる場合は、bAtLeastName が 0 以外の場合を除き、表示名は空の文字列に設定されます。

CRecentFileList::GetSize

MRU ファイル リスト内のファイルの数を取得します。

int GetSize() const;

戻り値

現在最近使用された (MRU) ファイル リスト内のファイルの数。

CRecentFileList::operator [ ]

オーバーロードされた添字 ([]) 演算子は、nIndex の 0 から始まるインデックスで指定された 1 つCStringを返します。

CString& operator[ ](int nindex);

パラメーター

Nindex
s のセットCString内の a CString の 0 から始まるインデックス。

CRecentFileList::ReadList

レジストリまたはアプリケーションから、最近使用した (MRU) ファイルの一覧を読み取ります。INI ファイル。

virtual void ReadList();

CRecentFileList::Remove

MRU ファイルリストからファイルを削除します。

virtual void Remove(int nIndex);

パラメーター

Nindex
最近使用した (MRU) ファイル リストから削除するファイルの 0 から始まるインデックス。

CRecentFileList::UpdateMenu

MRU ファイル一覧のメニュー表示を更新します。

virtual void UpdateMenu(CCmdUI* pCmdUI);

パラメーター

pCmdUI
最近使用した (MRU) ファイル リスト メニューの CCmdUI オブジェクトへのポインター。

CRecentFileList::WriteList

最近使用した (MRU) ファイルの一覧をレジストリまたはアプリケーションに書き込みます。INI ファイル。

virtual void WriteList();

関連項目

階層図