AFX 메시지
이러한 메시지는 MFC에서 사용됩니다.
메시지
다음 표에서는 MFC 라이브러리에 사용되는 메시지를 나열합니다.
| 메시지 | 설명 | [in] wParam | lParam (달리 명시되지 않는 한 모든 매개 변수는 [in]입니다.) | Return Value |
|---|---|---|---|---|
| AFX_WM_ACCGETOBJECT | 사용되지 않습니다. | 사용되지 않습니다. | 해당 사항 없음 | 해당 사항 없음 |
| AFX_WM_ACCGETSTATE | 접근성 지원에 사용됩니다. 이 메시지를 CMFCPopupMenu 보내거나 CMFCRibbonPanelMenu 현재 요소의 상태를 검색합니다. |
메뉴 단추 또는 구분 기호일 수 있는 요소의 인덱스입니다. | 사용되지 않습니다. | 요소 상태입니다. 인덱스가 잘못된 경우 -1이고, 메뉴 단추에 특별한 특성이 없으면 0입니다. 그렇지 않으면 다음 플래그의 조합입니다. TBBS_DISABLED — 항목이 비활성화됨 TBBS_CHECKED — 항목이 선택되어 있습니다. TBBS_BUTTON - 항목이 표준 푸시버튼입니다. TBBS_PRESSED — 단추를 눌렀습니다. TBBS_INDETERMINATE - 정의되지 않은 상태 TBBS_SEPARATOR - 메뉴 단추 대신 이 요소는 다른 메뉴 항목 간의 구분을 형성합니다. |
| AFX_WM_CHANGE_ACTIVE_TAB | 프레임워크는 이 메시지를 크기 조정 가능한 컨트롤 막대 컨트롤로 보냅니다. 사용자가 활성 탭을 변경할 때 개체에서 CMFCTabCtrl 알림을 받도록 이 메시지를 처리합니다. |
탭의 인덱스입니다. | 사용되지 않습니다. | 0이 아닌 값입니다. |
| AFX_WM_CHANGE_CURRENT_FOLDER | 프레임워크는 사용자가 현재 폴더를 변경한 경우의 CMFCShellListCtrl 부모에 이 메시지를 보냅니다. |
사용되지 않습니다. | 사용되지 않습니다. | 사용되지 않습니다. |
| AFX_WM_CHANGEVISUALMANAGER | 프레임워크는 사용자가 현재 Visual Manager를 변경할 때 모든 프레임 창에 이 메시지를 보냅니다. 이 메시지에 대한 응답으로 프레임 창은 해당 영역을 다시 계산하고 필요에 따라 다른 매개 변수를 조정합니다. 이 이벤트에 대한 알림을 받아야 하는 경우 애플리케이션에서 AFX_WM_CHANGEVISUALMANAGER 메시지를 처리할 수 있습니다. 기본 클래스 처리기(OnChangeVisualManager)를 호출하여 프레임워크의 이 이벤트 내부 처리가 수행되도록 해야 합니다. |
사용되지 않습니다. | 사용되지 않습니다. | 사용되지 않습니다. |
| AFX_WM_CHANGING_ACTIVE_TAB | 개체의 부모 CMFCTabCtrl 로 전송됩니다. 사용자가 탭을 다시 설정할 때 개체로부터 CMFCTabCtrl 알림을 받으려면 이 메시지를 처리합니다. |
활성화되는 탭의 인덱스입니다. | 사용되지 않습니다. | 0이 아닌 값입니다. |
| AFX_WM_CHECKEMPTYMINIFRAME | 내부 전용. | 해당 사항 없음 | 해당 사항 없음 | 해당 사항 없음 |
| AFX_WM_CREATETOOLBAR | CMFCToolBarsListPropertyPage 사용자가 사용자 지정 프로세스 중에 새 도구 모음을 만들 때 전송됩니다. 이 메시지를 처리하여 사용자 지정 CMFCToolBar 파생 개체를 인스턴스화할 수 있습니다. 이 메시지를 처리하고 고유한 도구 모음을 만드는 경우 기본 처리기에 대한 호출을 생략합니다. |
사용되지 않습니다. | 도구 모음의 이름을 포함하는 문자열에 대한 포인터입니다. | 새로 만든 도구 모음에 대한 포인터입니다. NULL은 도구 모음 만들기가 취소되었음을 나타냅니다. |
| AFX_WM_CUSTOMIZEHELP | 사용자가 도움말 단추 또는 F1 키를 누를 때 사용자 지정 속성 시트 CMFCToolbarCustomize Dialog 에서 주 프레임 창으로 전송됩니다. |
사용자 지정 속성 시트의 활성 페이지를 지정합니다. | CMFCToolbarCustomize Dialog 개체에 대한 포인터입니다. |
단계 없음. |
| AFX_WM_CUSTOMIZETOOLBAR | 사용자가 CMFCToolbarCustomize Dialog 새 도구 모음을 만들고 있음을 부모 프레임에 알리기 위해 이 메시지를 보냅니다. |
사용자 지정이 시작되면 TRUE이고 사용자 지정이 완료되면 FALSE입니다. | 사용되지 않습니다. | 단계 없음. |
| AFX_WM_DELETETOOLBAR | 사용자가 사용자 지정 모드에서 도구 모음을 삭제하려고 할 때 주 프레임 창으로 전송됩니다. 사용자가 사용자 지정 모드에서 도구 모음을 삭제할 때 추가 작업을 수행하도록 이 메시지를 처리합니다. 또한 도구 모음을 삭제하는 기본 처리기( OnToolbarDelete)를 호출해야 합니다. 기본 처리기는 도구 모음을 삭제할 수 있는지 여부를 나타내는 값을 반환합니다. |
사용되지 않습니다. | 삭제할 개체에 대한 CMFCToolBar 포인터입니다. |
도구 모음을 삭제할 수 없는 경우 0이 아닌 경우 그렇지 않으면 0입니다. |
| AFX_WM_GETDOCUMENTCOLORS | CMFCColorMenuButton 는 문서 색을 검색하기 위해 이 메시지를 주 프레임 창으로 보냅니다. |
사용되지 않습니다. | [in, out] 개체에 대한 포인터입니다 CList<COLORREF, COLORREF> . |
단계 없음. |
| AFX_WM_GETDRAGBOUNDS | 내부 전용. | 해당 사항 없음 | 해당 사항 없음 | 해당 사항 없음 |
| AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM | 사용자가 리본 목록 항목을 강조 표시할 때 주 프레임 창으로 전송됩니다. | 강조 표시된 항목의 인덱스 | 에 대한 포인터 CMFCBaseRibbonElement |
사용되지 않습니다. |
| AFX_WM_ON_AFTER_SHELL_COMMAND | 사용자가 셸 명령 실행을 완료할 때 부모 CMFCShellListCtrl 또는 CMFCShellTreeCtrl 컨트롤로 전송됩니다. |
사용자가 실행한 명령의 ID입니다. | 사용되지 않습니다. | 애플리케이션이 이 메시지를 처리하는 경우 0을 반환해야 합니다. |
| AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU | 프레임워크는 팝업 메뉴를 표시하기 전에 이 메시지를 리본의 부모로 보냅니다. 언제든지 이 메시지를 처리하고 팝업 메뉴를 수정할 수 있습니다. | 사용되지 않습니다. | 에 대한 포인터 CMFCBaseRibbonElement |
사용되지 않습니다. |
| AFX_WM_ON_CANCELTABMOVE | 내부 전용. | 해당 사항 없음 | 해당 사항 없음 | |
| AFX_WM_ON_CHANGE_RIBBON_CATEGORY | 프레임워크는 사용자가 활성 리본 컨트롤 범주를 변경할 때 이 메시지를 주 프레임으로 보냅니다. | 사용되지 않습니다. | 범주가 CMFCRibbonBar 변경된 포인터입니다. |
사용되지 않습니다. |
| AFX_WM_ON_CLOSEPOPUPWINDOW | 프레임워크는 이 메시지를 보내 창이 닫혀 있음을 소유자 CMFCDesktopAlertWnd 에게 알립니다. |
사용되지 않습니다. | 개체에 대한 CMFCDesktopAlertWnd 포인터입니다. |
사용되지 않습니다. |
| AFX_WM_ON_DRAGCOMPLETE | 내부 전용. | 해당 사항 없음 | 해당 사항 없음 | 해당 사항 없음 |
| AFX_WM_ON_GET_TAB_TOOLTIP | 사용자 지정 도구 설명이 사용하도록 설정된 경우 탭 창에 탭 도구 설명이 표시될 때 주 프레임 창으로 전송됩니다. | 사용되지 않습니다. | 구조체에 대한 포인터입니다 CMFCTabToolTipInfo . |
사용되지 않습니다. |
| AFX_WM_ON_HSCROLL | 크기 조정 가능한 컨트롤 막대 컨트롤로 전송됩니다. 탭 위젯 가로 스크롤 막대에서 스크롤 이벤트가 발생할 때 개체로부터 CMFCTabCtrl 알림을 받도록 이 메시지를 처리합니다. |
낮은 순서의 단어는 사용자의 스크롤 요청을 나타내는 스크롤 막대 값을 지정합니다. 자세한 내용은 이 항목 뒷부분에 나오는 표를 참조하십시오. | 사용되지 않습니다. | 0이 아닌 값입니다. |
| AFX_WM_ON_MOVE_TAB | 사용자가 탭을 새 위치로 끌 때 탭 창의 부모로 전송됩니다. | 원래 위치에 있는 탭의 인덱스(0부터 시작하는 인덱스)입니다. | [out] 새 위치에 있는 탭의 인덱스(0부터 시작하는 인덱스)입니다. | 단계 없음. |
| AFX_WM_ON_MOVETABCOMPLETE | 내부 전용. | 해당 사항 없음 | 해당 사항 없음 | 해당 사항 없음 |
| AFX_WM_ON_MOVETOTABGROUP | 사용자가 한 탭 그룹에서 다른 탭 그룹으로 MDI 자식 창을 이동할 때 주 프레임 창으로 전송됩니다. | MDI 자식 창이 제거된 탭 창(CMFCTabCtrl)에 대한 핸들입니다. |
[out] MDI 자식 창이 삽입된 탭 창(CMFCTabCtrl)에 대한 핸들입니다. |
무시됩니다. |
| AFX_WM_ON_PRESS_CLOSE_BUTTON | 사용자가 컨트롤 막대의 CDockablePane 캡션에서 닫기 단추를 클릭할 때 부모로 전송됩니다. |
사용되지 않습니다. | 사용자가 닫기 단추를 클릭한 도킹 가능한 창에 대한 포인터입니다. | 창을 닫을 수 없는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다. |
| AFX_WM_ON_RENAME_TAB | 사용자가 편집 가능한 탭의 이름을 바꾼 후 탭 창의 부모로 전송됩니다. | 이름이 바뀐 탭의 인덱스(0부터 시작하는 인덱스)입니다. | [out] 새 탭 이름을 포함하는 문자열에 대한 포인터입니다. | 애플리케이션이 이 메시지를 처리하는 경우 0이 아닌 경우 프레임워크는 .에 대한 호출 CMFCBaseTabCtrl::SetTabLabel을 표시하지 않습니다. 0이 반환 CMFCBaseTabCtrl::SetTabLabel 되면 프레임워크에서 호출됩니다. |
| AFX_WM_ON_RIBBON_CUSTOMIZE | 사용자가 사용자 지정을 시작할 때 부모 프레임으로 전송됩니다. 사용자 지정 대화 상자를 표시하려면 이 메시지를 처리합니다. | 사용되지 않습니다. | 사용자 지정할 리본 컨트롤에 대한 포인터입니다. | 애플리케이션이 이 메시지를 처리하고 자체 사용자 지정 대화 상자를 표시하는 경우 0이 아닌 경우 애플리케이션이 0을 반환하면 프레임워크에 기본 제공 사용자 지정 대화 상자가 표시됩니다. |
| AFX_WM_ON_TABGROUPMOUSEMOVE | 내부 전용. | 해당 사항 없음 | 해당 사항 없음 | 해당 사항 없음 |
| AFX_WM_POSTSETPREVIEWFRAME | 사용자가 인쇄 미리 보기 모드를 변경했음을 주 프레임에 알리기 위해 전송됨 | TRUE는 인쇄 미리 보기 모드가 설정되었음을 나타냅니다. FALSE는 인쇄 미리 보기 모드가 꺼져 있음을 나타냅니다. | 사용되지 않습니다. | 사용되지 않습니다. |
| AFX_WM_PROPERTY_CHANGED | 사용자가 선택한 속성의 값을 변경할 때 속성 그리드 컨트롤(CMFCPropertyGridCtrl)의 소유자에게 전송됩니다. |
속성 목록의 컨트롤 ID입니다. | 변경된 속성(CMFCPropertyGridProperty)에 대한 포인터입니다. |
사용되지 않습니다. |
| AFX_WM_RESETCONTEXTMENU | 사용자가 사용자 지정 중에 상황에 맞는 메뉴를 다시 설정할 때 주 프레임 창으로 전송됩니다. | 상황에 맞는 메뉴의 리소스 ID입니다. | 현재 상황에 맞는 메뉴에 대한 포인터입니다 CMFCPopupMenu. |
사용되지 않습니다. |
| AFX_WM_RESETKEYBOARD | 프레임워크는 사용자가 사용자 지정 중에 모든 키보드 가속기를 다시 설정할 때 이 메시지를 주 프레임 창으로 보냅니다. | 사용되지 않습니다. | 사용되지 않습니다. | 사용되지 않습니다. |
| AFX_WM_RESETMENU | 프레임워크는 사용자가 사용자 지정 중에 애플리케이션 프레임 메뉴를 다시 설정할 때 메뉴 소유자(프레임 창)에게 이 메시지를 보냅니다. | 메뉴 리소스 ID입니다. | 사용되지 않습니다. | 사용되지 않습니다. |
| AFX_WM_RESETPROMPT | 프레임워크는 사용자가 도구 모음 사용자 지정 대화 상자에서 도구 모음을 다시 설정할 때 이 메시지를 보냅니다. 기본 처리기에는 사용자가 도구 모음을 다시 설정할지 여부를 묻는 메시지 상자가 표시됩니다. | 사용되지 않습니다. | 사용되지 않습니다. | 사용되지 않습니다. |
| AFX_WM_RESETTOOLBAR | CMFCToolBar 개체는 도구 모음이 원래 상태로 복원될 때, 즉 리소스에서 로드될 때 이 메시지를 보냅니다. 이 메시지를 처리하여 클래스가 파생된 CMFCToolbarButton도구 모음 단추를 다시 삽입합니다. 자세한 내용은 CMFCToolbarComboBoxButton를 참조하세요. |
상태가 복원된 도구 모음의 리소스 ID입니다. | 사용되지 않습니다. | 단계 없음. |
| AFX_WM_SHOWREGULARMENU | CMFCToolbarMenuButton 개체는 사용자가 일반 메뉴 단추를 클릭할 때 소유자에게 이 메시지를 보냅니다. 사용자가 단추를 클릭할 때 팝업 메뉴를 표시하는 데 사용할 CMFCToolbarMenuButton 때마다 이 메시지를 처리합니다. |
메시지를 보내는 단추의 명령 ID입니다. | 커서의 화면 좌표입니다. 낮은 순서의 단어는 x 좌표를 지정합니다. 상위 단어는 y 좌표를 지정합니다. | 사용되지 않습니다. |
| AFX_WM_TOOLBARMENU | 마우스 포인터가 창의 클라이언트 또는 비 클라이언트 영역에 있는 동안 마우스의 오른쪽 단추를 놓으면 주 프레임 창으로 전송됩니다. | 사용되지 않습니다. | 마우스 포인터의 화면 좌표입니다. 낮은 순서의 단어는 x 좌표를 지정합니다. 상위 단어는 y 좌표를 지정합니다. | 애플리케이션이 이 메시지를 처리하는 경우 0입니다. 그렇지 않으면 0이 아닌 값입니다. |
| AFX_WM_UPDATETOOLTIPS | 도구 설명 컨트롤을 다시 만들어야 함을 나타내기 위해 모든 도구 설명 소유자에게 전송됩니다. | 이 메시지를 처리해야 하는 컨트롤의 형식입니다. 가능한 값 목록은 이 항목의 뒷부분에 있는 표를 참조하세요. | 사용되지 않습니다. | 사용되지 않습니다. |
| AFX_WM_WINDOW_HELP | CMFCWindowsManagerDialog사용자가 도움말 단추를 클릭하거나 도움말 캡션 단추 또는 F1 키를 클릭하여 도움말 모드로 전환할 때 이 메시지를 부모 프레임으로 보냅니다. |
사용되지 않습니다. | 의 인스턴스에 대한 포인터입니다 CMFCWindowsManagerDialog. |
사용되지 않습니다. |
다음 표에서는 AFX_WM_HSCROLL 메서드의 lParam 매개 변수에 대한 하위 단어 값을 보여줍니다.
| 값 | 의미 |
|---|---|
| SB_ENDSCROLL | 사용자가 스크롤을 종료합니다. |
| SB_LEFT | 사용자가 왼쪽 위까지 스크롤합니다. |
| SB_RIGHT | 사용자가 오른쪽 아래로 스크롤합니다. |
| SB_LINELEFT | 사용자가 한 단위로 왼쪽으로 스크롤합니다. |
| SB_LINERIGHT | 사용자가 한 단위로 오른쪽으로 스크롤합니다. |
| SB_PAGELEFT | 사용자가 창 너비를 왼쪽으로 스크롤합니다. |
| SB_PAGERIGHT | 사용자가 창 너비를 오른쪽으로 스크롤합니다. |
| SB_THUMBPOSITION | 사용자가 스크롤 상자(엄지손가락)를 끌어 마우스 단추를 놓았습니다. 상위 단어는 끌기 작업의 끝에 있는 스크롤 상자의 위치를 나타냅니다. |
| SB_THUMBTRACK | 사용자가 스크롤 상자를 끌고 있습니다. AFX_WM_ON_HSCROLL 메시지는 사용자가 마우스 단추를 놓을 때까지 이 값으로 반복적으로 전송됩니다. 상위 단어는 스크롤 상자를 끌 위치를 나타냅니다. |
참고 항목
lParam 매개 변수의 상위 단어는 낮은 순서의 단어가 SB_THUMBPOSITION 또는 SB_THUMBTRACK 경우 스크롤 상자의 현재 위치를 지정합니다. 그렇지 않으면 이 단어가 사용되지 않습니다.
다음 표에서는 AFX_WM_UPDATETOOLTIPS 메시지의 lParam 매개 변수에 대한 플래그 값을 나열합니다.
| 플래그 | 값 |
|---|---|
| AFX_TOOLTIP_TYPE_DEFAULT | 0x0001 |
| AFX_TOOLTIP_TYPE_TOOLBAR | 0x0002 |
| AFX_TOOLTIP_TYPE_TAB | 0x0004 |
| AFX_TOOLTIP_TYPE_MINIFRAME | 0x0008 |
| AFX_TOOLTIP_TYPE_DOCKBAR | 0x0010 |
| AFX_TOOLTIP_TYPE_EDIT | 0x0020 |
| AFX_TOOLTIP_TYPE_BUTTON | 0x0040 |
| AFX_TOOLTIP_TYPE_TOOLBOX | 0x0080 |
| AFX_TOOLTIP_TYPE_ALL | 0xFFFF |