Share via

CWinAppEx-Klasse

  • Artikel

CWinAppEx behandelt den Anwendungszustand, speichert den Zustand in der Registrierung, lädt den Zustand aus der Registrierung, initialisiert Anwendungs-Manager und stellt Links zu diesen Anwendungs-Managern bereit.

Ausführliche Informationen finden Sie im Quellcode im Ordner mfc Ihrer Visual Studio-Installation. Beispiel: %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Syntax

class CWinAppEx : public CWinApp

Member

Öffentliche Konstruktoren

Name Beschreibung
CWinAppEx::CWinAppEx Erstellt ein CWinAppEx-Objekt.

Öffentliche Methoden

Name Beschreibung
CWinAppEx::CleanState Entfernt Informationen zur Anwendung aus der Windows-Registrierung
CWinAppEx::EnableLoadWindowPlacement Gibt an, ob die Anwendung die anfängliche Größe und Position des Hauptrahmenfensters aus der Registrierung lädt
CWinAppEx::EnableTearOffMenus Aktiviert abtrennbare Menüs für die Anwendung
CWinAppEx::EnableUserTools Ermöglicht dem Benutzer das Erstellen benutzerdefinierter Menübefehle in der Anwendung
CWinAppEx::ExitInstance Wird vom Framework innerhalb der Run Memberfunktion aufgerufen, um diese Instanz der Anwendung zu beenden (Überschreibt CWinApp::ExitInstance.)
CWinAppEx::GetBinary Liest Binärdaten, die dem angegebenen Registrierungswert zugeordnet sind
CWinAppEx::GetContextMenuManager Gibt einen Zeiger auf das globale CContextMenuManager-Objekt zurück
CWinAppEx::GetDataVersion
CWinAppEx::GetDataVersionMajor Gibt die Hauptversion der Anwendung zurück, die in der Windows-Registrierung gespeichert ist
CWinAppEx::GetDataVersionMinor Gibt die Nebenversion der Anwendung zurück, die in der Windows-Registrierung gespeichert ist
CWinAppEx::GetInt Liest numerische Daten aus der Registrierung, die dem angegebenen Wert zugeordnet sind
CWinAppEx::GetKeyboardManager Gibt einen Zeiger auf das globale CKeyboardManager-Objekt zurück
CWinAppEx::GetMouseManager Gibt einen Zeiger auf das globale CMouseManager-Objekt zurück
CWinAppEx::GetObject Liest aus CObject abgeleitete Daten aus der Registrierung, die dem angegebenen Wert zugeordnet sind
CWinAppEx::GetRegSectionPath Gibt eine Zeichenfolge zurück, die der Pfad eines Registrierungsschlüssels ist. Dieser Pfad verkettet den angegebenen relativen Pfad mit dem Anwendungspfad.
CWinAppEx::GetRegistryBase Gibt den Registrierungspfad für die Anwendung zurück
CWinAppEx::GetSectionBinary Liest Binärdaten aus der Registrierung, die dem angegebenen Schlüssel und Wert zugeordnet sind
CWinAppEx::GetSectionInt Liest numerische Daten aus der Registrierung, die dem angegebenen Schlüssel und Wert zugeordnet sind
CWinAppEx::GetSectionObject Liest CObject-Daten aus der Registrierung, die dem angegebenen Schlüssel und Wert zugeordnet sind
CWinAppEx::GetSectionString Liest Zeichenfolgendaten aus der Registrierung, die dem angegebenen Schlüssel und Wert zugeordnet sind
CWinAppEx::GetShellManager Gibt einen Zeiger auf das globale CShellManager-Objekt zurück
CWinAppEx::GetString Liest Zeichenfolgendaten aus der Registrierung, die dem angegebenen Wert zugeordnet sind
CWinAppEx::GetTooltipManager Gibt einen Zeiger auf das globale CTooltipManager-Objekt zurück
CWinAppEx::GetUserToolsManager Gibt einen Zeiger auf das globale CUserToolsManager-Objekt zurück
CWinAppEx::InitContextMenuManager Initialisiert das CContextMenuManager-Objekt.
CWinAppEx::InitKeyboardManager Initialisiert das CKeyboardManager-Objekt.
CWinAppEx::InitMouseManager Initialisiert das CMouseManager-Objekt.
CWinAppEx::InitShellManager Initialisiert die CShellManager-Klasse
CWinAppEx::InitTooltipManager Initialisiert die CTooltipManager-Klasse
CWinAppEx::IsResourceSmartUpdate
CWinAppEx::IsStateExists Gibt an, ob sich der angegebene Schlüssel in der Registrierung befindet
CWinAppEx::LoadState Lädt den Anwendungszustand aus der Registrierung
CWinAppEx::OnAppContextHelp Wird vom Framework aufgerufen, wenn der Benutzer Kontexthilfe für das Dialogfeld Anpassung anfordert
CWinAppEx::OnViewDoubleClick Ruft den benutzerdefinierten Befehl auf, wenn der Benutzer an einer beliebigen Stelle in der Anwendung doppelklickt
CWinAppEx::OnWorkspaceIdle
CWinAppEx::SaveState Schreibt den Status des Anwendungsframeworks in die Windows-Registrierung
CWinAppEx::SetRegistryBase Legt den Pfad des Standardregistrierungsschlüssels fest. Dieser Schlüssel dient als Stamm für alle nachfolgenden Registrierungsaufrufe.
CWinAppEx::ShowPopupMenu Zeigt ein Popupmenü an
CWinAppEx::WriteBinary Schreibt die Binärdaten in den angegebenen Registrierungswert
CWinAppEx::WriteInt Schreibt die numerischen Daten in den angegebenen Registrierungswert
CWinAppEx::WriteObject Schreibt Daten, die von der CObject-Klasse abgeleitet werden, in den angegebenen Registrierungswert
CWinAppEx::WriteSectionBinary Schreibt die Binärdaten in einen Wert des angegebenen Registrierungsschlüssels
CWinAppEx::WriteSectionInt Schreibt die numerischen Daten in einen Wert des angegebenen Registrierungsschlüssels
CWinAppEx::WriteSectionObject Schreibt Daten, die von der CObject-Klasse abgeleitet wurden, in einen Wert des angegebenen Registrierungsschlüssels
CWinAppEx::WriteSectionString Schreibt die Zeichenfolgendaten in einen Wert des angegebenen Registrierungsschlüssels
CWinAppEx::WriteString Schreibt die Zeichenfolgendaten in den angegebenen Registrierungswert

Geschützte Methoden

Name Beschreibung
CWinAppEx::LoadCustomState Wird vom Framework aufgerufen, wenn der Anwendungszustand geladen wurde
CWinAppEx::LoadWindowPlacement Wird vom Framework aufgerufen, wenn es die Größe und den Speicherort Ihrer Anwendung aus der Registrierung lädt. Die geladenen Daten enthalten die Größe und Position des Hauptrahmens zum Zeitpunkt, zu dem die Anwendung zuletzt geschlossen wurde.
CWinAppEx::OnClosingMainFrame Wird vom Framework aufgerufen, wenn ein Hauptrahmenfenster WM_CLOSE verarbeitet.
CWinAppEx::PreLoadState Wird vom Framework unmittelbar vor dem Laden des Anwendungszustands aufgerufen
CWinAppEx::PreSaveState Wird vom Framework unmittelbar vor dem Speichern des Anwendungszustands aufgerufen
CWinAppEx::ReloadWindowPlacement Lädt die Größe und die Position des angegebenen Fensters aus der Registrierung neu
CWinAppEx::SaveCustomState Wird vom Framework aufgerufen, nachdem es den Anwendungszustand in die Registrierung geschrieben hat
CWinAppEx::StoreWindowPlacement Wird vom Framework aufgerufen, um die Größe und Position des Hauptrahmens in die Registrierung zu schreiben

Datenelemente

Name Beschreibung
CWinAppEx::m_bForceImageReset Gibt an, ob das Framework alle Symbolleistenbilder zurücksetzt, wenn das Rahmenfenster, das die Symbolleiste enthält, geladen wird

Hinweise

Ein Großteil der vom MFC-Framework bereitgestellten Funktionen hängt von der CWinAppEx-Klasse ab. Sie können die CWinAppEx-Klasse auf eine von zwei Arten in Ihre Anwendung integrieren:

  • Erstellen einer CWinAppEx-Klasse im Hauptthread

  • Ableiten der Hauptanwendungsklasse von CWinAppEx

Nachdem Sie CWinAppEx in Ihre Anwendung integriert haben, können Sie einen der Anwendungs-Manager initialisieren. Bevor Sie einen Anwendungs-Manager verwenden, müssen Sie ihn initialisieren, indem Sie die entsprechende Initialisierungsmethode aufrufen. Rufen Sie die zugeordnete get-Methode auf, um einen Zeiger auf einen bestimmten Manager abzurufen. Die CWinAppEx Klasse verwaltet die folgenden Anwendungs-Manager: CMouseManager-Klasse, CContextMenuManager-Klasse, CKeyboardManager-Klasse, CUserToolsManager-Klasse und CMenuTearOffManager-Klasse.

Vererbungshierarchie

CObject

CCmdTarget

CWinThread

CWinApp

CWinAppEx

Anforderungen

Headerafxwinappex.h:

CWinAppEx::CleanState

Entfernt alle Informationen zur Anwendung aus der Windows-Registrierung

virtual BOOL CleanState(LPCTSTR lpszSectionName=NULL);

Parameter

lpszSectionName
[Eingabe] Eine Zeichenfolge, die einen Pfad eines Registrierungsschlüssels enthält

Rückgabewert

Nicht 0, wenn die Methode erfolgreich ausgeführt wurde, andernfalls 0

Hinweise

Mit dieser Methode werden Anwendungsdaten aus einem bestimmten Abschnitt der Registrierung gelöscht. Sie können den zu löschenden Abschnitt mithilfe des Parameters lpszSectionName angeben. Wenn lpszSectionName den Wert NULL hat, verwendet diese Methode den im CWinAppEx-Objekt gespeicherten Standardregistrierungspfad. Verwenden Sie zum Abrufen des Standardregistrierungspfads CWinAppEx::GetRegistryBase.

CWinAppEx::CWinAppEx

Erstellt ein CWinAppEx-Objekt.

CWinAppEx(BOOL bResourceSmartUpdate = FALSE);

Parameter

bResourceSmartUpdate
[Eingabe] Ein boolescher Parameter, der angibt, ob das Arbeitsbereichsobjekt Ressourcenaktualisierungen erkennen und verarbeiten soll

Hinweise

Die CWinAppEx-Klasse verfügt über Initialisierungsmethoden, bietet Funktionen zum Speichern und Laden von Anwendungsinformationen in die Registrierung und steuert globale Anwendungseinstellungen. Außerdem ermöglicht sie es Ihnen, globale Manager wie die CKeyboardManager-Klasse und die CUserToolsManager-Klasse zu verwenden. Jede Anwendung kann nur eine Instanz der CWinAppEx-Klasse haben.

CWinAppEx::EnableLoadWindowPlacement

Gibt an, ob die Anwendung die anfängliche Größe und Position des Hauptrahmenfensters aus der Registrierung lädt

void EnableLoadWindowPlacement(BOOL bEnable = TRUE);

Parameter

bEnable
[Eingabe] Gibt an, ob die Anwendung die anfängliche Größe und Position des Hauptrahmenfensters aus der Registrierung lädt

Hinweise

Standardmäßig werden die Größe und Position des Hauptrahmens zusammen mit anderen Anwendungseinstellungen aus der Registrierung geladen. Das geschieht während CWinAppEx::LoadState. Wenn Sie die anfängliche Fensterposition nicht aus der Registrierung laden möchten, rufen Sie diese Methode auf, wobei bEnable auf FALSE festgelegt sein soll.

CWinAppEx::EnableTearOffMenus

Erstellt und initialisiert ein CMenuTearOffManager-Objekt

BOOL EnableTearOffMenus(
    LPCTSTR lpszRegEntry,
    const UINT uiCmdFirst,
    const UINT uiCmdLast);

Parameter

lpszRegEntry
[Eingabe] Eine Zeichenfolge, die den Pfad eines Registrierungsschlüssels enthält Die Anwendung verwendet diesen Registrierungsschlüssel, um Informationen für die abtrennbaren Menüs zu speichern.

uiCmdFirst
[Eingabe] Die ID des ersten abtrennbaren Menüs

uiCmdLast
[Eingabe] Die ID des letzten abtrennbaren Menüs

Rückgabewert

TRUE, wenn CMenuTearOffManager erstellt und erfolgreich initialisiert wird, und FALSE, wenn ein Fehler auftritt oder CMenuTearOffManager bereits vorhanden ist

Hinweise

Verwenden Sie diese Funktion, um abtrennbare Menüs in Ihrer Anwendung zu aktivieren. Sie sollten diese Funktion über InitInstance aufrufen.

CWinAppEx::EnableUserTools

Ermöglicht es dem Benutzer, benutzerdefinierte Menübefehle zu erstellen, mit denen Tastenanschläge in Ihrer Anwendung reduziert werden. Diese Methode erstellt ein CUserToolsManager-Objekt.

BOOL EnableUserTools(
    const UINT uiCmdToolsDummy,
    const UINT uiCmdFirst,
    const UINT uiCmdLast,
    CRuntimeClass* pToolRTC = RUNTIME_CLASS(CUserTool),
    UINT uArgMenuID = 0,
    UINT uInitDirMenuID = 0);

Parameter

uiCmdToolsDummy
[Eingabe] Eine ganze Zahl ohne Vorzeichen, die das Framework als Platzhalter für die Befehls-ID des Menüs „Benutzertools“ verwendet

uiCmdFirst
[Eingabe] Die Befehls-ID für den ersten Benutzertoolbefehl

uiCmdLast
[Eingabe] Die Befehls-ID für den letzten Benutzertoolbefehl

pToolRTC
[Eingabe] Eine Klasse, die das CUserToolsManager-Objekt zum Erstellen neuer Benutzertools verwendet

uArgMenuID
[Eingabe] Die Menü-ID des Arguments

uInitDirMenuID
[Eingabe] Die Menü-ID für das anfängliche Toolverzeichnis

Rückgabewert

TRUE, wenn die Methode ein CUserToolsManager-Objekt erstellt und initialisiert, und FALSE, wenn die Methode fehlschlägt oder ein CUserToolsManager-Objekt bereits vorhanden ist

Hinweise

Wenn Sie benutzerdefinierte Tools aktivieren, unterstützt das Framework automatisch ein dynamisches Menü, das während der Anpassung erweitert werden kann. Das Framework ordnet jedes neue Element einem externen Befehl zu. Das Framework ruft diese Befehle auf, wenn der Benutzer das entsprechende Element aus dem Menü Extras auswählt.

Jedes Mal, wenn der Benutzer ein neues Element hinzufügt, erstellt das Framework ein neues Objekt. Der Klassentyp für das neue Objekt wird durch pToolRTC definiert. Der pToolRTC-Klassentyp muss von der CUserTool-Klasse abgeleitet werden.

Weitere Informationen zu Benutzertools und deren Integration in Ihre Anwendung finden Sie unter Benutzerdefinierte Tools.

CWinAppEx::ExitInstance

virtual int ExitInstance();

Rückgabewert

Bemerkungen

CWinAppEx::GetBinary

Liest Binärdaten aus einem angegebenen Registrierungsschlüssel

BOOL GetBinary(
    LPCTSTR lpszEntry,
    LPBYTE* ppData,
    UINT* pBytes);

Parameter

lpszEntry
[Eingabe] Eine Zeichenfolge, die den Namen eines Registrierungsschlüssels enthält

ppData
[Ausgabe] Ein Zeiger auf den Puffer, den die Methode mit den Binärdaten auffüllt

pBytes
[Ausgabe] Ein Zeiger auf eine ganze Zahl ohne Vorzeichen, die von der Methode zum Schreiben der Anzahl der gelesenen Bytes verwendet wird

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE

Hinweise

Diese Methode liest Binärdaten, die in die Registrierung geschrieben wurden. Verwenden Sie zum Schreiben von Daten in die Registrierung die Methoden CWinAppEx::WriteBinary und CWinAppEx::WriteSectionBinary.

Der Parameter lpszEntry ist der Name eines Registrierungseintrags, der sich unter dem Standardregistrierungsschlüssel für Ihre Anwendung befindet. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

CWinAppEx::GetContextMenuManager

Gibt einen Zeiger auf das globale CContextMenuManager-Objekt zurück

CContextMenuManager* GetContextMenuManager();

Rückgabewert

Ein Zeiger auf das globale CContextMenuManager-Objekt

Hinweise

Wenn das CContextMenuManager-Objekt nicht initialisiert wird, ruft diese Funktion CWinAppEx::InitContextMenuManager auf, bevor sie einen Zeiger zurückgibt.

CWinAppEx::GetDataVersion

int GetDataVersion() const;

Rückgabewert

Bemerkungen

CWinAppEx::GetDataVersionMajor

Gibt die Hauptversion der Anwendung zurück, die in der Windows-Registrierung gespeichert ist, wenn Sie CWinAppEx::SaveState aufrufen.

int GetDataVersionMajor() const;

Rückgabewert

Ein ganzzahliger Wert, der die Hauptversionsnummer enthält

CWinAppEx::GetDataVersionMinor

Gibt die Nebenversion der Anwendung zurück, die in der Windows-Registrierung gespeichert ist, wenn Sie CWinAppEx::SaveState aufrufen.

int GetDataVersionMinor() const;

Rückgabewert

Ein ganzzahliger Wert, der die Nebenversionsnummer enthält

CWinAppEx::GetInt

Liest ganzzahlige Daten aus einem angegebenen Registrierungsschlüssel

int GetInt(
    LPCTSTR lpszEntry,
    int nDefault = 0);

Parameter

lpszEntry
[Eingabe] Eine Zeichenfolge, die den Namen eines Registrierungseintrags enthält

nDefault
[Eingabe] Der Standardwert, den die Methode zurückgibt, wenn der angegebene Registrierungseintrag nicht vorhanden ist

Rückgabewert

Die Registrierungsdaten, wenn die Methode erfolgreich war, andernfalls nDefault

Hinweise

Diese Methode liest ganzzahlige Daten aus der Registrierung. Wenn dem Registrierungsschlüssel keine ganzzahligen Daten zugeordnet sind, die durch lpszEntry angegeben sind, gibt diese Methode nDefault zurück. Verwenden Sie zum Schreiben von Daten in die Registrierung die Methoden CWinAppEx::WriteSectionInt und CWinAppEx::WriteInt.

Der Parameter lpszEntry ist der Name eines Registrierungseintrags, der sich unter dem Standardregistrierungsschlüssel für Ihre Anwendung befindet. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

CWinAppEx::GetKeyboardManager

Gibt einen Zeiger auf das globale CKeyboardManager-Objekt zurück

CKeyboardManager* GetKeyboardManager();

Rückgabewert

Ein Zeiger auf das globale CKeyboardManager-Objekt

Hinweise

Wenn der Tastatur-Manager nicht initialisiert wird, ruft diese Funktion CWinAppEx::InitKeyboardManager auf, bevor sie einen Zeiger zurückgibt.

CWinAppEx::GetMouseManager

Gibt einen Zeiger auf das globale CMouseManager-Objekt zurück

CMouseManager* GetMouseManager();

Rückgabewert

Ein Zeiger auf das globale CMouseManager-Objekt

Hinweise

Wenn der Maus-Manager nicht initialisiert wird, ruft diese Funktion CWinAppEx::InitMouseManager auf, bevor sie einen Zeiger zurückgibt.

CWinAppEx::GetObject

Liest von CObject abgeleitete Daten aus der Registrierung

BOOL GetObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Parameter

lpszEntry
[Eingabe] Eine Zeichenfolge, die den relativen Pfad eines Registrierungseintrags enthält

obj
[Ausgabe] Ein Verweis auf ein CObject-Objekt Die Methode verwendet diesen Verweis, um die Registrierungsdaten zu speichern.

Rückgabewert

Nicht 0, wenn die Methode erfolgreich ausgeführt wurde, andernfalls 0

Hinweise

Diese Methode liest Daten aus der Registrierung, die von CObject abgeleitet werden. Wenn Sie CObject-Daten in die Registrierung schreiben möchten, verwenden Sie entweder CWinAppEx::WriteObject oder CWinAppEx::WriteSectionObject.

Der Parameter lpszEntry ist der Name eines Registrierungseintrags, der sich unter dem Standardregistrierungsschlüssel für Ihre Anwendung befindet. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

CWinAppEx::GetRegistryBase

Ruft den Standardregistrierungspfad für die Anwendung ab

LPCTSTR GetRegistryBase();

Rückgabewert

Eine Zeichenfolge, die den Pfad des Standardregistrierungsspeicherorts enthält

Hinweise

Alle Methoden der CWinAppEx-Klasse, die auf die Registrierung zugreifen, beginnen an einem Standardspeicherort. Verwenden Sie diese Methode, um einen Pfad des Standardregistrierungsspeicherorts abzurufen. Verwenden Sie CWinAppEx::SetRegistryBase, um den Standardregistrierungsspeicherort zu ändern.

CWinAppEx::GetRegSectionPath

Erstellt und gibt den absoluten Pfad eines Registrierungsschlüssels zurück

CString GetRegSectionPath(LPCTSTR szSectionAdd = _T(""));

Parameter

szSectionAdd
[Eingabe] Eine Zeichenfolge, die den relativen Pfad eines Registrierungsschlüssels enthält

Rückgabewert

Ein CString-Objekt, das den absoluten Pfad eines Registrierungsschlüssels enthält

Hinweise

Diese Methode definiert den absoluten Pfad des Registrierungsschlüssels, indem der relative Pfad in szSectionAdd an den Standardregistrierungsspeicherort für Ihre Anwendung angefügt wird. Verwenden Sie zum Abrufen des Standardregistrierungsschlüssels die Methode CWinAppEx::GetRegistryBase.

CWinAppEx::GetSectionBinary

Liest Binärdaten aus der Registrierung

BOOL GetSectionBinary(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPBYTE* ppData,
    UINT* pBytes);

Parameter

lpszSubSection
[Eingabe] Eine Zeichenfolge, die den relativen Pfad eines Registrierungsschlüssels enthält

lpszEntry
[Eingabe] Eine Zeichenfolge, die den zu lesenden Wert enthält

ppData
[Ausgabe] Ein Zeiger auf den Puffer, in dem die Methode die Daten speichert

pBytes
[Ausgabe] Ein Zeiger auf eine ganze Zahl ohne Vorzeichen Die Methode schreibt die Größe von ppData in diesen Parameter.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

Diese Methode liest Binärdaten, die mithilfe der Methoden CWinAppEx::WriteBinary und CWinAppEx::WriteSectionBinary in die Registrierung geschrieben werden.

Der lpszSubSection-Parameter ist kein absoluter Pfad für einen Registrierungseintrag. Es handelt sich um einen relativen Pfad, der am Ende des Standardregistrierungsschlüssels für Ihre Anwendung angefügt wird. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

CWinAppEx::GetSectionInt

Liest ganzzahlige Daten aus der Registrierung

int GetSectionInt(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    int nDefault = 0);

Parameter

lpszSubSection
[Eingabe] Eine Zeichenfolge, die den relativen Pfad eines Registrierungsschlüssels enthält

lpszEntry
[Eingabe] Eine Zeichenfolge, die den zu lesenden Wert enthält

nDefault
[Eingabe] Der Standardwert, der zurückgegeben werden soll, wenn der angegebene Wert nicht vorhanden ist

Rückgabewert

Die ganzzahligen Daten, die im angegebenen Registrierungswert gespeichert sind, oder nDefault, wenn die Daten nicht vorhanden sind

Hinweise

Verwenden Sie die Methoden CWinAppEx::WriteInt und CWinAppEx::WriteSectionInt, um ganzzahlige Daten in die Registrierung zu schreiben.

Der lpszSubSection-Parameter ist kein absoluter Pfad eines Registrierungseintrags. Es handelt sich um einen relativen Pfad, der am Ende des Standardregistrierungsschlüssels für Ihre Anwendung hinzugefügt wird. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

CWinAppEx::GetSectionObject

Liest CObject-Registrierungsdaten aus der Registrierung

BOOL GetSectionObject(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    CObject& obj);

Parameter

lpszSubSection
[Eingabe] Eine Zeichenfolge, die den relativen Pfad eines Registrierungsschlüssels enthält

lpszEntry
[Eingabe] Eine Zeichenfolge, die den zu lesenden Wert enthält

obj
[Ausgabe] Ein Verweis auf ein CObject-Objekt Die Methode verwendet dieses CObject-Objekt, um die Registrierungsdaten zu speichern.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Diese Methode liest Daten aus der Registrierung. Die gelesenen Daten sind CObject-Daten oder Daten für eine von CObject abgeleitete Klasse. Wenn Sie CObject-Daten in die Registrierung schreiben möchten, verwenden Sie entweder CWinAppEx::WriteObject oder CWinAppEx::WriteSectionObject.

Der lpszSubSection-Parameter ist kein absoluter Pfad für einen Registrierungseintrag. Es handelt sich um einen relativen Pfad, der am Ende des Standardregistrierungsschlüssels für Ihre Anwendung angefügt wird. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

CWinAppEx::GetSectionString

Liest Zeichenfolgendaten aus der Registrierung

CString GetSectionString(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPCTSTR lpszDefault = _T(""));

Parameter

lpszSubSection
[Eingabe] Eine Zeichenfolge, die den relativen Pfad eines Registrierungsschlüssels enthält

lpszEntry
[Eingabe] Eine Zeichenfolge, die den zu lesenden Wert enthält

lpszDefault
[Eingabe] Der Standardwert, der zurückgegeben werden soll, wenn der angegebene Wert nicht vorhanden ist

Rückgabewert

Die Zeichenfolgendaten, die im angegebenen Registrierungswert gespeichert sind, oder lpszDefault, wenn die Daten nicht vorhanden sind

Hinweise

Diese Methode liest Zeichenfolgendaten, die in die Registrierung geschrieben wurden. Verwenden Sie CWinAppEx::WriteString und CWinAppEx::WriteSectionString, um Zeichenfolgendaten in die Registrierung zu schreiben.

Der lpszSubSection-Parameter ist kein absoluter Pfad für einen Registrierungseintrag. Es handelt sich um einen relativen Pfad, der am Ende des Standardregistrierungsschlüssels für Ihre Anwendung angefügt wird. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

CWinAppEx::GetShellManager

Gibt einen Zeiger auf das globale CShellManager-Objekt zurück

CShellManager* GetShellManager();

Rückgabewert

Ein Zeiger auf das globale CShellManager-Objekt

Hinweise

Wenn das CShellManager-Objekt nicht initialisiert wird, ruft diese Funktion CWinAppEx::InitShellManager auf, bevor sie einen Zeiger zurückgibt.

CWinAppEx::GetString

Liest Zeichenfolgendaten aus einem angegebenen Registrierungsschlüssel

CString GetString(
    LPCTSTR lpszEntry,
    LPCTSTR lpzDefault= _T(""));

Parameter

lpszEntry
[Eingabe] Eine Zeichenfolge, die den Namen eines Registrierungsschlüssels enthält

lpzDefault
[Eingabe] Der Standardwert, den die Methode zurückgibt, wenn der angegebene Registrierungseintrag nicht vorhanden ist

Rückgabewert

Die in der Registrierung gespeicherten Zeichenfolgendaten, falls erfolgreich, andernfalls lpszDefault

Hinweise

Diese Methode liest Zeichenfolgendaten, die in die Registrierung geschrieben wurden. Verwenden Sie zum Schreiben von Daten in die Registrierung die Methoden CWinAppEx::WriteString oder CWinAppEx::WriteSectionString.

Der Parameter lpszEntry ist der Name eines Registrierungseintrags, der sich unter dem Standardregistrierungsschlüssel für Ihre Anwendung befindet. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

CWinAppEx::GetTooltipManager

Gibt einen Zeiger auf das globale CTooltipManager-Objekt zurück

CTooltipManager* GetTooltipManager();

Rückgabewert

Ein Zeiger auf das globale CTooltipManager-Objekt

Hinweise

Wenn das CTooltipManager-Objekt nicht initialisiert wird, ruft diese Funktion CWinAppEx::InitTooltipManager auf, bevor sie einen Zeiger zurückgibt.

CWinAppEx::GetUserToolsManager

Gibt einen Zeiger auf das globale CUserToolsManager-Objekt zurück

CUserToolsManager* GetUserToolsManager();

Rückgabewert

Ein Zeiger auf das globale CUserToolsManager-Objekt oder NULL, wenn die Verwaltung von Benutzertools für die Anwendung nicht aktiviert ist

Hinweise

Bevor Sie einen Zeiger auf das CUserToolsManager-Objekt abrufen, müssen Sie den Manager initialisieren, indem Sie CWinAppEx::EnableUserTools aufrufen.

CWinAppEx::InitContextMenuManager

Initialisiert das CContextMenuManager-Objekt.

BOOL InitContextMenuManager();

Rückgabewert

Nicht 0, wenn die Methode das CContextMenuManager-Objekt erstellt, und 0, wenn das CContextMenuManager-Objekt bereits vorhanden ist

Hinweise

Wenn Sie CWinAppEx::GetContextMenuManager aufrufen, ruft die Standardimplementierung dieser Methode InitContextMenuManager auf.

Wenn Ihre Anwendung bereits über einen Kontextmenü-Manager verfügt und Sie InitContextMenuManager aufrufen, weist Ihre Anwendung einen ASSERT-Fehler auf. Daher sollten Sie InitContextMenuManager nicht aufrufen, wenn Sie ein CContextMenuManager-Objekt direkt erstellen. Wenn Sie kein benutzerdefiniertes CContextMenuManager-Objekt verwenden, sollten Sie GetContextMenuManager verwenden, um ein CContextMenuManager-Objekt zu erstellen.

CWinAppEx::InitKeyboardManager

Initialisiert das CKeyboardManager-Objekt.

BOOL InitKeyboardManager();

Rückgabewert

Nicht 0, wenn die Methode das CKeyboardManager-Objekt erstellt, und 0, wenn das CKeyboardManager-Objekt bereits vorhanden ist

Hinweise

Wenn Sie CWinAppEx::GetKeyboardManager aufrufen, ruft die Standardimplementierung dieser Methode InitKeyboardManager auf.

Wenn Ihre Anwendung bereits über einen Tastatur-Manager verfügt und Sie InitKeyboardManager aufrufen, weist Ihre Anwendung einen ASSERT-Fehler auf. Daher sollten Sie InitKeyboardManager nicht aufrufen, wenn Sie ein CKeyboardManager-Objekt direkt erstellen. Wenn Sie kein benutzerdefiniertes CKeyboardManager-Objekt verwenden, sollten Sie GetKeyboardManager verwenden, um ein CKeyboardManager-Objekt zu erstellen.

CWinAppEx::InitMouseManager

Initialisiert das CMouseManager-Objekt.

BOOL InitMouseManager();

Rückgabewert

Nicht 0, wenn die Methode das CMouseManager-Objekt erstellt, und 0, wenn das CMouseManager-Objekt bereits vorhanden ist

Hinweise

Wenn Sie CWinAppEx::GetMouseManager aufrufen, ruft die Standardimplementierung dieser Methode InitMouseManager auf.

Wenn Ihre Anwendung bereits über einen Maus-Manager verfügt und Sie InitMouseManager aufrufen, weist Ihre Anwendung einen ASSERT-Fehler auf. Daher sollten Sie InitMouseManager nicht aufrufen, wenn Sie ein CMouseManager-Objekt direkt erstellen. Wenn Sie kein benutzerdefiniertes CMouseManager-Objekt verwenden, sollten Sie GetMouseManager verwenden, um ein CMouseManager-Objekt zu erstellen.

CWinAppEx::InitShellManager

Initialisiert das CShellManager-Objekt.

BOOL InitShellManager();

Rückgabewert

Nicht 0, wenn die Methode das CShellManager-Objekt erstellt, und 0, wenn das CShellManager-Objekt bereits vorhanden ist

Hinweise

Wenn Sie CWinAppEx::GetShellManager aufrufen, ruft die Standardimplementierung dieser Methode InitShellManager auf.

Wenn Ihre Anwendung bereits über einen Shell-Manager verfügt und Sie InitShellManager aufrufen, löst Ihre Anwendung einen ASSERT-Fehler aus. Rufen Sie daher InitShellManager nicht auf, wenn Sie ein CShellManager-Objekt direkt erstellen. Wenn Sie kein benutzerdefiniertes CShellManager-Objekt verwenden, verwenden Sie GetShellManager, um ein CShellManager-Objekt zu erstellen.

CWinAppEx::InitTooltipManager

Initialisiert das CTooltipManager-Objekt.

BOOL InitTooltipManager();

Rückgabewert

Nicht 0, wenn die Methode das CTooltipManager-Objekt erstellt, und 0, wenn das CTooltipManager-Objekt bereits vorhanden ist

Hinweise

Wenn Sie CWinAppEx::GetTooltipManager aufrufen, ruft die Standardimplementierung dieser Methode InitTooltipManager auf.

Wenn Ihre Anwendung bereits über einen QuickInfo-Manager verfügt und Sie InitTooltipManager aufrufen, weist Ihre Anwendung einen ASSERT-Fehler auf. Daher sollten Sie InitTooltipManager nicht aufrufen, wenn Sie ein CTooltipManager-Objekt direkt erstellen. Wenn Sie kein benutzerdefiniertes CTooltipManager-Objekt verwenden, sollten Sie GetTooltipManager verwenden, um ein CTooltipManager-Objekt zu erstellen.

CWinAppEx::IsResourceSmartUpdate

BOOL IsResourceSmartUpdate() const;

Rückgabewert

Bemerkungen

CWinAppEx::IsStateExists

Gibt an, ob sich der angegebene Schlüssel in der Registrierung befindet

BOOL IsStateExists(LPCTSTR lpszSectionName);

Parameter

lpszSectionName
[Eingabe] Eine Zeichenfolge, die einen Pfad eines Registrierungsschlüssels enthält

Rückgabewert

Nicht 0, wenn sich der Schlüssel in der Registrierung befindet, andernfalls 0

CWinAppEx::LoadCustomState

Das Framework ruft diese Methode auf, nachdem es den Anwendungszustand aus der Registrierung geladen hat.

virtual void LoadCustomState();

Hinweise

Überschreiben Sie diese Methode, wenn Sie eine Verarbeitung durchführen möchten, nachdem die Anwendung den Status aus der Registrierung geladen hat. Standardmäßig hat diese Methode keine Auswirkungen.

Um benutzerdefinierte Statusinformationen aus der Registrierung zu laden, müssen die Informationen zuerst mithilfe von CWinAppEx::SaveCustomState gespeichert werden.

CWinAppEx::LoadState

Liest den Anwendungszustand aus der Windows-Registrierung

BOOL LoadState(
    CMDIFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL LoadState(
    CFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL LoadState(
    COleIPFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

virtual BOOL LoadState(
    LPCTSTR lpszSectionName = NULL,
    CFrameImpl* pFrameImpl = NULL);

Parameter

pFrame
[Eingabe] Ein Zeiger auf ein Rahmenfensterobjekt. Die Methode wendet die Statusinformationen in der Registrierung auf dieses Rahmenfenster an.

lpszSectionName
[Eingabe] Eine Zeichenfolge, die den relativen Pfad eines Registrierungsschlüssels enthält

pFrameImpl
[Eingabe] Ein Zeiger auf ein CFrameImpl-Objekt. Die Methode wendet die Statusinformationen in der Registrierung auf dieses Rahmenfenster an.

Rückgabewert

Nonzero bei erfolgreicher Ausführung; andernfalls 0.

Hinweise

Diese Methode lädt den Anwendungszustand und alle Statusinformationen für ein Rahmenfenster. Die geladenen Informationen für das Rahmenfenster werden auf das angegebene Rahmenfenster angewendet. Wenn Sie kein Rahmenfenster angeben, werden nur die Anwendungszustandinformationen geladen. Die Anwendungsinformationen umfassen den Zustand der CMouseManager-Klasse, CContextMenuManager-Klasse, CKeyboardManager-Klasse und CUserToolsManager-Klasse.

Die Standardimplementierung von CFrameImpl::OnLoadFrame ruft LoadState auf.

Der lpszSectionName-Parameter ist nicht der absolute Pfad für einen Registrierungseintrag. Es handelt sich um einen relativen Pfad, der am Ende des Standardregistrierungsschlüssels für Ihre Anwendung hinzugefügt wird. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

CWinAppEx::LoadWindowPlacement

Wird vom Framework aufgerufen, wenn es die Größe und Position des Hauptrahmenfensters aus der Registrierung lädt.

virtual BOOL LoadWindowPlacement(
    CRect& rectNormalPosition,
    int& nFlags,
    int& nShowCmd);

Parameter

rectNormalPosition
[Ausgabe] Ein Rechteck, das die Koordinaten des Hauptrahmenfensters enthält, wenn es sich in der wiederhergestellten Position befindet

nFlags
[Ausgabe] Flags, die die Position des minimierten Fensters steuern und wie das Betriebssystem zwischen einem minimierten Fenster und einem wiederhergestellten Fenster wechselt

nShowCmd
[Ausgabe] Eine ganze Zahl, die den Anzeigezustand des Fensters angibt. Weitere Informationen zu möglichen Werten finden Sie unter CWnd::ShowWindow.

Rückgabewert

Nonzero bei erfolgreicher Ausführung; andernfalls 0.

Hinweise

Standardmäßig lädt MFC beim Start der Anwendung automatisch die vorherige Position und den Status des Hauptrahmenfensters. Weitere Informationen dazu, wie diese Informationen in der Registrierung gespeichert werden, finden Sie unter CWinAppEx::StoreWindowPlacement.

Überschreiben Sie diese Methode, wenn Sie zusätzliche Informationen zum Hauptrahmenfenster laden möchten.

CWinAppEx::m_bForceImageReset

Gibt an, ob das Framework alle Symbolleistenbilder zurücksetzt, wenn es das Rahmenfenster neu lädt, das die Symbolleiste enthält

BOOL m_bForceImageReset;

Hinweise

Der m_bForceImageReset-Datenmember ist eine geschützte Variable.

CWinAppEx::OnAppContextHelp

Das Framework ruft diese Methode auf, wenn der Benutzer Kontexthilfe für das Dialogfeld Anpassung anfordert.

virtual void OnAppContextHelp(
    CWnd* pWndControl,
    const DWORD dwHelpIDArray[]);

Parameter

pWndControl
[Eingabe] Ein Zeiger auf ein Fensterobjekt, für das der Benutzer Kontexthilfe aufgerufen hat

dwHelpIDArray[]
[Eingabe] Ein reservierter Wert

Hinweise

Diese Methode ist derzeit für die zukünftige Verwendung reserviert. Die Standardimplementierung hat keine Funktion und wird derzeit nicht vom Framework aufgerufen.

CWinAppEx::OnClosingMainFrame

Das Framework ruft diese Methode auf, wenn ein Rahmenfenster WM_CLOSE verarbeitet.

virtual void OnClosingMainFrame(CFrameImpl* pFrameImpl);

Parameter

pFrameImpl
[Eingabe] Ein Zeiger auf ein CFrameImpl-Objekt

Hinweise

Die Standardimplementierung dieser Methode speichert den Status von pFrameImpl.

CWinAppEx::OnViewDoubleClick

Ruft den benutzerdefinierten Befehl auf, der einer Ansicht zugeordnet ist, wenn der Benutzer an einer beliebigen Stelle in dieser Ansicht doppelklickt

virtual BOOL OnViewDoubleClick(
    CWnd* pWnd,
    int iViewId);

Parameter

pWnd
[Eingabe] Ein Zeiger auf ein Objekt, das von der CView-Klasse abgeleitet wurde

iViewId
[Eingabe] Die Ansichts-ID

Rückgabewert

TRUE, wenn das Framework einen Befehl findet, andernfalls FALSE

Hinweise

Um benutzerdefiniertes Mausverhalten zu unterstützen, müssen Sie diese Funktion aufrufen, wenn Sie die WM_LBUTTONDBLCLK-Meldung verarbeiten. Diese Methode führt den Befehl aus, der der Ansichts-ID zugeordnet ist, die durch iViewId angegeben wird. Weitere Informationen zum benutzerdefinierten Mausverhalten finden Sie unter Tastatur- und Mausanpassung.

CWinAppEx::OnWorkspaceIdle

virtual BOOL OnWorkspaceIdle(CWnd*);

Parameter

[in] CWnd*\

Rückgabewert

Bemerkungen

CWinAppEx::PreLoadState

Das Framework ruft diese Methode unmittelbar auf, bevor sie den Anwendungszustand aus der Registrierung lädt.

virtual void PreLoadState();

Hinweise

Überschreiben Sie diese Methode, wenn Sie eine Verarbeitung unmittelbar ausführen möchten, bevor das Framework den Anwendungszustand lädt.

CWinAppEx::PreSaveState

Das Framework ruft diese Methode unmittelbar auf, bevor der Anwendungszustand gespeichert wird.

virtual void PreSaveState();

Hinweise

Überschreiben Sie diese Methode, wenn Sie eine Verarbeitung unmittelbar ausführen möchten, bevor das Framework den Anwendungszustand speichert.

CWinAppEx::ReloadWindowPlacement

Lädt die Größe und die Position eines Fensters aus der Registrierung neu

virtual BOOL ReloadWindowPlacement(CFrameWnd* pFrame);

Parameter

pFrame
[Eingabe] Ein Zeiger auf ein Rahmenfenster

Rückgabewert

Nicht 0, wenn die Methode erfolgreich war, und 0, wenn das Laden fehlgeschlagen ist oder keine Daten geladen werden müssen

Hinweise

Verwenden Sie die Funktion CWinAppEx::StoreWindowPlacement, um die Größe und die Position eines Fensters in die Registrierung zu schreiben

CWinAppEx::SaveCustomState

Das Framework ruft diese Methode auf, nachdem es den Anwendungszustand in der Registrierung gespeichert hat.

virtual void SaveCustomState();

Hinweise

Überschreiben Sie diese Methode, wenn Sie eine Verarbeitung durchführen möchten, nachdem die Anwendung den Status in der Registrierung gespeichert hat. Standardmäßig hat diese Methode keine Auswirkungen.

CWinAppEx::SaveState

Schreibt den Anwendungszustand in die Windows-Registrierung

virtual BOOL SaveState(
    LPCTSTR lpszSectionName = NULL,
    CFrameImpl* pFrameImpl = NULL);

BOOL SaveState(
    CMDIFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL SaveState(
    CFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL SaveState(
    COleIPFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

Parameter

lpszSectionName
[Eingabe] Eine Zeichenfolge, die den relativen Pfad eines Registrierungsschlüssels enthält

pFrameImpl
[Eingabe] Ein Zeiger auf ein CFrameImpl-Objekt Dieser Rahmen wird in der Windows-Registrierung gespeichert.

pFrame
[Eingabe] Ein Zeiger auf ein Rahmenfensterobjekt Dieser Rahmen wird in der Windows-Registrierung gespeichert.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE

Hinweise

Diese Methode speichert den Anwendungszustand und alle Statusinformationen für das angegebene Rahmenfenster. Wenn Sie kein Rahmenfenster angeben, speichert die Methode nur den Anwendungszustand. Die Anwendungsinformationen umfassen den Zustand der CMouseManager-Klasse, CContextMenuManager-Klasse, CKeyboardManager-Klasse und CUserToolsManager-Klasse.

Der lpszSectionName-Parameter ist nicht der absolute Pfad für einen Registrierungseintrag. Es handelt sich um einen relativen Pfad, der am Ende des Standardregistrierungsschlüssels für Ihre Anwendung angefügt wird. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

CWinAppEx::SetRegistryBase

Legt den Standardregistrierungspfad für die Anwendung fest

LPCTSTR SetRegistryBase(LPCTSTR lpszSectionName = NULL);

Parameter

lpszSectionName
[Eingabe] Eine Zeichenfolge, die den Pfad eines Registrierungsschlüssels enthält

Rückgabewert

Eine Zeichenfolge, die den Pfad des Standardregistrierungsspeicherorts enthält

Hinweise

Alle Methoden der CWinAppEx-Klasse, die auf die Registrierung zugreifen, beginnen an einem Standardspeicherort. Verwenden Sie diese Methode, um diesen Standardregistrierungsspeicherort zu ändern. Verwenden Sie CWinAppEx::GetRegistryBase, um den Standardregistrierungsspeicherort abzurufen.

CWinAppEx::ShowPopupMenu

Zeigt ein Popupmenü an

virtual BOOL ShowPopupMenu(
    UINT uiMenuResId,
    const CPoint& point,
    CWnd* pWnd);

Parameter

uiMenuResId
[Eingabe] Eine Menüressourcen-ID

point
[Eingabe] Ein CPoint-Objekt, das die Position des Menüs in Bildschirmkoordinaten angibt

pWnd
[Eingabe] Ein Zeiger auf das Fenster, das das Popupmenü besitzt

Rückgabewert

Nicht 0, wenn das Popupmenü erfolgreich angezeigt wird, andernfalls 0

Hinweise

Diese Methode zeigt das Menü an, das uiMenuResId zugeordnet ist.

Um Popupmenüs zu unterstützen, muss ein CContextMenuManager-Objekt vorhanden sein. Wenn Sie das CContextMenuManager-Objekt nicht initialisiert haben, schlägt ShowPopupMenu fehl.

CWinAppEx::StoreWindowPlacement

Wird vom Framework aufgerufen, um die Größe und Position des Hauptrahmenfensters in die Registrierung zu schreiben

virtual BOOL StoreWindowPlacement(
    const CRect& rectNormalPosition,
    int nFlags,
    int nShowCmd);

Parameter

nFlags
[Eingabe] Flags, die die Position des minimierten Fensters steuern und wie das Betriebssystem zwischen einem minimierten Fenster und einem wiederhergestellten Fenster wechselt

nShowCmd
[Eingabe] Eine ganze Zahl, die den Anzeigezustand des Fensters angibt. Weitere Informationen zu möglichen Werten finden Sie unter CWnd::ShowWindow.

rectNormalPosition
[Eingabe] Ein Rechteck, das die Koordinaten des Hauptrahmenfensters enthält, wenn es sich im wiederhergestellten Zustand befindet

Rückgabewert

Nonzero bei erfolgreicher Ausführung; andernfalls 0.

Hinweise

Standardmäßig speichert MFC automatisch die Position und den Zustand des Hauptrahmenfensters, bevor die Anwendung beendet wird. Diese Informationen werden in der Windows-Registrierung unter dem WindowPlacement-Schlüssel im Standardregistrierungsspeicherort für Ihre Anwendung gespeichert. Weitere Informationen zum Standardregistrierungsspeicherort Ihrer Anwendung finden Sie unter CWinAppEx::GetRegistryBase.

Überschreiben Sie diese Methode, wenn Sie zusätzliche Informationen zum Hauptrahmenfenster speichern möchten.

CWinAppEx::WriteBinary

Schreibt Binärdaten in die Registrierung

BOOL WriteBinary(
    LPCTSTR lpszEntry,
    LPBYTE pData,
    UINT nBytes);

Parameter

lpszEntry
[Eingabe] Eine Zeichenfolge, die den Namen eines Registrierungsschlüssels enthält

pData
[Eingabe] Die zu speichernden Daten

nBytes
[Eingabe] Die Größe von pData in Byte

Rückgabewert

TRUE, wenn diese Methode erfolgreich ausgeführt wurde, andernfalls FALSE

Hinweise

Der Parameter lpszEntry ist der Name eines Registrierungseintrags, der sich unter dem Standardregistrierungsschlüssel für Ihre Anwendung befindet. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

Wenn der durch lpszEntry angegebene Schlüssel nicht vorhanden ist, erstellt diese Methode ihn.

CWinAppEx::WriteInt

Schreibt numerische Daten in die Registrierung

BOOL WriteInt(
    LPCTSTR lpszEntry,
    int nValue);

Parameter

lpszEntry
[Eingabe] Eine Zeichenfolge, die den Namen eines Registrierungsschlüssels enthält

nValue
[Eingabe] Die zu speichernden Daten

Rückgabewert

TRUE, wenn diese Methode erfolgreich ausgeführt wurde, andernfalls FALSE

Hinweise

Der Parameter lpszEntry ist der Name eines Registrierungseintrags, der sich unter dem Standardregistrierungsschlüssel für Ihre Anwendung befindet. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

Wenn der durch lpszEntry angegebene Schlüssel nicht vorhanden ist, erstellt diese Methode ihn.

CWinAppEx::WriteObject

Schreibt Daten in die Registrierung, die von der CObject-Klasse abgeleitet wurden

BOOL WriteObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Parameter

lpszEntry
[Eingabe] Eine Zeichenfolge, die den festzulegenden Wert enthält

obj
[Eingabe] Ein Verweis auf CObject-Daten, die von der Methode gespeichert werden

Rückgabewert

TRUE, wenn diese Methode erfolgreich ausgeführt wurde, andernfalls FALSE

Hinweise

Diese Methode schreibt die obj-Daten in den angegebenen Wert unter dem Standardregistrierungsschlüssel. Verwenden Sie CWinAppEx::GetRegistryBase, um den aktuellen Registrierungsschlüssel zu ermitteln.

CWinAppEx::WriteSectionBinary

Schreibt Binärdaten in einen Wert in der Registrierung

BOOL WriteSectionBinary(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPBYTE pData,
    UINT nBytes);

Parameter

lpszSubSection
[Eingabe] Eine Zeichenfolge, die den Namen eines Registrierungsschlüssels enthält

lpszEntry
[Eingabe] Eine Zeichenfolge, die den festzulegenden Wert enthält

pData
[Eingabe] Die Daten, die in die Registrierung geschrieben werden sollen

nBytes
[Eingabe] Die Größe von pData in Byte

Rückgabewert

TRUE, wenn diese Methode erfolgreich ausgeführt wurde, andernfalls FALSE

Hinweise

Der lpszSubSection-Parameter ist nicht der absolute Pfad für einen Registrierungseintrag. Es handelt sich um einen relativen Pfad, der am Ende des Standardregistrierungsschlüssels für Ihre Anwendung angefügt wird. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

Wenn der durch lpszEntry angegebene Schlüssel nicht vorhanden ist, erstellt diese Methode ihn.

CWinAppEx::WriteSectionInt

Schreibt numerische Daten in die Registrierung

BOOL WriteSectionInt(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    int nValue);

Parameter

lpszSubSection
[Eingabe] Eine Zeichenfolge, die den relativen Pfad eines Registrierungsschlüssels enthält

lpszEntry
[Eingabe] Eine Zeichenfolge, die den festzulegenden Wert enthält

nValue
[Eingabe] Die Daten, die in die Registrierung geschrieben werden sollen

Rückgabewert

TRUE, wenn diese Methode erfolgreich ausgeführt wurde, andernfalls FALSE

Hinweise

Der lpszSubSection-Parameter ist kein absoluter Pfad für einen Registrierungseintrag. Es handelt sich um einen relativen Pfad, der an den Standardregistrierungsschlüssel für Ihre Anwendung angefügt wird. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

Wenn der durch lpszEntry angegebene Schlüssel nicht vorhanden ist, erstellt diese Methode ihn.

CWinAppEx::WriteSectionObject

Schreibt Daten, die von der CObject-Klasse abgeleitet wurden, in einen bestimmten Registrierungswert

BOOL WriteSectionObject(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    CObject& obj);

Parameter

lpszSubSection
[Eingabe] Eine Zeichenfolge, die den Namen eines Registrierungsschlüssels enthält

lpszEntry
[Eingabe] Eine Zeichenfolge, die den Namen des festzulegenden Werts enthält

obj
[Eingabe] Die zu speichernden Daten

Rückgabewert

TRUE, wenn diese Methode erfolgreich ausgeführt wurde, andernfalls FALSE

Hinweise

Der lpszSubSection-Parameter ist kein absoluter Pfad für einen Registrierungseintrag. Es handelt sich um einen relativen Pfad, der am Ende des Standardregistrierungsschlüssels für Ihre Anwendung angefügt wird. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

Wenn der durch lpszEntry angegebene Wert nicht unter dem durch lpszSubSection angegebenen Registrierungsschlüssel vorhanden ist, erstellt diese Methode diesen Wert.

CWinAppEx::WriteSectionString

Schreibt Zeichenfolgendaten in einen Wert in der Registrierung

BOOL WriteSectionString(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPCTSTR lpszValue);

Parameter

lpszSubSection
[Eingabe] Eine Zeichenfolge, die den Namen eines Registrierungsschlüssels enthält

lpszEntry
[Eingabe] Eine Zeichenfolge, die den festzulegenden Wert enthält

lpszValue
[Eingabe] Die Zeichenfolgendaten, die in die Registrierung geschrieben werden sollen

Rückgabewert

TRUE, wenn diese Methode erfolgreich ausgeführt wurde, andernfalls FALSE

Hinweise

Der lpszSubSection-Parameter ist kein absoluter Pfad für einen Registrierungseintrag. Es handelt sich um einen relativen Pfad, der am Ende des Standardregistrierungsschlüssels für Ihre Anwendung angefügt wird. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

Wenn der durch lpszEntry angegebene Wert unter lpszSubSection nicht vorhanden ist, wird er von dieser Methode erstellt.

CWinAppEx::WriteString

Schreibt Zeichenfolgendaten in die Registrierung

BOOL WriteString(
    LPCTSTR lpszEntry,
    LPCTSTR lpszValue);

Parameter

lpszEntry
[Eingabe] Eine Zeichenfolge, die den Namen eines Registrierungsschlüssels enthält

lpszValue
[Eingabe] Die zu speichernden Daten

Rückgabewert

TRUE, wenn diese Methode erfolgreich ausgeführt wurde, andernfalls FALSE

Hinweise

Der Parameter lpszEntry ist der Name eines Registrierungseintrags, der sich unter dem Standardregistrierungsschlüssel für Ihre Anwendung befindet. Verwenden Sie zum Abrufen oder Festlegen des Standardregistrierungsschlüssels die Methoden CWinAppEx::GetRegistryBase bzw. CWinAppEx::SetRegistryBase.

Wenn der durch lspzEntry angegebene Schlüssel nicht vorhanden ist, erstellt diese Methode ihn.

Weitere Informationen

Hierarchiediagramm
Klassen
CWinApp-Klasse
CMouseManager-Klasse
CContextMenuManager-Klasse
CKeyboardManager-Klasse
CUserToolsManager-Klasse