Klasa CWinAppEx

CWinAppEx obsługuje stan aplikacji, zapisuje stan w rejestrze, ładuje stan z rejestru, inicjuje menedżerów aplikacji i udostępnia linki do tych samych menedżerów aplikacji.

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w mfc folderze instalacji programu Visual Studio. Na przykład %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Składnia

class CWinAppEx : public CWinApp

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CWinAppEx::CWinAppEx	CWinAppEx Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CWinAppEx::CleanState	Usuwa informacje o aplikacji z rejestru systemu Windows.
CWinAppEx::EnableLoadWindowPlacement	Określa, czy aplikacja załaduje początkowy rozmiar i lokalizację głównego okna ramki z rejestru.
CWinAppEx::EnableTearOffMenus	Włącza menu odręcze dla aplikacji.
CWinAppEx::EnableUserTools	Umożliwia użytkownikowi tworzenie niestandardowych poleceń menu w aplikacji.
CWinAppEx::ExitInstance	Wywoływana przez platformę z poziomu funkcji składowej Run w celu zakończenia tego wystąpienia aplikacji. (Przesłania CWinApp::ExitInstance).
CWinAppEx::GetBinary	Odczytuje dane binarne skojarzone z określoną wartością rejestru.
CWinAppEx::GetContextMenuManager	Zwraca wskaźnik do obiektu globalnego CContextMenuManager .
CWinAppEx::GetDataVersion
CWinAppEx::GetDataVersionMajor	Zwraca wersję główną aplikacji zapisanej w rejestrze systemu Windows.
CWinAppEx::GetDataVersionMinor	Zwraca wersję pomocniczą aplikacji zapisanej w rejestrze systemu Windows.
CWinAppEx::GetInt	Odczytuje dane liczbowe skojarzone z określoną wartością z rejestru.
CWinAppEx::GetKeyboardManager	Zwraca wskaźnik do obiektu globalnego CKeyboardManager .
CWinAppEx::GetMouseManager	Zwraca wskaźnik do obiektu globalnego CMouseManager .
CWinAppEx::GetObject	Odczytuje CObjectdane pochodne skojarzone z określoną wartością z rejestru.
CWinAppEx::GetRegSectionPath	Zwraca ciąg, który jest ścieżką klucza rejestru. Ta ścieżka łączy podaną ścieżkę względną ze ścieżką aplikacji.
CWinAppEx::GetRegistryBase	Zwraca ścieżkę rejestru dla aplikacji.
CWinAppEx::GetSectionBinary	Odczytuje dane binarne skojarzone z określonym kluczem i wartością z rejestru.
CWinAppEx::GetSectionInt	Odczytuje dane liczbowe z rejestru skojarzonego z określonym kluczem i wartością.
CWinAppEx::GetSectionObject	Odczytuje CObject dane skojarzone z określonym kluczem i wartością z rejestru.
CWinAppEx::GetSectionString	Odczytuje dane ciągu skojarzone z określonym kluczem i wartością z rejestru.
CWinAppEx::GetShellManager	Zwraca wskaźnik do obiektu globalnego CShellManager .
CWinAppEx::GetString	Odczytuje dane ciągu skojarzone z określoną wartością z rejestru.
CWinAppEx::GetTooltipManager	Zwraca wskaźnik do obiektu globalnego CTooltipManager .
CWinAppEx::GetUserToolsManager	Zwraca wskaźnik do obiektu globalnego CUserToolsManager .
CWinAppEx::InitContextMenuManager	Inicjuje CContextMenuManager obiekt.
CWinAppEx::InitKeyboardManager	Inicjuje CKeyboardManager obiekt.
CWinAppEx::InitMouseManager	Inicjuje CMouseManager obiekt.
CWinAppEx::InitShellManager	Inicjuje klasę CShellManager
CWinAppEx::InitTooltipManager	Inicjuje klasę CTooltipManager .
CWinAppEx::IsResourceSmartUpdate
CWinAppEx::IsStateExists	Wskazuje, czy określony klucz znajduje się w rejestrze.
CWinAppEx::LoadState	Ładuje stan aplikacji z rejestru.
CWinAppEx::OnAppContextHelp	Wywoływana przez platformę, gdy użytkownik żąda pomocy kontekstowej w oknie dialogowym Dostosowywanie .
CWinAppEx::OnViewDoubleClick	Wywołuje polecenie zdefiniowane przez użytkownika, gdy użytkownik kliknie dwukrotnie w dowolnym miejscu w aplikacji.
CWinAppEx::OnWorkspaceIdle
CWinAppEx::SaveState	Zapisuje stan struktury aplikacji w rejestrze systemu Windows.
CWinAppEx::SetRegistryBase	Ustawia ścieżkę domyślnego klucza rejestru. Ten klucz będzie służyć jako katalog główny dla wszystkich kolejnych wywołań rejestru.
CWinAppEx::ShowPopupMenu	Wyświetla menu podręczne.
CWinAppEx::WriteBinary	Zapisuje dane binarne do określonej wartości rejestru.
CWinAppEx::WriteInt	Zapisuje dane liczbowe do określonej wartości rejestru.
CWinAppEx::WriteObject	Zapisuje dane pochodzące z CObject klasy do określonej wartości rejestru.
CWinAppEx::WriteSectionBinary	Zapisuje dane binarne na wartość określonego klucza rejestru.
CWinAppEx::WriteSectionInt	Zapisuje dane liczbowe w wartości określonego klucza rejestru.
CWinAppEx::WriteSectionObject	Zapisuje dane pochodzące z CObject klasy do wartości określonego klucza rejestru.
CWinAppEx::WriteSectionString	Zapisuje dane ciągu w wartości określonego klucza rejestru.
CWinAppEx::WriteString	Zapisuje dane ciągu do określonej wartości rejestru.

Metody chronione

Nazwa/nazwisko	opis
CWinAppEx::LoadCustomState	Wywoływana przez strukturę po załadowaniu stanu aplikacji.
CWinAppEx::LoadWindowPlacement	Wywoływana przez platformę podczas ładowania rozmiaru i lokalizacji aplikacji z rejestru. Załadowane dane obejmują rozmiar i lokalizację ramki głównej w momencie ostatniego zamknięcia aplikacji.
CWinAppEx::OnClosingMainFrame	Wywoływana przez platformę, gdy główne okno ramowe przetwarza WM_CLOSEelement .
CWinAppEx::PreLoadState	Wywoływana przez platformę bezpośrednio przed załadowaniem stanu aplikacji.
CWinAppEx::PreSaveState	Wywoływana przez platformę bezpośrednio przed zapisaniem stanu aplikacji.
CWinAppEx::ReloadWindowPlacement	Ponownie ładuje rozmiar i lokalizację dostarczonego okna z rejestru
CWinAppEx::SaveCustomState	Wywoływana przez platformę po zapisaniu stanu aplikacji w rejestrze.
CWinAppEx::StoreWindowPlacement	Wywoływana przez strukturę w celu zapisania rozmiaru i lokalizacji ramki głównej w rejestrze.

Składowe danych

Nazwa/nazwisko	opis
CWinAppEx::m_bForceImageReset	Określa, czy struktura zresetuje wszystkie obrazy paska narzędzi po załadowaniu okna ramowego zawierającego pasek narzędzi.

Uwagi

Wiele funkcji zapewnianych przez strukturę MFC zależy od CWinAppEx klasy. Klasę CWinAppEx można dołączyć do aplikacji na jeden z dwóch sposobów:

• Skonstruuj klasę CWinAppEx w głównym wątku.

• Utwórz główną klasę aplikacji z CWinAppExklasy .

Po włączeniu CWinAppEx do aplikacji można zainicjować dowolnego z menedżerów aplikacji. Przed użyciem menedżera aplikacji należy zainicjować go, wywołując odpowiednią metodę inicjowania. Aby uzyskać wskaźnik do określonego menedżera, wywołaj skojarzoną metodę get. Klasa CWinAppEx zarządza następującymi menedżerami aplikacji:CMouseManager Klasa, CContextMenuManager Klasa,CKeyboardManager Klasa, Klasa, CUserToolsManager Klasa i CMenuTearOffManager Klasa.

Hierarchia dziedziczenia

CObject

CCmdTarget

CWinThread

CWinApp

CWinAppEx

Wymagania

Nagłówek: afxwinappex.h

CWinAppEx::CleanState

Usuwa wszystkie informacje o aplikacji z rejestru systemu Windows.

virtual BOOL CleanState(LPCTSTR lpszSectionName=NULL);

Parametry

lpszSectionName
[in] Ciąg zawierający ścieżkę klucza rejestru.

Wartość zwracana

Nonzero, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie 0.

Uwagi

Ta metoda usuwa dane aplikacji z określonej sekcji rejestru. Możesz określić sekcję do wyczyszczenia przy użyciu parametru lpszSectionName. Jeśli lpszSectionName jest NULLto , ta metoda będzie używać domyślnej ścieżki rejestru przechowywanej CWinAppEx w obiekcie. Aby uzyskać domyślną ścieżkę rejestru, użyj CWinAppEx ::GetRegistryBase.

CWinAppEx::CWinAppEx

CWinAppEx Tworzy obiekt.

CWinAppEx(BOOL bResourceSmartUpdate = FALSE);

Parametry

bResourceSmartUpdate
[in] Parametr logiczny określający, czy obiekt obszaru roboczego powinien wykrywać i obsługiwać aktualizacje zasobów.

Uwagi

Klasa CWinAppEx ma metody inicjowania, udostępnia funkcje zapisywania i ładowania informacji o aplikacji do rejestru oraz kontroluje globalne ustawienia aplikacji. Umożliwia również korzystanie z menedżerów globalnych, takich jak CKeyboardManager Klasa i CUserToolsManager Klasa. Każda aplikacja może mieć tylko jedno wystąpienie CWinAppEx klasy.

CWinAppEx::EnableLoadWindowPlacement

Określa, czy aplikacja załaduje początkowy rozmiar i lokalizację głównego okna ramki z rejestru.

void EnableLoadWindowPlacement(BOOL bEnable = TRUE);

Parametry

bEnable
[in] Określa, czy aplikacja ładuje początkowy rozmiar i lokalizację głównego okna ramki z rejestru.

Uwagi

Domyślnie rozmiar i lokalizacja ramki głównej są ładowane z rejestru wraz z innymi ustawieniami aplikacji. Dzieje się tak podczas CWinAppEx::LoadState. Jeśli nie chcesz załadować początkowego umieszczania okna z rejestru, wywołaj tę metodę z ustawioną wartością bEnable FALSE.

CWinAppEx::EnableTearOffMenus

Tworzy i inicjuje CMenuTearOffManager obiekt.

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

Parametry

lpszRegEntry
[in] Ciąg zawierający ścieżkę klucza rejestru. Aplikacja używa tego klucza rejestru do przechowywania informacji dotyczących menu odrętywania.

uiCmdFirst
[in] Pierwszy identyfikator menu odrywania.

uiCmdLast
[in] Ostatni identyfikator menu odrywania.

Wartość zwracana

TRUE jeśli obiekt CMenuTearOffManager został utworzony i zainicjowany pomyślnie; FALSE jeśli wystąpi błąd lub czy CMenuTearOffManager już istnieje.

Uwagi

Ta funkcja służy do włączania menu odrętywania w aplikacji. Należy wywołać tę funkcję z .InitInstance

CWinAppEx::EnableUserTools

Umożliwia użytkownikowi tworzenie niestandardowych poleceń menu, które zmniejszają naciśnięcie w aplikacji. Ta metoda tworzy CUserToolsManager obiekt.

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

Parametry

uiCmdToolsDummy
[in] Niepodpisane liczby całkowite używane przez platformę jako symbol zastępczy dla identyfikatora polecenia menu narzędzi użytkownika.

uiCmdFirst
[in] Identyfikator polecenia dla pierwszego polecenia narzędzia użytkownika.

uiCmdLast
[in] Identyfikator polecenia ostatniego polecenia narzędzia użytkownika.

pToolRTC
[in] Klasa używana CUserToolsManager przez obiekt do tworzenia nowych narzędzi użytkownika.

uArgMenuID
[in] Identyfikator menu argumentu.

uInitDirMenuID
[in] Identyfikator menu początkowego katalogu narzędzi.

Wartość zwracana

TRUE jeśli metoda tworzy i inicjuje CUserToolsManager obiekt; FALSE jeśli metoda zakończy się niepowodzeniem CUserToolsManager lub jeśli obiekt już istnieje.

Uwagi

Po włączeniu narzędzi zdefiniowanych przez użytkownika platforma automatycznie obsługuje menu dynamiczne, które można rozszerzyć podczas dostosowywania. Struktura kojarzy każdy nowy element z zewnętrznym poleceniem. Platforma wywołuje te polecenia, gdy użytkownik wybierze odpowiedni element z menu Narzędzia .

Za każdym razem, gdy użytkownik dodaje nowy element, struktura tworzy nowy obiekt. Typ klasy dla nowego obiektu jest definiowany przez pToolRTCelement . Typ pToolRTC klasy musi pochodzić z CUserTool klasy.

Aby uzyskać więcej informacji na temat narzędzi użytkownika i sposobu ich uwzględnienia w aplikacji, zobacz Narzędzia zdefiniowane przez użytkownika.

CWinAppEx::ExitInstance

virtual int ExitInstance();

Wartość zwracana

Uwagi

CWinAppEx::GetBinary

Odczytuje dane binarne z określonego klucza rejestru.

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

Parametry

lpszEntry
[in] Ciąg zawierający nazwę klucza rejestru.

ppData
[out] Wskaźnik do buforu, który metoda wypełnia danymi binarnymi.

pBytes
[out] Wskaźnik do niepodpisanej liczby całkowitej używanej przez metodę do zapisu liczby odczytanych bajtów.

Wartość zwracana

TRUE w przypadku powodzenia; FALSE inaczej.

Uwagi

Ta metoda odczytuje dane binarne zapisane w rejestrze. Aby zapisać dane w rejestrze, użyj metod CWinAppEx::WriteBinary i CWinAppEx::WriteSectionBinary.

Parametr lpszEntry jest nazwą wpisu rejestru znajdującego się pod domyślnym kluczem rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

CWinAppEx::GetContextMenuManager

Zwraca wskaźnik do obiektu globalnego CContextMenuManager .

CContextMenuManager* GetContextMenuManager();

Wartość zwracana

Wskaźnik do obiektu globalnego CContextMenuManager .

Uwagi

CContextMenuManager Jeśli obiekt nie został zainicjowany, ta funkcja wywołuje CWinAppEx::InitContextMenuManager funkcję, zanim zwróci wskaźnik.

CWinAppEx::GetDataVersion

int GetDataVersion() const;

Wartość zwracana

Uwagi

CWinAppEx::GetDataVersionMajor

Zwraca wersję główną aplikacji zapisanej w rejestrze systemu Windows podczas wywoływania metody CWinAppEx::SaveState.

int GetDataVersionMajor() const;

Wartość zwracana

Wartość całkowita zawierająca numer wersji głównej.

CWinAppEx::GetDataVersionMinor

Zwraca pomocniczą wersję aplikacji, która jest zapisywana w rejestrze systemu Windows podczas wywoływania metody CWinAppEx::SaveState.

int GetDataVersionMinor() const;

Wartość zwracana

Wartość całkowita zawierająca numer wersji pomocniczej.

CWinAppEx::GetInt

Odczytuje dane całkowite z określonego klucza rejestru.

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

Parametry

lpszEntry
[in] Ciąg zawierający nazwę wpisu rejestru.

nDefault
[in] Wartość domyślna zwracana przez metodę, jeśli określony wpis rejestru nie istnieje.

Wartość zwracana

Dane rejestru, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie nDefault.

Uwagi

Ta metoda odczytuje dane całkowite z rejestru. Jeśli nie ma danych całkowitych skojarzonych z kluczem rejestru wskazanym przez lpszEntrymetodę , ta metoda zwraca wartość nDefault. Aby zapisać dane w rejestrze, użyj metod CWinAppEx::WriteSectionInt i CWinAppEx::WriteInt.

Parametr lpszEntry jest nazwą wpisu rejestru znajdującego się pod domyślnym kluczem rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

CWinAppEx::GetKeyboardManager

Zwraca wskaźnik do obiektu globalnego CKeyboardManager .

CKeyboardManager* GetKeyboardManager();

Wartość zwracana

Wskaźnik do obiektu globalnego CKeyboardManager .

Uwagi

Jeśli menedżer klawiatury nie jest zainicjowany, ta funkcja wywołuje CWinAppEx::InitKeyboardManager przed zwróceniem wskaźnika.

CWinAppEx::GetMouseManager

Zwraca wskaźnik do obiektu globalnego CMouseManager .

CMouseManager* GetMouseManager();

Wartość zwracana

Wskaźnik do obiektu globalnego CMouseManager .

Uwagi

Jeśli menedżer myszy nie jest inicjowany, ta funkcja wywołuje CWinAppEx::InitMouseManager przed zwróceniem wskaźnika.

CWinAppEx::GetObject

Odczytuje CObject-dervied danych z rejestru.

BOOL GetObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Parametry

lpszEntry
[in] Ciąg zawierający ścieżkę względną wpisu rejestru.

obj
[out] Odwołanie do .CObject Metoda używa tego odwołania do przechowywania danych rejestru.

Wartość zwracana

Nonzero, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie 0.

Uwagi

Ta metoda odczytuje dane z rejestru, który pochodzi z CObjectklasy . Aby zapisać CObject dane w rejestrze, użyj polecenia CWinAppEx::WriteObject lub CWinAppEx::WriteSectionObject.

Parametr lpszEntry jest nazwą wpisu rejestru, który znajduje się w domyślnym kluczu rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

CWinAppEx::GetRegistryBase

Pobiera domyślną ścieżkę rejestru dla aplikacji.

LPCTSTR GetRegistryBase();

Wartość zwracana

Ciąg zawierający ścieżkę domyślnej lokalizacji rejestru.

Uwagi

Wszystkie metody CWinAppEx klasy , które uzyskują dostęp do rejestru, są uruchamiane w domyślnej lokalizacji. Użyj tej metody, aby pobrać ścieżkę domyślnej lokalizacji rejestru. Użyj CWinAppEx::SetRegistryBase polecenia , aby zmienić domyślną lokalizację rejestru.

CWinAppEx::GetRegSectionPath

Tworzy i zwraca ścieżkę bezwzględną klucza rejestru.

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

Parametry

szSectionAdd
[in] Ciąg zawierający ścieżkę względną klucza rejestru.

Wartość zwracana

Element CString zawierający ścieżkę bezwzględną klucza rejestru.

Uwagi

Ta metoda definiuje ścieżkę bezwzględną klucza rejestru, dołączając ścieżkę względną do szSectionAdd domyślnej lokalizacji rejestru dla aplikacji. Aby uzyskać domyślny klucz rejestru, użyj metody CWinAppEx::GetRegistryBase.

CWinAppEx::GetSectionBinary

Odczytuje dane binarne z rejestru.

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

Parametry

lpszSubSection
[in] Ciąg zawierający ścieżkę względną klucza rejestru.

lpszEntry
[in] Ciąg zawierający wartość do odczytania.

ppData
[out] Wskaźnik do buforu, w którym metoda przechowuje dane.

pBytes
[out] Wskaźnik do niepodpisanej liczby całkowitej. Metoda zapisuje rozmiar do tego parametru ppData .

Wartość zwracana

TRUE w przypadku powodzenia; w przeciwnym razie FALSE.

Uwagi

Ta metoda odczytuje dane binarne zapisywane w rejestrze przy użyciu metod CWinAppEx::WriteBinary i CWinAppEx::WriteSectionBinary.

Parametr lpszSubSection nie jest ścieżką bezwzględną dla wpisu rejestru. Jest to ścieżka względna dołączana na końcu domyślnego klucza rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

CWinAppEx::GetSectionInt

Odczytuje dane całkowite z rejestru.

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

Parametry

lpszSubSection
[in] Ciąg zawierający ścieżkę względną klucza rejestru.

lpszEntry
[in] Ciąg zawierający wartość do odczytania.

nDefault
[in] Wartość domyślna, która ma być zwracana, jeśli określona wartość nie istnieje.

Wartość zwracana

Dane całkowite przechowywane w określonej wartości rejestru; nDefault jeśli dane nie istnieją.

Uwagi

Użyj metod CWinAppEx::WriteInt i CWinAppEx::WriteSectionInt , aby zapisać dane całkowite w rejestrze.

Parametr lpszSubSection nie jest ścieżką bezwzględną wpisu rejestru. Jest to ścieżka względna dodawana na końcu domyślnego klucza rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

CWinAppEx::GetSectionObject

Odczytuje CObject dane rejestru z rejestru.

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

Parametry

lpszSubSection
[in] Ciąg zawierający ścieżkę względną klucza rejestru.

lpszEntry
[in] Ciąg zawierający wartość do odczytania.

obj
[out] Odwołanie do .CObject Metoda używa tej CObject metody do przechowywania danych rejestru.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Ta metoda odczytuje dane z rejestru. Odczyt danych to CObject dane lub dane dla klasy pochodzącej z CObjectklasy . Aby zapisać CObject dane w rejestrze, użyj polecenia CWinAppEx::WriteObject lub CWinAppEx::WriteSectionObject.

Parametr lpszSubSection nie jest ścieżką bezwzględną dla wpisu rejestru. Jest to ścieżka względna dołączana na końcu domyślnego klucza rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

CWinAppEx::GetSectionString

Odczytuje dane ciągu z rejestru.

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

Parametry

lpszSubSection
[in] Ciąg zawierający ścieżkę względną klucza rejestru.

lpszEntry
[in] Ciąg zawierający wartość do odczytania.

lpszDefault
[in] Wartość domyślna, która ma być zwracana, jeśli określona wartość nie istnieje.

Wartość zwracana

Dane ciągu przechowywane w określonej wartości rejestru, jeśli dane istnieją; w przeciwnym razie lpszDefault.

Uwagi

Ta metoda odczytuje dane ciągów zapisane w rejestrze. Użyj funkcji CWinAppEx::WriteString i CWinAppEx::WriteSectionString , aby zapisać dane ciągu w rejestrze.

Parametr lpszSubSection nie jest ścieżką bezwzględną dla wpisu rejestru. Jest to ścieżka względna dołączana na końcu domyślnego klucza rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

CWinAppEx::GetShellManager

Zwraca wskaźnik do obiektu globalnego CShellManager .

CShellManager* GetShellManager();

Wartość zwracana

Wskaźnik do obiektu globalnego CShellManager .

Uwagi

CShellManager Jeśli obiekt nie został zainicjowany, ta funkcja wywołuje CWinAppEx::InitShellManager funkcję, zanim zwróci wskaźnik.

CWinAppEx::GetString

Odczytuje dane ciągu z określonego klucza rejestru.

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

Parametry

lpszEntry
[in] Ciąg zawierający nazwę klucza rejestru

lpzDefault
[in] Wartość domyślna zwracana przez metodę, jeśli określony wpis rejestru nie istnieje.

Wartość zwracana

Dane ciągu przechowywane w rejestrze, jeśli się powiedzie; lpszDefault inaczej.

Uwagi

Ta metoda odczytuje dane ciągów zapisane w rejestrze. Aby zapisać dane w rejestrze, użyj metod CWinAppEx::WriteString lub CWinAppEx::WriteSectionString.

Parametr lpszEntry jest nazwą wpisu rejestru znajdującego się pod domyślnym kluczem rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

CWinAppEx::GetTooltipManager

Zwraca wskaźnik do obiektu globalnego CTooltipManager .

CTooltipManager* GetTooltipManager();

Wartość zwracana

Wskaźnik do obiektu globalnego CTooltipManager .

Uwagi

CTooltipManager Jeśli obiekt nie został zainicjowany, ta funkcja wywołuje CWinAppEx::InitTooltipManager funkcję, zanim zwróci wskaźnik.

CWinAppEx::GetUserToolsManager

Zwraca wskaźnik do obiektu globalnego CUserToolsManager .

CUserToolsManager* GetUserToolsManager();

Wartość zwracana

Wskaźnik do obiektu globalnego CUserToolsManager ; NULL jeśli zarządzanie narzędziami użytkownika nie jest włączone dla aplikacji.

Uwagi

Przed pobraniem wskaźnika do CUserToolsManager obiektu należy zainicjować menedżera, wywołując metodę CWinAppEx::EnableUserTools.

CWinAppEx::InitContextMenuManager

Inicjuje CContextMenuManager obiekt.

BOOL InitContextMenuManager();

Wartość zwracana

Nonzero, jeśli metoda tworzy CContextMenuManager obiekt; 0, jeśli CContextMenuManager obiekt już istnieje.

Uwagi

Jeśli wywołasz CWinAppEx::GetContextMenuManagermetodę , domyślna implementacja tej metody wywołuje metodę InitContextMenuManager.

Jeśli aplikacja ma już menedżera menu kontekstowego i wywołujesz InitContextMenuManagermetodę ASSERT , aplikacja będzie miała błąd. W związku z tym nie należy wywoływać InitContextMenuManager obiektu bezpośrednio CContextMenuManager . Jeśli nie używasz niestandardowego CContextMenuManagerobiektu , należy go użyć GetContextMenuManager do utworzenia CContextMenuManager obiektu.

CWinAppEx::InitKeyboardManager

Inicjuje CKeyboardManager obiekt.

BOOL InitKeyboardManager();

Wartość zwracana

Nonzero, jeśli metoda tworzy CKeyboardManager obiekt; 0, jeśli CKeyboardManager obiekt już istnieje.

Uwagi

Jeśli wywołasz CWinAppEx::GetKeyboardManagermetodę , domyślna implementacja tej metody wywołuje metodę InitKeyboardManager.

Jeśli aplikacja ma już menedżera klawiatury i wywołujesz InitKeyboardManagermetodę ASSERT , aplikacja będzie miała błąd. W związku z tym nie należy wywoływać InitKeyboardManager obiektu bezpośrednio CKeyboardManager . Jeśli nie używasz niestandardowego CKeyboardManagerobiektu , należy go użyć GetKeyboardManager do utworzenia CKeyboardManager obiektu.

CWinAppEx::InitMouseManager

Inicjuje CMouseManager obiekt.

BOOL InitMouseManager();

Wartość zwracana

Nonzero, jeśli metoda tworzy CMouseManager obiekt; 0, jeśli CMouseManager obiekt już istnieje.

Uwagi

Jeśli wywołasz CWinAppEx::GetMouseManagermetodę , domyślna implementacja tej metody wywołuje metodę InitMouseManager.

Jeśli aplikacja ma już menedżera myszy i wywołujesz InitMouseManagermetodę , aplikacja będzie miała ASSERT błąd. W związku z tym nie należy wywoływać InitMouseManager obiektu CMouseManager bezpośrednio. Jeśli nie używasz niestandardowego CMouseManagerobiektu , należy go użyć GetMouseManager do utworzenia CMouseManager obiektu.

CWinAppEx::InitShellManager

Inicjuje CShellManager obiekt.

BOOL InitShellManager();

Wartość zwracana

Nonzero, jeśli metoda tworzy CShellManager obiekt; 0, jeśli CShellManager obiekt już istnieje.

Uwagi

Jeśli wywołasz CWinAppEx::GetShellManagermetodę , domyślna implementacja tej metody wywołuje metodę InitShellManager.

Jeśli aplikacja ma już menedżera powłoki i wywołujesz InitShellManagermetodę ASSERT , aplikacja zgłasza błąd. W związku z tym nie należy wywoływać InitShellManager obiektu CShellManager bezpośrednio. Jeśli nie używasz niestandardowego CShellManagerobiektu , użyj polecenia GetShellManager , aby utworzyć CShellManager obiekt.

CWinAppEx::InitTooltipManager

Inicjuje CTooltipManager obiekt.

BOOL InitTooltipManager();

Wartość zwracana

Nonzero, jeśli metoda tworzy CTooltipManager obiekt; 0, jeśli CTooltipManager obiekt już istnieje.

Uwagi

Jeśli wywołasz CWinAppEx::GetTooltipManagermetodę , domyślna implementacja tej metody wywołuje metodę InitTooltipManager.

Jeśli aplikacja ma już menedżera etykietek narzędzi i wywołujesz InitTooltipManagermetodę ASSERT , aplikacja będzie miała błąd. W związku z tym nie należy wywoływać InitTooltipManager obiektu bezpośrednio CTooltipManager . Jeśli nie używasz niestandardowego CTooltipManagerobiektu , należy go użyć GetTooltipManager do utworzenia CTooltipManager obiektu.

CWinAppEx::IsResourceSmartUpdate

BOOL IsResourceSmartUpdate() const;

Wartość zwracana

Uwagi

CWinAppEx::IsStateExists

Wskazuje, czy określony klucz znajduje się w rejestrze.

BOOL IsStateExists(LPCTSTR lpszSectionName);

Parametry

lpszSectionName
[in] Ciąg zawierający ścieżkę klucza rejestru.

Wartość zwracana

Nonzero, jeśli klucz znajduje się w rejestrze; w przeciwnym razie 0.

CWinAppEx::LoadCustomState

Struktura wywołuje tę metodę po załadowaniu stanu aplikacji z rejestru.

virtual void LoadCustomState();

Uwagi

Zastąpi tę metodę, jeśli chcesz wykonać jakiekolwiek przetwarzanie po załadowaniu stanu z rejestru przez aplikację. Domyślnie ta metoda nic nie robi.

Aby załadować niestandardowe informacje o stanie z rejestru, należy najpierw zapisać informacje przy użyciu polecenia CWinAppEx::SaveCustomState.

CWinAppEx::LoadState

Odczytuje stan aplikacji z rejestru systemu Windows.

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);

Parametry

pFrame
[in] Wskaźnik do obiektu okna ramki. Metoda stosuje informacje o stanie w rejestrze do tego okna ramki.

lpszSectionName
[in] Ciąg zawierający ścieżkę względną klucza rejestru.

pFrameImpl
[in] Wskaźnik do CFrameImpl obiektu. Metoda stosuje informacje o stanie w rejestrze do tego okna ramki.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; 0 w przeciwnym razie.

Uwagi

Ta metoda ładuje stan aplikacji i informacje o stanie okna ramki. Załadowane informacje dotyczące okna ramowego są stosowane do dostarczonego okna ramowego. Jeśli nie podasz okna ramki, zostaną załadowane tylko informacje o stanie aplikacji. Informacje o aplikacji obejmują stan CMouseManager klasy, CContextMenuManager klasy, CKeyboardManager klasy i CUserToolsManager klasy.

Domyślna implementacja wywołań CFrameImpl::OnLoadFrame LoadState.

Parametr lpszSectionName nie jest ścieżką bezwzględną dla wpisu rejestru. Jest to ścieżka względna dodawana na końcu domyślnego klucza rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

CWinAppEx::LoadWindowPlacement

Wywoływana przez platformę podczas ładowania rozmiaru i lokalizacji głównego okna ramki z rejestru.

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

Parametry

rectNormalPosition
[out] Prostokąt zawierający współrzędne okna głównego ramki, gdy znajduje się w przywróconej pozycji.

nFlags
[out] Flagi kontrolujące położenie zminimalizowanego okna i sposób przełączania systemu operacyjnego między zminimalizowanym oknem a przywróconym oknem.

nShowCmd
[out] Liczba całkowita określająca stan show okna. Aby uzyskać więcej informacji na temat możliwych wartości, zobacz CWnd::ShowWindow.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; 0 w przeciwnym razie.

Uwagi

Domyślnie MFC automatycznie ładuje poprzednią pozycję i stan okna ramki głównej po uruchomieniu aplikacji. Aby uzyskać więcej informacji na temat sposobu przechowywania tych informacji w rejestrze, zobacz CWinAppEx::StoreWindowPlacement.

Zastąpi tę metodę, jeśli chcesz załadować dodatkowe informacje o głównym oknie ramowym.

CWinAppEx::m_bForceImageReset

Określa, czy platforma resetuje wszystkie obrazy paska narzędzi podczas ponownego ładowania okna ramki zawierającego pasek narzędzi.

BOOL m_bForceImageReset;

Uwagi

Element m_bForceImageReset członkowski danych jest zmienną chronioną.

CWinAppEx::OnAppContextHelp

Struktura wywołuje tę metodę, gdy użytkownik żąda pomocy kontekstowej dla okna dialogowego Dostosowywanie .

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

Parametry

pWndControl
[in] Wskaźnik do obiektu okna, dla którego użytkownik wywołał pomoc kontekstową.

dwHelpIDArray[]
[in] Wartość zarezerwowana.

Uwagi

Ta metoda jest obecnie zarezerwowana do użycia w przyszłości. Domyślna implementacja nic nie robi i obecnie nie jest wywoływana przez platformę.

CWinAppEx::OnClosingMainFrame

Struktura wywołuje tę metodę, gdy okno ramki przetwarza WM_CLOSEelement .

virtual void OnClosingMainFrame(CFrameImpl* pFrameImpl);

Parametry

pFrameImpl
[in] Wskaźnik do CFrameImpl obiektu.

Uwagi

Domyślna implementacja tej metody zapisuje stan pFrameImpl.

CWinAppEx::OnViewDoubleClick

Wywołuje zdefiniowane przez użytkownika polecenie skojarzone z widokiem, gdy użytkownik kliknie dwukrotnie w dowolnym miejscu w tym widoku.

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

Parametry

pWnd
[in] Wskaźnik do obiektu pochodzącego CView z klasy.

iViewId
[in] Identyfikator widoku.

Wartość zwracana

TRUE jeśli struktura znajdzie polecenie; w przeciwnym razie FALSE.

Uwagi

Aby obsługiwać niestandardowe zachowanie myszy, należy wywołać tę funkcję podczas przetwarzania komunikatu WM_LBUTTONDBLCLK . Ta metoda wykona polecenie skojarzone z identyfikatorem widoku dostarczonym przez iViewIdprogram . Aby uzyskać więcej informacji na temat niestandardowego zachowania myszy, zobacz Dostosowywanie klawiatury i myszy.

CWinAppEx::OnWorkspaceIdle

virtual BOOL OnWorkspaceIdle(CWnd*);

Parametry

[in] CWnd*\

Wartość zwracana

Uwagi

CWinAppEx::PreLoadState

Platforma wywołuje tę metodę bezpośrednio przed załadowaniem stanu aplikacji z rejestru.

virtual void PreLoadState();

Uwagi

Zastąpi tę metodę, jeśli chcesz wykonać jakiekolwiek przetwarzanie bezpośrednio przed załadowaniem stanu aplikacji przez platformę.

CWinAppEx::PreSaveState

Platforma wywołuje tę metodę bezpośrednio przed zapisaniem stanu aplikacji.

virtual void PreSaveState();

Uwagi

Zastąpi tę metodę, jeśli chcesz wykonać jakiekolwiek przetwarzanie bezpośrednio przed zapisaniem stanu aplikacji przez strukturę.

CWinAppEx::ReloadWindowPlacement

Ponownie ładuje rozmiar i lokalizację okna z rejestru.

virtual BOOL ReloadWindowPlacement(CFrameWnd* pFrame);

Parametry

pFrame
[in] Wskaźnik do okna ramki.

Wartość zwracana

Nonzero, jeśli metoda zakończyła się pomyślnie; 0, jeśli ładowanie nie powiodło się lub nie ma danych do załadowania.

Uwagi

Użyj funkcji CWinAppEx::StoreWindowPlacement , aby zapisać rozmiar i lokalizację okna w rejestrze.

CWinAppEx::SaveCustomState

Struktura wywołuje tę metodę po zapisaniu stanu aplikacji w rejestrze.

virtual void SaveCustomState();

Uwagi

Zastąpi tę metodę, jeśli chcesz wykonać jakiekolwiek przetwarzanie po zapisaniu stanu w rejestrze przez aplikację. Domyślnie ta metoda nic nie robi.

CWinAppEx::SaveState

Zapisuje stan aplikacji w rejestrze systemu Windows.

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);

Parametry

lpszSectionName
[in] Ciąg zawierający ścieżkę względną klucza rejestru.

pFrameImpl
[in] Wskaźnik do CFrameImpl obiektu. Ta ramka jest zapisywana w rejestrze systemu Windows.

pFrame
[in] Wskaźnik do obiektu okna ramki. Ta ramka jest zapisywana w rejestrze systemu Windows.

Wartość zwracana

TRUE w przypadku powodzenia; FALSE inaczej.

Uwagi

Ta metoda zapisuje stan aplikacji i informacje o stanie dla podanego okna ramki. Jeśli nie podasz okna ramki, metoda zapisuje tylko stan aplikacji. Informacje o aplikacji obejmują stan CMouseManager klasy, CContextMenuManager klasy, CKeyboardManager klasy i CUserToolsManager klasy.

Parametr lpszSectionName nie jest ścieżką bezwzględną dla wpisu rejestru. Jest to ścieżka względna dołączana na końcu domyślnego klucza rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

CWinAppEx::SetRegistryBase

Ustawia domyślną ścieżkę rejestru dla aplikacji.

LPCTSTR SetRegistryBase(LPCTSTR lpszSectionName = NULL);

Parametry

lpszSectionName
[in] Ciąg zawierający ścieżkę klucza rejestru.

Wartość zwracana

Ciąg zawierający ścieżkę domyślnej lokalizacji rejestru.

Uwagi

Wszystkie metody CWinAppEx klasy , które uzyskują dostęp do rejestru, są uruchamiane w domyślnej lokalizacji. Użyj tej metody, aby zmienić tę domyślną lokalizację rejestru. Użyj CWinAppEx::GetRegistryBase polecenia , aby pobrać domyślną lokalizację rejestru.

CWinAppEx::ShowPopupMenu

Wyświetla menu podręczne.

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

Parametry

uiMenuResId
[in] Identyfikator zasobu menu.

point
[in] Element CPoint określający położenie menu we współrzędnych ekranu.

pWnd
[in] Wskaźnik do okna, który jest właścicielem menu podręcznego.

Wartość zwracana

Nonzero, jeśli menu podręczne jest wyświetlane pomyślnie; 0 w przeciwnym razie.

Uwagi

Ta metoda wyświetla menu skojarzone z uiMenuResId.

Aby obsługiwać menu podręczne, musisz mieć CContextMenuManager obiekt. Jeśli obiekt nie został zainicjowany CContextMenuManager , ShowPopupMenu zakończy się niepowodzeniem.

CWinAppEx::StoreWindowPlacement

Wywoływana przez platformę w celu zapisania rozmiaru i lokalizacji głównego okna ramki w rejestrze.

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

Parametry

nFlags
[in] Flagi kontrolujące położenie zminimalizowanego okna i sposób przełączania systemu operacyjnego między zminimalizowanym oknem a przywróconym oknem.

nShowCmd
[in] Liczba całkowita określająca stan show okna. Aby uzyskać więcej informacji na temat możliwych wartości, zobacz CWnd::ShowWindow.

rectNormalPosition
[in] Prostokąt zawierający współrzędne okna głównego ramki, gdy znajduje się w stanie przywróconym.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; 0 w przeciwnym razie.

Uwagi

Domyślnie MFC automatycznie zapisuje położenie i stan głównego okna ramki przed zamknięciem aplikacji. Te informacje są przechowywane w rejestrze systemu Windows w kluczu WindowsPlacement w domyślnej lokalizacji rejestru aplikacji. Aby uzyskać więcej informacji na temat domyślnej lokalizacji rejestru aplikacji, zobacz CWinAppEx::GetRegistryBase.

Zastąpi tę metodę, jeśli chcesz przechowywać dodatkowe informacje o głównym oknie ramowym.

CWinAppEx::WriteBinary

Zapisuje dane binarne w rejestrze.

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

Parametry

lpszEntry
[in] Ciąg zawierający nazwę klucza rejestru.

pData
[in] Dane do przechowywania.

nBytes
[in] Rozmiar w bajtach pData .

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie FALSE.

Uwagi

Parametr lpszEntry jest nazwą wpisu rejestru, który znajduje się w domyślnym kluczu rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

Jeśli klucz określony przez lpszEntry nie istnieje, ta metoda go utworzy.

CWinAppEx::WriteInt

Zapisuje dane liczbowe w rejestrze.

BOOL WriteInt(
    LPCTSTR lpszEntry,
    int nValue);

Parametry

lpszEntry
[in] Ciąg zawierający nazwę klucza rejestru.

nValue
[in] Dane do przechowywania.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie FALSE.

Uwagi

Parametr lpszEntry jest nazwą wpisu rejestru znajdującego się pod domyślnym kluczem rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

Jeśli klucz określony przez lpszEntry nie istnieje, ta metoda go utworzy.

CWinAppEx::WriteObject

Zapisuje dane pochodzące z CObject klasy do rejestru.

BOOL WriteObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Parametry

lpszEntry
[in] Ciąg zawierający wartość do ustawienia.

obj
[in] Odwołanie do CObject danych, które będzie przechowywać metoda.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie FALSE.

Uwagi

Ta metoda zapisuje obj dane do określonej wartości w domyślnym kluczu rejestru. Użyj CWinAppEx::GetRegistryBase polecenia , aby określić bieżący klucz rejestru.

CWinAppEx::WriteSectionBinary

Zapisuje dane binarne w wartości w rejestrze.

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

Parametry

lpszSubSection
[in] Ciąg zawierający nazwę klucza rejestru

lpszEntry
[in] Ciąg zawierający wartość do ustawienia.

pData
[in] Dane do zapisu w rejestrze.

nBytes
[in] Rozmiar w bajtach pData .

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie FALSE.

Uwagi

Parametr lpszSubSection nie jest ścieżką bezwzględną dla wpisu rejestru. Jest to ścieżka względna dołączana na końcu domyślnego klucza rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

Jeśli klucz określony przez lpszEntry nie istnieje, ta metoda go utworzy.

CWinAppEx::WriteSectionInt

Zapisuje dane liczbowe w rejestrze.

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

Parametry

lpszSubSection
[in] Ciąg zawierający ścieżkę względną klucza rejestru.

lpszEntry
[in] Ciąg zawierający wartość do ustawienia.

nValue
[in] Dane do zapisu w rejestrze.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie FALSE.

Uwagi

Parametr lpszSubSection nie jest ścieżką bezwzględną dla wpisu rejestru. Jest to ścieżka względna dołączana do domyślnego klucza rejestru aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

Jeśli klucz określony przez lpszEntry nie istnieje, ta metoda go utworzy.

CWinAppEx::WriteSectionObject

Zapisuje dane pochodzące z CObject klasy do określonej wartości rejestru.

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

Parametry

lpszSubSection
[in] Ciąg zawierający nazwę klucza rejestru.

lpszEntry
[in] Ciąg zawierający nazwę wartości do ustawienia.

obj
[in] Dane do przechowywania.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie FALSE.

Uwagi

Parametr lpszSubSection nie jest ścieżką bezwzględną dla wpisu rejestru. Jest to ścieżka względna dołączana na końcu domyślnego klucza rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj odpowiednio metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase, .

Jeśli wartość określona przez lpszEntry element nie istnieje w kluczu rejestru określonym przez lpszSubSectionmetodę , ta metoda utworzy tę wartość.

CWinAppEx::WriteSectionString

Zapisuje dane ciągu w wartości w rejestrze.

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

Parametry

lpszSubSection
[in] Ciąg zawierający nazwę klucza rejestru.

lpszEntry
[in] Ciąg zawierający wartość do ustawienia.

lpszValue
[in] Dane ciągu do zapisu w rejestrze.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie FALSE.

Uwagi

Parametr lpszSubSection nie jest ścieżką bezwzględną dla wpisu rejestru. Jest to ścieżka względna dołączana na końcu domyślnego klucza rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj odpowiednio metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase, .

Jeśli wartość określona przez lpszEntry element nie istnieje w obszarze lpszSubSection, ta metoda ją utworzy.

CWinAppEx::WriteString

Zapisuje dane ciągu w rejestrze.

BOOL WriteString(
    LPCTSTR lpszEntry,
    LPCTSTR lpszValue);

Parametry

lpszEntry
[in] Ciąg zawierający nazwę klucza rejestru.

lpszValue
[in] Dane do przechowywania.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie FALSE.

Uwagi

Parametr lpszEntry jest nazwą wpisu rejestru znajdującego się pod domyślnym kluczem rejestru dla aplikacji. Aby uzyskać lub ustawić domyślny klucz rejestru, użyj metod CWinAppEx::GetRegistryBase i CWinAppEx::SetRegistryBase odpowiednio.

Jeśli klucz określony przez lspzEntry nie istnieje, ta metoda go utworzy.

Zobacz też

Wykres hierarchii
Klasy
CWinApp Klasa
CMouseManager Klasa
CContextMenuManager Klasa
CKeyboardManager Klasa
CUserToolsManager Klasa