CRecentFileList-Klasse

Unterstützt die Verwendung der zuletzt verwendeten Dateiliste (MRU).

Syntax

class CRecentFileList

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Öffentliche Operatoren

Hinweise

Dateien können der MRU-Dateiliste hinzugefügt oder gelöscht werden, die Dateiliste kann aus der Registrierung oder in eine Datei gelesen oder geschrieben werden. INI-Datei und das Menü, in dem die MRU-Dateiliste angezeigt wird, kann aktualisiert werden.

Vererbungshierarchie

CRecentFileList

Anforderungen

Kopfzeile: afxadv.h

CRecentFileList::Add

Fügt der Zuletzt verwendeten Dateiliste (MRU) eine Datei hinzu.

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
Gibt den Pfadnamen an, der der Liste hinzugefügt werden soll.

lpszAppID
Gibt die Anwendungsbenutzermodell-ID für die Anwendung an.

pItem
Gibt einen Zeiger auf shell-Element an, der der Liste hinzugefügt werden soll.

Plink
Gibt einen Zeiger auf shell-Link an, der der Liste hinzugefügt werden soll.

pidl
Gibt die IDLIST für das Shellelement an, das dem Ordner "Zuletzt verwendete Dokumente" hinzugefügt werden soll.

Hinweise

Der Dateiname wird am Anfang der MRU-Liste hinzugefügt. Wenn der Dateiname bereits in der MRU-Liste vorhanden ist, wird er an den Anfang verschoben.

CRecentFileList::CRecentFileList

Erstellt ein CRecentFileList-Objekt.

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

Parameter

nStart
Offset für die Nummerierung in der Menüanzeige der MRU-Dateiliste (zuletzt verwendet).

lpszSection
Verweist auf den Namen des Abschnitts der Registrierung oder der Anwendung. INI-Datei, in der die MRU-Dateiliste gelesen und/oder geschrieben wird.

lpszEntryFormat
Verweist auf eine Formatzeichenfolge, die für die Namen der einträge verwendet werden soll, die in der Registrierung oder in der Anwendung gespeichert sind. INI-Datei.

nSize
Maximale Anzahl von Dateien in der MRU-Dateiliste.

nMaxDispLen
Maximale Länge in Zeichen, die für die Menüanzeige eines Dateinamens in der MRU-Dateiliste verfügbar sind.

Hinweise

Die formatzeichenfolge, auf die lpszEntryFormat verweist, sollte "%d" enthalten, die zum Ersetzen des Indexes jedes MRU-Elements verwendet wird. Wenn beispielsweise die Formatzeichenfolge lautet "file%d" , werden die Einträge benannt file0, file1usw.

CRecentFileList::GetDisplayName

Ruft einen Anzeigenamen für eine Datei in der MRU-Dateiliste für die Verwendung in der Menüanzeige der MRU-Liste ab.

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

Parameter

strName
Vollständiger Pfad der Datei, deren Name in der Menüliste der MRU-Dateien angezeigt werden soll.

nIndex
Nullbasierter Index der Datei in der MRU-Dateiliste.

lpszCurDir
Zeichenfolge, die das aktuelle Verzeichnis enthält.

nCurDir
Länge der aktuellen Verzeichniszeichenfolge.

bAtLeastName
Wenn nonzero, gibt an, dass der Basisname der Datei zurückgegeben werden soll, auch wenn sie die maximale Anzeigelänge überschreitet (wird als nMaxDispLen-Parameter an den CRecentFileList Konstruktor übergeben).

Rückgabewert

FALSE , wenn im angegebenen Index in der zuletzt verwendeten Dateiliste (MRU) kein Dateiname vorhanden ist.

Hinweise

Wenn sich die Datei im aktuellen Verzeichnis befindet, verlässt die Funktion das Verzeichnis aus der Anzeige. Wenn der Dateiname zu lang ist, werden das Verzeichnis und die Erweiterung entfernt. Wenn der Dateiname immer noch zu lang ist, wird der Anzeigename auf eine leere Zeichenfolge festgelegt, es sei denn , bAtLeastName ist nicht null.

CRecentFileList::GetSize

Ruft die Anzahl der Dateien in der MRU-Dateiliste ab.

int GetSize() const;

Rückgabewert

Die Anzahl der Dateien in der aktuellen zuletzt verwendeten Dateiliste (MRU).

CRecentFileList::operator [ ]

Der überladene Tiefstellungsoperator ([]) gibt einen einzelnen CString wert zurück, der durch den nullbasierten Index in nIndex angegeben wird.

CString& operator[ ](int nindex);

Parameter

nIndex
Nullbasierter Index eines CString in einer Gruppe von CStrings.

CRecentFileList::ReadList

Liest die zuletzt verwendete Dateiliste (MRU) aus der Registrierung oder der Anwendung. INI-Datei.

virtual void ReadList();

CRecentFileList::Remove

Entfernt eine Datei aus der MRU-Dateiliste.

virtual void Remove(int nIndex);

Parameter

nIndex
Nullbasierter Index der Datei, die aus der zuletzt verwendeten Dateiliste (MRU) entfernt werden soll.

CRecentFileList::UpdateMenu

Aktualisiert die Menüanzeige der MRU-Dateiliste.

virtual void UpdateMenu(CCmdUI* pCmdUI);

Parameter

pCmdUI
Ein Zeiger auf das CCmdUI-Objekt für das zuletzt verwendete Dateilistenmenü (MRU).

CRecentFileList::WriteList

Schreibt die zuletzt verwendete Dateiliste (MRU) in die Registrierung oder die Anwendung. INI-Datei.

virtual void WriteList();

Siehe auch

Hierarchiediagramm