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
要件
Header: 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"
されている場合、エントリには file0
、 file1
などの名前が付けられます。
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
コンストラクターに渡されます)。
戻り値
FALSE 最近使用した (MRU) ファイル リストの指定したインデックスにファイル名がない場合。
解説
ファイルが現在のディレクトリにある場合、関数はディレクトリを表示から外します。 ファイル名が長すぎると、ディレクトリと拡張子が削除されます。 ファイル名が長すぎる場合は、 bAtLeastName が 0 以外でない限り、表示名は空の文字列に設定されます。
CRecentFileList::GetSize
MRU ファイル リスト内のファイルの数を取得します。
int GetSize() const;
戻り値
現在最近使用された (MRU) ファイル リスト内のファイルの数。
CRecentFileList::operator [ ]
オーバーロードされた添字 ([]
) 演算子は、nIndex の 0 から始まるインデックスで指定された 1 つのCString
を返します。
CString& operator[ ](int nindex);
パラメーター
nIndex
一連のCString
内の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();