Windows/MFC
CWinApp Class
aucd29
2013. 10. 2. 17:57
- CWinApp 클래스는 윈도우에서 수행되는 애플리케이션의 객체를 파생하기 위한 베이스 클래스이다.
데이터 멤버
m_pszAppName : 애플리케이션의 이름을 지정한다.
m_hInstance : 애플리케이션의 현재 인스턴스에 대한 핸들
m_hPrevInstance : 32비트 애플리케이션에서는 NULL로 설정된다.
m_lpCmdLine : 애플리케이션을 수행하기 위한 위한 명령행 문자열로 널 문자로 끝난다.
m_nCmdShow : 초기 윈도우가 어떻게 표시되는지를 지정한다.
m_bHelpMode : 사용자가 도움말 모드에 있는지를 알려준다.(shift + F1으로 호출)
m_pActiveWnd : OLE서버가 in-place모드로 활성화될 때 컨테이녀 애플리케이션의 메인 윈도에 대한 포인터이다.
m_pszExeName : 애플리케이션의 모듈명
m_pszHelpFilePath : 도움말 파일의 경로명
m_pazProfileName : 애플리케이션에서 사용되는 INI파일명
m_pszRegistrykey : 애플리케이션의 프로파일 설정 상태를 저장하기 위한 완전한 형태의 레지스트리 키를 지정하기 위해서 사용된다.
생성관련함수
CWinApp : CWinApp객체를 생성한다.
역할
LoadCuror : 커서 리소스를 읽어들인다.
LoadStandardCursor : WINDOWS.H 해더파일에서 이미 IDC_상수로 정의되어 있는 커서를 읽어 들인다.
LoadOEMCursor : WINDOWS.H 해더파일에서 윈도우 OEM에 이미 OCR_상수로 정의되어 있는 커서를 읽어 들인다.
LoadIcon : 아이콘 리소스를 읽어 들인다.
LoadStandardIcon : WINDOWS.H 해더파일에서 윈도우에 이미 IDI_ 상수로 정의되어있는 아이콘을 읽어 들인다.
LoadOEMIcon : WINDOWS.H 해더파일에서 윈도우 OEM에 이미 OIC_상수로 정의되어 있는 아이콘을 읽어 들인다.
RunAutomated : /Automation 옵션에 대해서 애플리케이션의 명령행 옵션의 전달을 테스트한다.
(CCommandLineInfo::m_bRunEmbedded에 있는 값을 이용하는 것이 더 낫다.)
RunEmbedded : /Embedding 옵션에 대해서 애플리케이션의 명령행 전달을 테스트한다.
(CCommandLineInfo::m_bRunEmbedded에 있는 값을 이용하는 것이 더 낫다.) ParseCommandLine : 명령행 문자열에서 피라미터와 플래그를 parsing한다.
ProcessShellCommand : 명령행 문자열에서 피라미터와 플래그를 처리한다.
GetProfileInt : 애플리케이션의 .INI 파일로부터 정수 값을 읽는다.
WriteProfileInt : 애플리케이션의 .INI 파일에 정수 값을 적는다.
GetProfileString : 애플리케이션의 .INI 파일로부터 문자열을 읽는다.
WriteProfileString : 애플리케이션의 .INI 파일에 문자열을 적는다.
AddDocTemplate : 애플리케이션에서 사용 가능한 문서 템플릿의 리스트에 문서 템플릿을 추가한다.
GetFirstDocTemplatePosition : 첫 번째 문서 템플릿으 위치를 얻어낸다.
GetNextDocTemplate : 문서 템플릿의 위치를 얻어낸다. (반복사용가능)
OpenDocumentFile : 파일에서 문서를 열기 위해서 프레임워크에 의해 호출된다.
AddToRecentFileList : 최근에 사용되었던 파일들의 리스트에 파일명을 추가한다. 최근 에 사용되었던 파일을 MRU파일이라고도 한다.
SelectPrinter : 프린터 대화상자를 통해서 사용자가 전에 지정한 프린터를 선택한다.
CreatePrinterDC : 프린터의 디바이스 컨테스트를 생성한다.
GetPrintDeviceDefaultsD : 프린터의 기본설정 값을 얻어낸다.
오버라이드 가능한 함수
InitApplication : 애플리케이션 수준의 초기화 작업을 수행할 때 오버라이드한다.
InitInstance : 윈도우 객체를 생성하는 것처럼 윈도우 시스템에서 사용하는 인스턴스에 대해서 초기화 작업을 수행하는 경우에 오버라이드한다.
Run : 디폴트 메시지 루프를 실행한다. 메시지 루프를 다른 방식으로 수행하기를 원하면 이 함수를 오버라이드한다.
OnIdle : 애플리케이션의 idle time에 작업을 수행하려면 오버라이드한다.
ExitInstance : 애플리케이션이 종료될 때 수행하려는 작업이 있으면 오버라이드한다.
HideApplication : 모든 문서를 닫기 전에 애플리케이션을 숨긴다.
CloseAllDocuments : 모든 문서를 닫는다.
PreTranslateMessage : 메시지가 윈도우 함수 ::TranslateMessage와 DispatchMessage로 보내기 전에 메시지를 필터링한다.
SaveAllModified : 수정된 모든 문서들을 저장한다고 사용자에게 알려준다.
DoMessageBox : 애플리케이션에서 AfxMessageBox를 구현한다.
ProcessMessageFilter : 어떤 메시지가 애플리케이션으로 보내지기 전에 가로챈다. ProcessWndProcException : 애플리케이션의 메시지가 명령 핸들러에 의해서 넘겨진 처리 되지 않은 모든 예외들을 처리한다.
DoWaitCuror : 대기 중임을 나타내는 커서(보통 모래시계 모양)를 출력하거나, 사라지게 한다.
OnDDECommand : DDE(Dynamic Data Exchange)를 실행한다는 명령에 대응하여 프레임워크 가 직접 호출한다.
WinHelp : 윈도우 함수인 WinHelp를 호출한다.
초기화 관련 함수
LoadStdProfileSettintgs : 표준 .INI파일에 설정된 값을 읽어들이고 최근에 사용한 파 일들의 목록을 유지하다.
SetDialogBkColor : 대화상자와 메시지 출력 상자의 기본 배경색을 지정한다.
SetRegistryKey : 애플리케이션의 설정 값들이 .INI파일 대신에 레지스트리에 저장되도 록 한다.
EnableShellOpen : 사용자가 파일 관리자에서 테이터 파일을 열 수 있도록 한다.
RegisterShellFileTypes : 파일 관리자에게 모든 문서의 타입을 등록한다.
Enable3dControls : 컨트롤의 모양이 3차원 형태를 하도록 한다.
Enable3dControlsStatic : 컨트롤의 모양이 3차원 형태를 하도록 한다.
명령 핸들러 관련 함수
OnFileNew : ID_FILE_NEW 명령을 수행한다.
OnFileOpen : ID_FILE_OPEN 명령을 수행한다.
OnFilePrintSetup : ID_FILE_PRINT_SETUP 명령을 수행한다.
OnContextHelp : 애플리케이션의 SHIFT+F1 키를 핸들링한다.
OnHelp : 애플리케이션에서 F1 키를 누를 경우 도움말의 수행을 핸들링한다.
OnHelpIndex : ID_HELP_INDEX 명령을 핸들링한다.
OnHelpFinder : ID_HELP_FINDER 명령과 ID_DEFAULT_HELP 명령을 핸들링한다.
OnHelpUsing : ID_HELP_USING 명령을 핸들링한다.
데이터 멤버
m_pszAppName : 애플리케이션의 이름을 지정한다.
m_hInstance : 애플리케이션의 현재 인스턴스에 대한 핸들
m_hPrevInstance : 32비트 애플리케이션에서는 NULL로 설정된다.
m_lpCmdLine : 애플리케이션을 수행하기 위한 위한 명령행 문자열로 널 문자로 끝난다.
m_nCmdShow : 초기 윈도우가 어떻게 표시되는지를 지정한다.
m_bHelpMode : 사용자가 도움말 모드에 있는지를 알려준다.(shift + F1으로 호출)
m_pActiveWnd : OLE서버가 in-place모드로 활성화될 때 컨테이녀 애플리케이션의 메인 윈도에 대한 포인터이다.
m_pszExeName : 애플리케이션의 모듈명
m_pszHelpFilePath : 도움말 파일의 경로명
m_pazProfileName : 애플리케이션에서 사용되는 INI파일명
m_pszRegistrykey : 애플리케이션의 프로파일 설정 상태를 저장하기 위한 완전한 형태의 레지스트리 키를 지정하기 위해서 사용된다.
생성관련함수
CWinApp : CWinApp객체를 생성한다.
역할
LoadCuror : 커서 리소스를 읽어들인다.
LoadStandardCursor : WINDOWS.H 해더파일에서 이미 IDC_상수로 정의되어 있는 커서를 읽어 들인다.
LoadOEMCursor : WINDOWS.H 해더파일에서 윈도우 OEM에 이미 OCR_상수로 정의되어 있는 커서를 읽어 들인다.
LoadIcon : 아이콘 리소스를 읽어 들인다.
LoadStandardIcon : WINDOWS.H 해더파일에서 윈도우에 이미 IDI_ 상수로 정의되어있는 아이콘을 읽어 들인다.
LoadOEMIcon : WINDOWS.H 해더파일에서 윈도우 OEM에 이미 OIC_상수로 정의되어 있는 아이콘을 읽어 들인다.
RunAutomated : /Automation 옵션에 대해서 애플리케이션의 명령행 옵션의 전달을 테스트한다.
(CCommandLineInfo::m_bRunEmbedded에 있는 값을 이용하는 것이 더 낫다.)
RunEmbedded : /Embedding 옵션에 대해서 애플리케이션의 명령행 전달을 테스트한다.
(CCommandLineInfo::m_bRunEmbedded에 있는 값을 이용하는 것이 더 낫다.) ParseCommandLine : 명령행 문자열에서 피라미터와 플래그를 parsing한다.
ProcessShellCommand : 명령행 문자열에서 피라미터와 플래그를 처리한다.
GetProfileInt : 애플리케이션의 .INI 파일로부터 정수 값을 읽는다.
WriteProfileInt : 애플리케이션의 .INI 파일에 정수 값을 적는다.
GetProfileString : 애플리케이션의 .INI 파일로부터 문자열을 읽는다.
WriteProfileString : 애플리케이션의 .INI 파일에 문자열을 적는다.
AddDocTemplate : 애플리케이션에서 사용 가능한 문서 템플릿의 리스트에 문서 템플릿을 추가한다.
GetFirstDocTemplatePosition : 첫 번째 문서 템플릿으 위치를 얻어낸다.
GetNextDocTemplate : 문서 템플릿의 위치를 얻어낸다. (반복사용가능)
OpenDocumentFile : 파일에서 문서를 열기 위해서 프레임워크에 의해 호출된다.
AddToRecentFileList : 최근에 사용되었던 파일들의 리스트에 파일명을 추가한다. 최근 에 사용되었던 파일을 MRU파일이라고도 한다.
SelectPrinter : 프린터 대화상자를 통해서 사용자가 전에 지정한 프린터를 선택한다.
CreatePrinterDC : 프린터의 디바이스 컨테스트를 생성한다.
GetPrintDeviceDefaultsD : 프린터의 기본설정 값을 얻어낸다.
오버라이드 가능한 함수
InitApplication : 애플리케이션 수준의 초기화 작업을 수행할 때 오버라이드한다.
InitInstance : 윈도우 객체를 생성하는 것처럼 윈도우 시스템에서 사용하는 인스턴스에 대해서 초기화 작업을 수행하는 경우에 오버라이드한다.
Run : 디폴트 메시지 루프를 실행한다. 메시지 루프를 다른 방식으로 수행하기를 원하면 이 함수를 오버라이드한다.
OnIdle : 애플리케이션의 idle time에 작업을 수행하려면 오버라이드한다.
ExitInstance : 애플리케이션이 종료될 때 수행하려는 작업이 있으면 오버라이드한다.
HideApplication : 모든 문서를 닫기 전에 애플리케이션을 숨긴다.
CloseAllDocuments : 모든 문서를 닫는다.
PreTranslateMessage : 메시지가 윈도우 함수 ::TranslateMessage와 DispatchMessage로 보내기 전에 메시지를 필터링한다.
SaveAllModified : 수정된 모든 문서들을 저장한다고 사용자에게 알려준다.
DoMessageBox : 애플리케이션에서 AfxMessageBox를 구현한다.
ProcessMessageFilter : 어떤 메시지가 애플리케이션으로 보내지기 전에 가로챈다. ProcessWndProcException : 애플리케이션의 메시지가 명령 핸들러에 의해서 넘겨진 처리 되지 않은 모든 예외들을 처리한다.
DoWaitCuror : 대기 중임을 나타내는 커서(보통 모래시계 모양)를 출력하거나, 사라지게 한다.
OnDDECommand : DDE(Dynamic Data Exchange)를 실행한다는 명령에 대응하여 프레임워크 가 직접 호출한다.
WinHelp : 윈도우 함수인 WinHelp를 호출한다.
초기화 관련 함수
LoadStdProfileSettintgs : 표준 .INI파일에 설정된 값을 읽어들이고 최근에 사용한 파 일들의 목록을 유지하다.
SetDialogBkColor : 대화상자와 메시지 출력 상자의 기본 배경색을 지정한다.
SetRegistryKey : 애플리케이션의 설정 값들이 .INI파일 대신에 레지스트리에 저장되도 록 한다.
EnableShellOpen : 사용자가 파일 관리자에서 테이터 파일을 열 수 있도록 한다.
RegisterShellFileTypes : 파일 관리자에게 모든 문서의 타입을 등록한다.
Enable3dControls : 컨트롤의 모양이 3차원 형태를 하도록 한다.
Enable3dControlsStatic : 컨트롤의 모양이 3차원 형태를 하도록 한다.
명령 핸들러 관련 함수
OnFileNew : ID_FILE_NEW 명령을 수행한다.
OnFileOpen : ID_FILE_OPEN 명령을 수행한다.
OnFilePrintSetup : ID_FILE_PRINT_SETUP 명령을 수행한다.
OnContextHelp : 애플리케이션의 SHIFT+F1 키를 핸들링한다.
OnHelp : 애플리케이션에서 F1 키를 누를 경우 도움말의 수행을 핸들링한다.
OnHelpIndex : ID_HELP_INDEX 명령을 핸들링한다.
OnHelpFinder : ID_HELP_FINDER 명령과 ID_DEFAULT_HELP 명령을 핸들링한다.
OnHelpUsing : ID_HELP_USING 명령을 핸들링한다.