다음을 통해 공유


CWinAppEx 클래스

CWinAppEx는 애플리케이션 상태를 처리하고 상태를 레지스트리에 저장하고 레지스트리에서 상태를 로드하고 애플리케이션 관리자를 초기화하고 이러한 동일한 애플리케이션 관리자에 대한 링크를 제공합니다.

자세한 내용은 Visual Studio 설치의 mfc 폴더에 있는 소스 코드를 참조하세요. 예들 들어 %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc입니다.

구문

class CWinAppEx : public CWinApp

멤버

공용 생성자

속성 설명
CWinAppEx::CWinAppEx CWinAppEx 개체를 생성합니다.

공용 메서드

이름 설명
CWinAppEx::CleanState Windows 레지스트리에서 애플리케이션에 대한 정보를 제거합니다.
CWinAppEx::EnableLoadWindowPlacement 애플리케이션이 레지스트리에서 메인 프레임 창의 초기 크기와 위치를 로드할지 여부를 지정합니다.
CWinAppEx::EnableTearOffMenus 애플리케이션에 대한 분리 메뉴를 사용하도록 설정합니다.
CWinAppEx::EnableUserTools 사용자가 애플리케이션에서 사용자 지정 메뉴 명령을 만들 수 있도록 합니다.
CWinAppEx::ExitInstance 애플리케이션의 이 인스턴스를 종료하기 위해 Run 멤버 함수 내에서 프레임워크에 의해 호출됩니다. ( CWinApp::ExitInstance을 재정의합니다.)
CWinAppEx::GetBinary 지정된 레지스트리 값과 연결된 이진 데이터를 읽습니다.
CWinAppEx::GetContextMenuManager 전역 CContextMenuManager 개체에 대한 포인터를 반환합니다.
CWinAppEx::GetDataVersion
CWinAppEx::GetDataVersionMajor Windows 레지스트리에 저장된 애플리케이션의 주 버전을 반환합니다.
CWinAppEx::GetDataVersionMinor Windows 레지스트리에 저장된 애플리케이션의 부 버전을 반환합니다.
CWinAppEx::GetInt 레지스트리에서 지정된 값과 연결된 숫자 데이터를 읽습니다.
CWinAppEx::GetKeyboardManager 전역 CKeyboardManager 개체에 대한 포인터를 반환합니다.
CWinAppEx::GetMouseManager 전역 CMouseManager 개체에 대한 포인터를 반환합니다.
CWinAppEx::GetObject 레지스트리에서 지정된 값과 연관된 CObject 파생 데이터를 읽습니다.
CWinAppEx::GetRegSectionPath 레지스트리 키의 경로인 문자열을 반환합니다. 이 경로는 제공된 상대 경로를 애플리케이션 경로와 연결합니다.
CWinAppEx::GetRegistryBase 애플리케이션의 레지스트리 경로를 반환합니다.
CWinAppEx::GetSectionBinary 레지스트리에서 지정된 키 및 값과 연결된 이진 데이터를 읽습니다.
CWinAppEx::GetSectionInt 지정된 키 및 값과 연결된 레지스트리에서 숫자 데이터를 읽습니다.
CWinAppEx::GetSectionObject 레지스트리에서 지정된 키 및 값과 연관된 CObject 데이터를 읽습니다.
CWinAppEx::GetSectionString 레지스트리에서 지정된 키 및 값과 연결된 문자열 데이터를 읽습니다.
CWinAppEx::GetShellManager 전역 CShellManager 개체에 대한 포인터를 반환합니다.
CWinAppEx::GetString 레지스트리에서 지정된 값과 연결된 문자열 데이터를 읽습니다.
CWinAppEx::GetTooltipManager 전역 CTooltipManager 개체에 대한 포인터를 반환합니다.
CWinAppEx::GetUserToolsManager 전역 CUserToolsManager 개체에 대한 포인터를 반환합니다.
CWinAppEx::InitContextMenuManager 초기화는 CContextMenuManager 개체입니다.
CWinAppEx::InitKeyboardManager 초기화는 CKeyboardManager 개체입니다.
CWinAppEx::InitMouseManager 초기화는 CMouseManager 개체입니다.
CWinAppEx::InitShellManager CShellManager 클래스 초기
CWinAppEx::InitTooltipManager CTooltipManager 클래스를 초기화합니다.
CWinAppEx::IsResourceSmartUpdate
CWinAppEx::IsStateExists 지정된 키가 레지스트리에 있는지 여부를 나타냅니다.
CWinAppEx::LoadState 레지스트리에서 애플리케이션 상태를 로드합니다.
CWinAppEx::OnAppContextHelp 사용자가 사용자 지정 대화 상자에 대한 상황별 도움말을 요청할 때 프레임워크에 의해 호출됩니다.
CWinAppEx::OnViewDoubleClick 사용자가 애플리케이션의 아무 곳이나 두 번 클릭하면 사용자 정의 명령을 호출합니다.
CWinAppEx::OnWorkspaceIdle
CWinAppEx::SaveState Windows 레지스트리에 애플리케이션 프레임워크의 상태를 씁니다.
CWinAppEx::SetRegistryBase 기본 레지스트리 키의 경로를 설정합니다. 이 키는 모든 후속 레지스트리 호출의 루트 역할을 합니다.
CWinAppEx::ShowPopupMenu 팝업 메뉴를 표시합니다.
CWinAppEx::WriteBinary 지정된 레지스트리 값에 이진 데이터를 씁니다.
CWinAppEx::WriteInt 지정된 레지스트리 값에 숫자 데이터를 씁니다.
CWinAppEx::WriteObject CObject 클래스에서 파생된 데이터를 지정된 레지스트리 값에 씁니다.
CWinAppEx::WriteSectionBinary 지정된 레지스트리 키 값에 이진 데이터를 씁니다.
CWinAppEx::WriteSectionInt 지정된 레지스트리 키 값에 숫자 데이터를 씁니다.
CWinAppEx::WriteSectionObject CObject 클래스에서 파생된 데이터를 지정된 레지스트리 키 값에 씁니다.
CWinAppEx::WriteSectionString 지정된 레지스트리 키 값에 문자열 데이터를 씁니다.
CWinAppEx::WriteString 지정된 레지스트리 값에 문자열 데이터를 씁니다.

보호된 메서드

속성 설명
CWinAppEx::LoadCustomState 애플리케이션 상태가 로드되면 프레임워크에서 호출됩니다.
CWinAppEx::LoadWindowPlacement 레지스트리에서 애플리케이션의 크기와 위치를 로드할 때 프레임워크에 의해 호출됩니다. 로드된 데이터에는 애플리케이션이 마지막으로 종료된 시점의 메인 프레임의 크기와 위치가 포함됩니다.
CWinAppEx::OnClosingMainFrame 메인 프레임 창이 WM_CLOSE를 처리 중일 때 프레임워크에서 호출됩니다.
CWinAppEx::PreLoadState 애플리케이션 상태가 로드되기 직전에 프레임워크에 의해 호출됩니다.
CWinAppEx::PreSaveState 애플리케이션 상태가 저장되기 직전에 프레임워크에서 호출됩니다.
CWinAppEx::ReloadWindowPlacement 레지스트리에서 제공된 창의 크기와 위치 다시 로드
CWinAppEx::SaveCustomState 애플리케이션 상태를 레지스트리에 기록한 후 프레임워크에 의해 호출됩니다.
CWinAppEx::StoreWindowPlacement 메인 프레임의 크기와 위치를 레지스트리에 쓰기 위해 프레임워크에서 호출됩니다.

데이터 멤버

속성 설명
CWinAppEx::m_bForceImageReset 도구 모음이 포함된 프레임 창이 로드될 때 프레임워크가 모든 도구 모음 이미지를 다시 설정할지 여부를 지정합니다.

설명

MFC 프레임워크에서 제공하는 기능의 대부분은 CWinAppEx 클래스에 따라 다릅니다. 다음 두 가지 방법 중 하나로 CWinAppEx 클래스를 애플리케이션에 통합할 수 있습니다.

  • 기본 스레드에서 CWinAppEx 클래스를 구성합니다.

  • CWinAppEx에서 기본 애플리케이션 클래스를 파생시킵니다.

CWinAppEx를 애플리케이션에 통합한 후 애플리케이션 관리자 중 하나를 초기화할 수 있습니다. 애플리케이션 관리자를 사용하기 전에 적절한 초기화 메서드를 호출하여 초기화해야 합니다. 특정 관리자에 대한 포인터를 가져오려면 연관된 get 메서드를 호출합니다. CWinAppEx 클래스는 다음 애플리케이션 관리자를 관리합니다. CMouseManager 클래스, CContextMenuManager 클래스, CKeyboardManager 클래스, CUserToolsManager 클래스CMenuTearOffManager 클래스.

상속 계층 구조

CObject

CCmdTarget

CWinThread

CWinApp

CWinAppEx

요구 사항

머리글: afxwinappex.h

CWinAppEx::CleanState

Windows 레지스트리에서 애플리케이션에 대한 모든 정보를 제거합니다.

virtual BOOL CleanState(LPCTSTR lpszSectionName=NULL);

매개 변수

lpszSectionName
진행 레지스트리 키의 경로가 포함된 문자열입니다.

Return Value

메서드가 성공한 경우 0이 아니며, 그렇지 않은 경우 0입니다.

설명

이 방법은 레지스트리의 특정 섹션에서 애플리케이션 데이터를 지웁니다. lpszSectionName 매개 변수를 사용하여 지울 섹션을 지정할 수 있습니다. lpszSectionNameNULL인 경우 이 메서드는 CWinAppEx 개체에 저장된 기본 레지스트리 경로를 사용합니다. 기본 레지스트리 경로를 가져오려면 CWinAppEx::GetRegistryBase를 사용합니다.

CWinAppEx::CWinAppEx

CWinAppEx 개체를 생성합니다.

CWinAppEx(BOOL bResourceSmartUpdate = FALSE);

매개 변수

bResourceSmartUpdate
[in] 작업 영역 개체가 리소스 업데이트를 검색하고 처리해야 하는지 여부를 지정하는 부울 매개 변수입니다.

설명

CWinAppEx 클래스에는 초기화 메서드가 있고 애플리케이션 정보를 레지스트리에 저장 및 로드하는 기능을 제공하며 전역 애플리케이션 설정을 제어합니다. 또한 CKeyboardManager 클래스CUserToolsManager 클래스와 같은 전역 관리자를 사용할 수도 있습니다. 각 애플리케이션은 CWinAppEx 클래스의 인스턴스를 하나만 가질 수 있습니다.

CWinAppEx::EnableLoadWindowPlacement

애플리케이션이 레지스트리에서 메인 프레임 창의 초기 크기와 위치를 로드할지 여부를 지정합니다.

void EnableLoadWindowPlacement(BOOL bEnable = TRUE);

매개 변수

bEnable
[in] 애플리케이션이 레지스트리에서 메인 프레임 창의 초기 크기와 위치를 로드하는지 여부를 지정합니다.

설명

기본적으로 메인 프레임의 크기와 위치는 다른 애플리케이션 설정과 함께 레지스트리에서 로드됩니다. 이는 CWinAppEx::LoadState 동안 발생합니다. 레지스트리에서 초기 창 배치를 로드하지 않으려면 bEnableFALSE로 설정하여 이 메서드를 호출합니다.

CWinAppEx::EnableTearOffMenus

CMenuTearOffManager 개체를 만들고 초기화합니다.

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

매개 변수

lpszRegEntry
[in] 레지스트리 키의 경로를 포함하는 문자열입니다. 애플리케이션은 이 레지스트리 키를 사용하여 분리 메뉴에 대한 정보를 저장합니다.

uiCmdFirst
[in] 진행 첫 번째 분리 메뉴 ID입니다.

uiCmdLast
[in] 진행 마지막 분리 메뉴 ID입니다.

Return Value

CMenuTearOffManager가 성공적으로 만들어지고 초기화되면 TRUE입니다. 오류가 발생했거나 CMenuTearOffManager가 이미 존재하는 경우 FALSE입니다.

설명

이 함수를 사용하여 애플리케이션에서 분리 메뉴를 사용하도록 설정합니다. InitInstance에서 이 함수를 호출해야 합니다.

CWinAppEx::EnableUserTools

사용자가 애플리케이션에서 키 입력을 줄이는 사용자 지정 메뉴 명령을 만들 수 있습니다. 이 메서드는 CUserToolsManager 개체를 만듭니다.

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

매개 변수

uiCmdToolsDummy
[in] 진행 프레임워크가 사용자 도구 메뉴의 명령 ID에 대한 자리 표시자로 사용하는 부호 없는 정수입니다.

uiCmdFirst
[in] 진행 첫 번째 사용자 도구 명령의 명령 ID입니다.

uiCmdLast
[in] 진행 마지막 사용자 도구 명령의 명령 ID입니다.

pToolRTC
[in] CUserToolsManager 개체가 새 사용자 도구를 만드는 데 사용하는 클래스입니다.

uArgMenuID
[in] 진행 인수 메뉴 ID입니다.

uInitDirMenuID
[in] 진행 초기 도구 디렉터리의 메뉴 ID입니다.

Return Value

메서드가 CUserToolsManager 개체를 만들고 초기화하는 경우 TRUE이며, 메서드가 실패하거나 CUserToolsManager 개체가 이미 존재하는 경우 FALSE입니다.

설명

사용자 지정 도구를 사용하도록 설정하면 프레임워크는 사용자 지정 중에 확장할 수 있는 동적 메뉴를 자동으로 지원합니다. 프레임워크는 각각의 새 항목을 외부 명령과 연결합니다. 프레임워크는 사용자가 도구 메뉴에서 적절한 항목을 선택할 때 이러한 명령을 호출합니다.

사용자가 새 항목을 추가할 때마다 프레임워크는 새 개체를 만듭니다. 새 개체의 클래스 형식은 pToolRTC에 의해 정의됩니다. pToolRTC 클래스 형식은 CUserTool 클래스에서 파생되어야 합니다.

사용자 도구 및 이를 애플리케이션에 통합하는 방법에 대한 자세한 내용은 사용자 정의 도구를 참조하세요.

CWinAppEx::ExitInstance

virtual int ExitInstance();

Return Value

설명

CWinAppEx::GetBinary

지정된 레지스트리 키에서 이진 데이터를 읽습니다.

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

매개 변수

lpszEntry
진행 레지스트리 키의 이름이 포함된 문자열입니다.

ppData
[out] 메서드가 이진 데이터로 채우는 버퍼에 대한 포인터입니다.

pBytes
[out] 메서드가 읽은 바이트 수를 쓰는 데 사용하는 부호 없는 정수에 대한 포인터입니다.

Return Value

성공하면 TRUE이며, 그렇지 않으면 FALSE입니다.

설명

이 메서드는 레지스트리에 기록된 이진 파일 데이터를 읽습니다. 레지스트리에 데이터를 쓰려면 CWinAppEx::WriteBinaryCWinAppEx::WriteSectionBinary 메서드를 사용합니다.

lpszEntry 매개 변수는 애플리케이션의 기본 레지스트리 키 아래에 있는 레지스트리 항목의 이름입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

CWinAppEx::GetContextMenuManager

전역 CContextMenuManager 개체에 대한 포인터를 반환합니다.

CContextMenuManager* GetContextMenuManager();

Return Value

전역 CContextMenuManager 개체에 대한 포인터입니다.

설명

CContextMenuManager 개체가 초기화되지 않은 경우 이 함수는 포인터를 반환하기 전에 CWinAppEx::InitContextMenuManager를 호출합니다.

CWinAppEx::GetDataVersion

int GetDataVersion() const;

Return Value

설명

CWinAppEx::GetDataVersionMajor

CWinAppEx::SaveState 호출 시 Windows 레지스트리에 저장된 애플리케이션의 주 버전을 반환합니다.

int GetDataVersionMajor() const;

Return Value

주 버전 번호가 포함된 정수 값입니다.

CWinAppEx::GetDataVersionMinor

CWinAppEx::SaveState 호출 시 Windows 레지스트리에 저장된 애플리케이션의 부 버전을 반환합니다.

int GetDataVersionMinor() const;

Return Value

부 버전 번호가 포함된 정수 값입니다.

CWinAppEx::GetInt

지정된 레지스트리 키에서 정수 데이터를 읽습니다.

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

매개 변수

lpszEntry
[in] 레지스트리 항목의 이름을 포함하는 문자열입니다.

nDefault
진행 지정된 레지스트리 항목이 존재하지 않는 경우 메서드가 반환하는 기본값입니다.

Return Value

메서드가 성공한 경우 레지스트리 데이터이며, 그렇지 않은 경우 nDefault입니다.

설명

이 메서드는 레지스트리에서 정수 데이터를 읽습니다. lpszEntry로 표시된 레지스트리 키와 연결된 정수 데이터가 없는 경우 이 메서드는 nDefault를 반환합니다. 레지스트리에 데이터를 쓰려면 CWinAppEx::WriteSectionIntCWinAppEx::WriteInt 메서드를 사용합니다.

lpszEntry 매개 변수는 애플리케이션의 기본 레지스트리 키 아래에 있는 레지스트리 항목의 이름입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

CWinAppEx::GetKeyboardManager

전역 CKeyboardManager 개체에 대한 포인터를 반환합니다.

CKeyboardManager* GetKeyboardManager();

Return Value

전역 CKeyboardManager 개체에 대한 포인터입니다.

설명

키보드 관리자가 초기화되지 않은 경우 이 함수는 포인터를 반환하기 전에 CWinAppEx::InitKeyboardManager를 호출합니다.

CWinAppEx::GetMouseManager

전역 CMouseManager 개체에 대한 포인터를 반환합니다.

CMouseManager* GetMouseManager();

Return Value

전역 CMouseManager 개체에 대한 포인터입니다.

설명

마우스 관리자가 초기화되지 않은 경우 이 함수는 포인터를 반환하기 전에 CWinAppEx::InitMouseManager를 호출합니다.

CWinAppEx::GetObject

레지스트리에서 CObject 파생 데이터를 읽습니다.

BOOL GetObject(
    LPCTSTR lpszEntry,
    CObject& obj);

매개 변수

lpszEntry
[in] 레지스트리 항목의 상대 경로를 포함하는 문자열입니다.

obj
[out] CObject에 대한 참조입니다. 메서드는 이 참조를 사용하여 레지스트리 데이터를 저장합니다.

Return Value

메서드가 성공한 경우 0이 아니며, 그렇지 않은 경우 0입니다.

설명

이 메서드는 CObject에서 파생된 레지스트리에서 데이터를 읽습니다. CObject 데이터를 레지스트리에 쓰려면 CWinAppEx::WriteObject 또는 CWinAppEx::WriteSectionObject를 사용합니다.

lpszEntry 매개 변수는 애플리케이션의 기본 레지스트리 키 아래에 있는 레지스트리 항목의 이름입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

CWinAppEx::GetRegistryBase

애플리케이션의 기본 레지스트리 경로를 검색합니다.

LPCTSTR GetRegistryBase();

Return Value

기본 레지스트리 위치의 경로가 포함된 문자열입니다.

설명

레지스트리에 액세스하는 CWinAppEx 클래스의 모든 메서드는 기본 위치에서 시작됩니다. 기본 레지스트리 위치의 경로를 검색하려면 이 방법을 사용합니다. 기본 레지스트리 위치를 변경하려면 CWinAppEx::SetRegistryBase를 사용합니다.

CWinAppEx::GetRegSectionPath

레지스트리 키의 절대 경로를 만들고 반환합니다.

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

매개 변수

szSectionAdd
[in] 레지스트리 키의 상대 경로를 포함하는 문자열입니다.

Return Value

레지스트리 키의 절대 경로를 포함하는 CString입니다.

설명

이 메서드는 애플리케이션의 기본 레지스트리 위치에 szSectionAdd의 상대 경로를 추가하여 레지스트리 키의 절대 경로를 정의합니다. 기본 레지스트리 키를 가져오려면 CWinAppEx::GetRegistryBase 메서드를 사용합니다.

CWinAppEx::GetSectionBinary

레지스트리에서 이진 데이터를 읽습니다.

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

매개 변수

lpszSubSection
[in] 레지스트리 키의 상대 경로를 포함하는 문자열입니다.

lpszEntry
[in] 읽을 값이 포함된 문자열입니다.

ppData
[out] 메서드가 데이터를 저장하는 버퍼에 대한 포인터입니다.

pBytes
[out] 부호 없는 정수에 대한 포인터입니다. 메서드는 이 매개 변수에 ppData의 크기를 씁니다.

Return Value

성공하면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

이 메서드는 CWinAppEx::WriteBinaryCWinAppEx::WriteSectionBinary 메서드를 사용하여 레지스트리에 기록된 이진 파일 데이터를 읽습니다.

lpszSubSection 매개 변수는 레지스트리 항목의 절대 경로가 아닙니다. 이는 애플리케이션의 기본 레지스트리 키 끝에 추가되는 상대 경로입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

CWinAppEx::GetSectionInt

레지스트리에서 정수 데이터를 읽습니다.

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

매개 변수

lpszSubSection
[in] 레지스트리 키의 상대 경로를 포함하는 문자열입니다.

lpszEntry
[in] 읽을 값이 포함된 문자열입니다.

nDefault
[in] 진행 지정된 값이 존재하지 않는 경우 반환할 기본값입니다.

Return Value

지정된 레지스트리 값에 저장되는 정수 데이터이며, 데이터가 존재하지 않는 경우 nDefault입니다.

설명

CWinAppEx::WriteIntCWinAppEx::WriteSectionInt 메서드를 사용하여 레지스트리에 정수 데이터를 씁니다.

lpszSubSection 매개 변수는 레지스트리 항목의 절대 경로가 아닙니다. 이는 애플리케이션의 기본 레지스트리 키 끝에 추가되는 상대 경로입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

CWinAppEx::GetSectionObject

레지스트리에서 CObject 레지스트리 데이터를 읽습니다.

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

매개 변수

lpszSubSection
[in] 레지스트리 키의 상대 경로를 포함하는 문자열입니다.

lpszEntry
[in] 읽을 값이 포함된 문자열입니다.

obj
[out] CObject에 대한 참조입니다. 메서드는 이 CObject를 사용하여 레지스트리 데이터를 저장합니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

이 메서드는 레지스트리에서 데이터를 읽습니다. 읽은 데이터는 CObject 데이터이거나 CObject에서 파생된 클래스에 대한 데이터입니다. CObject 데이터를 레지스트리에 쓰려면 CWinAppEx::WriteObject 또는 CWinAppEx::WriteSectionObject를 사용합니다.

lpszSubSection 매개 변수는 레지스트리 항목의 절대 경로가 아닙니다. 이는 애플리케이션의 기본 레지스트리 키 끝에 추가되는 상대 경로입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

CWinAppEx::GetSectionString

레지스트리에서 문자열 데이터를 읽습니다.

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

매개 변수

lpszSubSection
[in] 레지스트리 키의 상대 경로를 포함하는 문자열입니다.

lpszEntry
[in] 읽을 값이 포함된 문자열입니다.

lpszDefault
[in] 진행 지정된 값이 존재하지 않는 경우 반환할 기본값입니다.

Return Value

데이터가 존재하는 경우 지정된 레지스트리 값에 저장된 문자열 데이터이며, 그렇지 않은 경우 lpszDefault입니다.

설명

이 메서드는 레지스트리에 기록된 문자열 데이터를 읽습니다. 문자열 데이터를 레지스트리에 쓰려면 CWinAppEx::WriteStringCWinAppEx::WriteSectionString을 사용합니다.

lpszSubSection 매개 변수는 레지스트리 항목의 절대 경로가 아닙니다. 이는 애플리케이션의 기본 레지스트리 키 끝에 추가되는 상대 경로입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

CWinAppEx::GetShellManager

전역 CShellManager 개체에 대한 포인터를 반환합니다.

CShellManager* GetShellManager();

Return Value

전역 CShellManager 개체에 대한 포인터입니다.

설명

CShellManager 개체가 초기화되지 않은 경우 이 함수는 포인터를 반환하기 전에 CWinAppEx::InitShellManager를 호출합니다.

CWinAppEx::GetString

지정된 레지스트리 키에서 문자열 데이터를 읽습니다.

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

매개 변수

lpszEntry
[in] 진행 레지스트리 키 이름이 포함된 문자열입니다.

lpzDefault
진행 지정된 레지스트리 항목이 존재하지 않는 경우 메서드가 반환하는 기본값입니다.

Return Value

성공한 경우 레지스트리에 저장된 문자열 데이터이며, 그렇지 않은 경우 lpszDefault입니다.

설명

이 메서드는 레지스트리에 기록된 문자열 데이터를 읽습니다. 레지스트리에 데이터를 쓰려면 CWinAppEx::WriteString 또는 CWinAppEx::WriteSectionString 메서드를 사용합니다.

lpszEntry 매개 변수는 애플리케이션의 기본 레지스트리 키 아래에 있는 레지스트리 항목의 이름입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

CWinAppEx::GetTooltipManager

전역 CTooltipManager 개체에 대한 포인터를 반환합니다.

CTooltipManager* GetTooltipManager();

Return Value

전역 CTooltipManager 개체에 대한 포인터입니다.

설명

CTooltipManager 개체가 초기화되지 않은 경우 이 함수는 포인터를 반환하기 전에 CWinAppEx::InitTooltipManager를 호출합니다.

CWinAppEx::GetUserToolsManager

전역 CUserToolsManager 개체에 대한 포인터를 반환합니다.

CUserToolsManager* GetUserToolsManager();

Return Value

전역 CUserToolsManager 개체에 대한 포인터이며, 애플리케이션에 대해 사용자 도구 관리가 사용하도록 설정되지 않은 경우 NULL입니다.

설명

CUserToolsManager 개체에 대한 포인터를 검색하기 전에 CWinAppEx::EnableUserTools를 호출하여 관리자를 초기화해야 합니다.

CWinAppEx::InitContextMenuManager

초기화는 CContextMenuManager 개체입니다.

BOOL InitContextMenuManager();

Return Value

메서드가 CContextMenuManager 개체를 만드는 경우 0이 아니며, CContextMenuManager 개체가 이미 존재하는 경우 0입니다.

설명

CWinAppEx::GetContextMenuManager를 호출하면 해당 메서드의 기본 구현이 InitContextMenuManager를 호출합니다.

애플리케이션에 이미 바로 가기 메뉴 관리자가 있고 InitContextMenuManager를 호출하면 애플리케이션에 ASSERT 오류가 발생합니다. 따라서 CContextMenuManager 개체를 직접 만드는 경우에는 InitContextMenuManager를 호출하면 안 됩니다. 사용자 지정 CContextMenuManager를 사용하지 않는 경우 GetContextMenuManager를 사용하여 CContextMenuManager 개체를 만들어야 합니다.

CWinAppEx::InitKeyboardManager

초기화는 CKeyboardManager 개체입니다.

BOOL InitKeyboardManager();

Return Value

메서드가 CKeyboardManager 개체를 만드는 경우 0이 아니며, CKeyboardManager 개체가 이미 존재하는 경우 0입니다.

설명

CWinAppEx::GetKeyboardManager를 호출하면 해당 메서드의 기본 구현이 InitKeyboardManager를 호출합니다.

애플리케이션에 이미 키보드 관리자가 있고 InitKeyboardManager를 호출하면 애플리케이션에 ASSERT 오류가 발생합니다. 따라서 CKeyboardManager 개체를 직접 만드는 경우에는 InitKeyboardManager를 호출하면 안 됩니다. 사용자 지정 CKeyboardManager를 사용하지 않는 경우 GetKeyboardManager를 사용하여 CKeyboardManager 개체를 만들어야 합니다.

CWinAppEx::InitMouseManager

초기화는 CMouseManager 개체입니다.

BOOL InitMouseManager();

Return Value

메서드가 CMouseManager 개체를 만드는 경우 0이 아니며, CMouseManager 개체가 이미 존재하는 경우 0입니다.

설명

CWinAppEx::GetMouseManager를 호출하면 해당 메서드의 기본 구현이 InitMouseManager를 호출합니다.

애플리케이션에 이미 마우스 관리자가 있고 InitMouseManager를 호출하면 애플리케이션에 ASSERT 오류가 발생합니다. 따라서 CMouseManager 개체를 직접 만드는 경우에는 InitMouseManager를 호출하면 안 됩니다. 사용자 지정 CMouseManager를 사용하지 않는 경우 GetMouseManager를 사용하여 CMouseManager 개체를 만들어야 합니다.

CWinAppEx::InitShellManager

초기화는 CShellManager 개체입니다.

BOOL InitShellManager();

Return Value

메서드가 CShellManager 개체를 만드는 경우 0이 아니며, CShellManager 개체가 이미 존재하는 경우 0입니다.

설명

CWinAppEx::GetShellManager를 호출하면 해당 메서드의 기본 구현이 InitShellManager를 호출합니다.

애플리케이션에 이미 셸 관리자가 있고 InitShellManager를 호출하면 애플리케이션에서 ASSERT 오류가 발생합니다. 따라서 CShellManager 개체를 직접 만드는 경우에는 InitShellManager를 호출하지 마세요. 사용자 지정 CShellManager를 사용하지 않는 경우 GetShellManager를 사용하여 CShellManager 개체를 만듭니다.

CWinAppEx::InitTooltipManager

초기화는 CTooltipManager 개체입니다.

BOOL InitTooltipManager();

Return Value

메서드가 CTooltipManager 개체를 만드는 경우 0이 아니며, CTooltipManager 개체가 이미 존재하는 경우 0입니다.

설명

CWinAppEx::GetTooltipManager를 호출하면 해당 메서드의 기본 구현이 InitTooltipManager를 호출합니다.

애플리케이션에 이미 도구 설명 관리자가 있고 InitTooltipManager를 호출하면 애플리케이션에 ASSERT 오류가 발생합니다. 따라서 CTooltipManager 개체를 직접 만드는 경우에는 InitTooltipManager를 호출하면 안 됩니다. 사용자 지정 CTooltipManager를 사용하지 않는 경우 GetTooltipManager를 사용하여 CTooltipManager 개체를 만들어야 합니다.

CWinAppEx::IsResourceSmartUpdate

BOOL IsResourceSmartUpdate() const;

Return Value

설명

CWinAppEx::IsStateExists

지정된 키가 레지스트리에 있는지 여부를 나타냅니다.

BOOL IsStateExists(LPCTSTR lpszSectionName);

매개 변수

lpszSectionName
진행 레지스트리 키의 경로가 포함된 문자열입니다.

Return Value

키가 레지스트리에 있는 경우 0이 아니며, 그렇지 않은 경우 0입니다.

CWinAppEx::LoadCustomState

프레임워크는 레지스트리에서 애플리케이션 상태를 로드한 후 이 메서드를 호출합니다.

virtual void LoadCustomState();

설명

애플리케이션이 레지스트리에서 상태를 로드한 후 처리를 수행하려면 이 메서드를 재정의합니다. 기본적으로 이 메서드는 아무것도 수행하지 않습니다.

레지스트리에서 사용자 지정 상태 정보를 로드하려면 먼저 CWinAppEx::SaveCustomState를 사용하여 정보를 저장해야 합니다.

CWinAppEx::LoadState

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

매개 변수

pFrame
[in] 프레임 창 개체에 대한 포인터입니다. 메서드는 레지스트리의 상태 정보를 이 프레임 창에 적용합니다.

lpszSectionName
[in] 레지스트리 키의 상대 경로를 포함하는 문자열입니다.

pFrameImpl
[in] CFrameImpl 개체에 대한 포인터입니다. 메서드는 레지스트리의 상태 정보를 이 프레임 창에 적용합니다.

Return Value

성공하는 경우 0이 아닌 값입니다. 그렇지 않은 경우 0입니다.

설명

이 메서드는 애플리케이션 상태와 프레임 창에 대한 모든 상태 정보를 로드합니다. 프레임 창에 로드된 정보는 제공된 프레임 창에 적용됩니다. 프레임 창을 제공하지 않으면 애플리케이션 상태 정보만 로드됩니다. 애플리케이션 정보에는 CMouseManager 클래스, CContextMenuManager 클래스, CKeyboardManager 클래스CUserToolsManager 클래스의 상태가 포함됩니다.

CFrameImpl::OnLoadFrame의 기본 구현은 LoadState를 호출합니다.

lpszSectionName 매개 변수는 레지스트리 항목의 절대 경로가 아닙니다. 이는 애플리케이션의 기본 레지스트리 키 끝에 추가되는 상대 경로입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

CWinAppEx::LoadWindowPlacement

레지스트리에서 기본 프레임 창의 크기와 위치를 로드할 때 프레임워크에 의해 호출됩니다.

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

매개 변수

rectNormalPosition
[out] 복원된 위치에 있을 때 메인 프레임 창의 좌표를 포함하는 직사각형입니다.

nFlags
[out] 최소화된 창의 위치와 운영 체제가 최소화된 창과 복원된 창 사이를 전환하는 방법을 제어하는 플래그입니다.

nShowCmd
[out] 창의 표시 상태를 지정하는 정수입니다. 가능한 값에 대한 자세한 내용은 CWnd::ShowWindow를 참조하세요.

Return Value

성공하는 경우 0이 아닌 값입니다. 그렇지 않은 경우 0입니다.

설명

기본적으로 MFC는 애플리케이션이 시작될 때 메인 프레임 창의 이전 위치와 상태를 자동으로 로드합니다. 이 정보가 레지스트리에 저장되는 방법에 대한 자세한 내용은 CWinAppEx::StoreWindowPlacement를 참조하세요.

메인 프레임 창에 대한 추가 정보를 로드하려면 이 메서드를 재정의합니다.

CWinAppEx::m_bForceImageReset

도구 모음이 포함된 프레임 창을 다시 로드할 때 프레임워크가 모든 도구 모음 이미지를 다시 설정하는지 여부를 지정합니다.

BOOL m_bForceImageReset;

설명

m_bForceImageReset 데이터 멤버는 보호된 변수입니다.

CWinAppEx::OnAppContextHelp

사용자가 사용자 지정 대화 상자에 대한 상황별 도움말을 요청할 때 프레임워크는 이 메서드를 호출합니다.

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

매개 변수

pWndControl
[in] 진행 사용자가 컨텍스트 도움말을 호출한 창 개체에 대한 포인터입니다.

dwHelpIDArray[]
[in] 진행 예약된 값입니다.

설명

이 방법은 현재 향후 사용을 위해 예약되어 있습니다. 기본 구현은 아무 작업도 수행하지 않으며 현재 프레임워크에서 호출되지 않습니다.

CWinAppEx::OnClosingMainFrame

프레임워크는 프레임 창이 WM_CLOSE를 처리 중일 때 이 메서드를 호출합니다.

virtual void OnClosingMainFrame(CFrameImpl* pFrameImpl);

매개 변수

pFrameImpl
[in] CFrameImpl 개체에 대한 포인터입니다.

설명

이 메서드의 기본 구현은 pFrameImpl의 상태를 저장합니다.

CWinAppEx::OnViewDoubleClick

사용자가 해당 보기 내의 아무 곳이나 두 번 클릭하면 해당 보기와 연관된 사용자 정의 명령을 호출합니다.

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

매개 변수

pWnd
[in] CView 클래스에서 파생된 개체에 대한 포인터입니다.

iViewId
[in] 진행 보기 ID입니다.

Return Value

프레임워크가 명령을 찾은 경우 TRUE이며, 그러지 않은 경우 FALSE입니다.

설명

사용자 지정 마우스 동작을 지원하려면 WM_LBUTTONDBLCLK 메시지를 처리할 때 이 함수를 호출해야 합니다. 이 메서드는 iViewId에서 제공한 보기 ID와 연관된 명령을 실행합니다. 사용자 지정 마우스 동작에 대한 자세한 내용은 키보드 및 마우스 사용자 지정을 참조하세요.

CWinAppEx::OnWorkspaceIdle

virtual BOOL OnWorkspaceIdle(CWnd*);

매개 변수

[in] CWnd*\

Return Value

설명

CWinAppEx::PreLoadState

프레임워크는 레지스트리에서 애플리케이션 상태를 로드하기 직전에 이 메서드를 호출합니다.

virtual void PreLoadState();

설명

프레임워크가 애플리케이션 상태를 로드하기 전에 즉시 처리를 수행하려면 이 메서드를 재정의합니다.

CWinAppEx::PreSaveState

프레임워크는 애플리케이션 상태를 저장하기 직전에 이 메서드를 호출합니다.

virtual void PreSaveState();

설명

프레임워크가 애플리케이션 상태를 저장하기 직전에 처리를 수행하려면 이 메서드를 재정의합니다.

CWinAppEx::ReloadWindowPlacement

레지스트리에서 창의 크기와 위치를 다시 로드합니다.

virtual BOOL ReloadWindowPlacement(CFrameWnd* pFrame);

매개 변수

pFrame
[in] 프레임 창에 대한 포인터입니다.

Return Value

메서드가 성공한 경우 0이 아니며, 로드에 실패했거나 로드할 데이터가 없는 경우 0입니다.

설명

창의 크기와 위치를 레지스트리에 쓰려면 CWinAppEx::StoreWindowPlacement 함수를 사용합니다.

CWinAppEx::SaveCustomState

프레임워크는 애플리케이션 상태를 레지스트리에 저장한 후 이 메서드를 호출합니다.

virtual void SaveCustomState();

설명

애플리케이션이 상태를 레지스트리에 저장한 후 처리를 수행하려면 이 메서드를 재정의합니다. 기본적으로 이 메서드는 아무것도 수행하지 않습니다.

CWinAppEx::SaveState

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

매개 변수

lpszSectionName
[in] 레지스트리 키의 상대 경로를 포함하는 문자열입니다.

pFrameImpl
[in] CFrameImpl 개체에 대한 포인터입니다. 이 프레임은 Windows 레지스트리에 저장됩니다.

pFrame
[in] 프레임 창 개체에 대한 포인터입니다. 이 프레임은 Windows 레지스트리에 저장됩니다.

Return Value

성공하면 TRUE이며, 그렇지 않으면 FALSE입니다.

설명

이 메서드는 애플리케이션의 상태와 제공된 프레임 창에 대한 모든 상태 정보를 저장합니다. 프레임 창을 제공하지 않으면 메서드는 애플리케이션 상태만 저장합니다. 애플리케이션 정보에는 CMouseManager 클래스, CContextMenuManager 클래스, CKeyboardManager 클래스CUserToolsManager 클래스의 상태가 포함됩니다.

lpszSectionName 매개 변수는 레지스트리 항목의 절대 경로가 아닙니다. 이는 애플리케이션의 기본 레지스트리 키 끝에 추가되는 상대 경로입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

CWinAppEx::SetRegistryBase

애플리케이션의 기본 레지스트리 경로를 설정합니다.

LPCTSTR SetRegistryBase(LPCTSTR lpszSectionName = NULL);

매개 변수

lpszSectionName
[in] 레지스트리 키의 경로를 포함하는 문자열입니다.

Return Value

기본 레지스트리 위치의 경로가 포함된 문자열입니다.

설명

레지스트리에 액세스하는 CWinAppEx 클래스의 모든 메서드는 기본 위치에서 시작됩니다. 기본 레지스트리 위치를 변경하려면 이 방법을 사용합니다. 기본 레지스트리 위치를 검색하려면 CWinAppEx::GetRegistryBase를 사용합니다.

CWinAppEx::ShowPopupMenu

팝업 메뉴를 표시합니다.

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

매개 변수

uiMenuResId
[in] 진행 메뉴 리소스 ID입니다.

point
[in] 진행 화면 좌표에서 메뉴 위치를 지정하는 CPoint입니다.

pWnd
[in] 진행 팝업 메뉴를 소유하는 창에 대한 포인터입니다.

Return Value

팝업 메뉴가 성공적으로 표시된 경우 0이 아니며, 그렇지 않은 경우 0입니다.

설명

이 메서드는 uiMenuResId와 연관된 메뉴를 표시합니다.

팝업 메뉴를 지원하려면 CContextMenuManager 개체가 있어야 합니다. CContextMenuManager 개체를 초기화하지 않은 경우 ShowPopupMenu는 실패합니다.

CWinAppEx::StoreWindowPlacement

메인 프레임 창의 크기와 위치를 레지스트리에 쓰기 위해 프레임워크에서 호출됩니다.

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

매개 변수

nFlags
[in] 진행 최소화된 창의 위치와 운영 체제가 최소화된 창과 복원된 창 사이를 전환하는 방법을 제어하는 플래그입니다.

nShowCmd
[in] 창의 표시 상태를 지정하는 정수입니다. 가능한 값에 대한 자세한 내용은 CWnd::ShowWindow를 참조하세요.

rectNormalPosition
[in] 진행 복원된 상태일 때 메인 프레임 창의 좌표를 포함하는 사각형입니다.

Return Value

성공하는 경우 0이 아닌 값입니다. 그렇지 않은 경우 0입니다.

설명

기본적으로 MFC는 애플리케이션이 종료되기 전에 메인 프레임 창의 위치와 상태를 자동으로 저장합니다. 이 정보는 애플리케이션의 기본 레지스트리 위치에 있는 WindowPlacement 키 아래의 Windows 레지스트리에 저장됩니다. 애플리케이션의 기본 레지스트리 위치에 대한 자세한 내용은 CWinAppEx::GetRegistryBase를 참조하세요.

메인 프레임 창에 대한 추가 정보를 저장하려면 이 메서드를 재정의합니다.

CWinAppEx::WriteBinary

레지스트리에 이진 데이터를 씁니다.

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

매개 변수

lpszEntry
진행 레지스트리 키의 이름이 포함된 문자열입니다.

pData
[in] 진행 저장할 데이터입니다.

nBytes
[in] pData의 크기(바이트)입니다.

Return Value

이 메서드가 성공적으로 수행되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

lpszEntry 매개 변수는 애플리케이션의 기본 레지스트리 키 아래에 있는 레지스트리 항목의 이름입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

lpszEntry에 의해 지정된 키가 존재하지 않으면 이 메서드가 키를 만듭니다.

CWinAppEx::WriteInt

숫자 데이터를 레지스트리에 씁니다.

BOOL WriteInt(
    LPCTSTR lpszEntry,
    int nValue);

매개 변수

lpszEntry
진행 레지스트리 키의 이름이 포함된 문자열입니다.

nValue
[in] 진행 저장할 데이터입니다.

Return Value

이 메서드가 성공적으로 수행되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

lpszEntry 매개 변수는 애플리케이션의 기본 레지스트리 키 아래에 있는 레지스트리 항목의 이름입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

lpszEntry에 의해 지정된 키가 존재하지 않으면 이 메서드가 키를 만듭니다.

CWinAppEx::WriteObject

CObject 클래스에서 파생된 데이터를 레지스트리에 씁니다.

BOOL WriteObject(
    LPCTSTR lpszEntry,
    CObject& obj);

매개 변수

lpszEntry
[in] 설정할 값이 포함된 문자열입니다.

obj
[in] 진행 메서드가 저장할 CObject 데이터에 대한 참조입니다.

Return Value

이 메서드가 성공적으로 수행되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

이 메서드는 기본 레지스트리 키 아래의 지정된 값에 obj 데이터를 씁니다. 현재 레지스트리 키를 확인하려면 CWinAppEx::GetRegistryBase를 사용합니다.

CWinAppEx::WriteSectionBinary

레지스트리의 값에 이진 데이터를 씁니다.

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

매개 변수

lpszSubSection
[in] 진행 레지스트리 키 이름이 포함된 문자열입니다.

lpszEntry
[in] 설정할 값이 포함된 문자열입니다.

pData
[in] 진행 레지스트리에 쓸 데이터입니다.

nBytes
[in] pData의 크기(바이트)입니다.

Return Value

이 메서드가 성공적으로 수행되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

lpszSubSection 매개 변수는 레지스트리 항목의 절대 경로가 아닙니다. 이는 애플리케이션의 기본 레지스트리 키 끝에 추가되는 상대 경로입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

lpszEntry에 의해 지정된 키가 존재하지 않으면 이 메서드가 키를 만듭니다.

CWinAppEx::WriteSectionInt

숫자 데이터를 레지스트리에 씁니다.

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

매개 변수

lpszSubSection
[in] 레지스트리 키의 상대 경로를 포함하는 문자열입니다.

lpszEntry
[in] 설정할 값이 포함된 문자열입니다.

nValue
[in] 진행 레지스트리에 쓸 데이터입니다.

Return Value

이 메서드가 성공적으로 수행되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

lpszSubSection 매개 변수는 레지스트리 항목의 절대 경로가 아닙니다. 이는 애플리케이션의 기본 레지스트리 키에 추가되는 상대 경로입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

lpszEntry에 의해 지정된 키가 존재하지 않으면 이 메서드가 키를 만듭니다.

CWinAppEx::WriteSectionObject

CObject 클래스에서 파생된 데이터를 특정 레지스트리 값에 씁니다.

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

매개 변수

lpszSubSection
진행 레지스트리 키의 이름이 포함된 문자열입니다.

lpszEntry
[in] 설정할 값의 이름이 포함된 문자열입니다.

obj
[in] 진행 저장할 데이터입니다.

Return Value

이 메서드가 성공적으로 수행되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

lpszSubSection 매개 변수는 레지스트리 항목의 절대 경로가 아닙니다. 이는 애플리케이션의 기본 레지스트리 키 끝에 추가되는 상대 경로입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

lpszEntry에 의해 지정된 값이 lpszSubSection에 의해 지정된 레지스트리 키 아래에 존재하지 않는 경우 이 메서드는 해당 값을 만듭니다.

CWinAppEx::WriteSectionString

문자열 데이터를 레지스트리의 값에 씁니다.

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

매개 변수

lpszSubSection
진행 레지스트리 키의 이름이 포함된 문자열입니다.

lpszEntry
[in] 설정할 값이 포함된 문자열입니다.

lpszValue
[in] 레지스트리에 쓸 문자열 데이터입니다.

Return Value

이 메서드가 성공적으로 수행되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

lpszSubSection 매개 변수는 레지스트리 항목의 절대 경로가 아닙니다. 이는 애플리케이션의 기본 레지스트리 키 끝에 추가되는 상대 경로입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

lpszEntry에 의해 지정된 값이 lpszSubSection 아래에 없으면 이 메서드가 값을 만듭니다.

CWinAppEx::WriteString

문자열 데이터를 레지스트리에 씁니다.

BOOL WriteString(
    LPCTSTR lpszEntry,
    LPCTSTR lpszValue);

매개 변수

lpszEntry
진행 레지스트리 키의 이름이 포함된 문자열입니다.

lpszValue
[in] 진행 저장할 데이터입니다.

Return Value

이 메서드가 성공적으로 수행되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

lpszEntry 매개 변수는 애플리케이션의 기본 레지스트리 키 아래에 있는 레지스트리 항목의 이름입니다. 기본 레지스트리 키를 가져오거나 설정하려면 각각 CWinAppEx::GetRegistryBaseCWinAppEx::SetRegistryBase 메서드를 사용합니다.

lspzEntry에 의해 지정된 키가 존재하지 않으면 이 메서드가 키를 만듭니다.

참고 항목

계층 구조 차트
클래스
CWinApp 클래스
CMouseManager 클래스
CContextMenuManager 클래스
CKeyboardManager 클래스
CUserToolsManager 클래스