Komunikaty AFX
Te komunikaty są używane w MFC.
Wiadomości
W poniższej tabeli wymieniono komunikaty używane w bibliotece MFC:
| Wiadomość | opis | [in] wParam | lParam (wszystkie parametry są [w] chyba że określono inaczej). | Wartość zwracana |
|---|---|---|---|---|
| AFX_WM_ACCGETOBJECT | Nie używany. | Nie używany. | Nie dotyczy. | Nie dotyczy. |
| AFX_WM_ACCGETSTATE | Służy do obsługi ułatwień dostępu. Wyślij tę wiadomość do CMFCPopupMenu lub CMFCRibbonPanelMenu , aby pobrać stan bieżącego elementu. |
Indeks elementu, który może być przyciskiem menu lub separatorem. | Nie używany. | Stan elementu. Jeśli indeks jest nieprawidłowy, 0, jeśli przycisk menu nie ma atrybutów specjalnych, jest to wartość -1. W przeciwnym razie jest to kombinacja następujących flag: TBBS_DISABLED — element jest wyłączony TBBS_CHECKED — element jest zaznaczony TBBS_BUTTON — element jest standardowym przyciskiem push TBBS_PRESSED — naciśnięcie przycisku TBBS_INDETERMINATE — stan niezdefiniowany TBBS_SEPARATOR — a nie przycisk menu, ten element stanowi separację między innymi elementami menu |
| AFX_WM_CHANGE_ACTIVE_TAB | Platforma wysyła ten komunikat do kontrolki paska sterowania z możliwością zmiany rozmiaru. Przetwórz ten komunikat, aby otrzymywać powiadomienia z CMFCTabCtrl obiektów, gdy użytkownik zmieni aktywną kartę. |
Indeks karty. | Nie używany. | Niezerowa. |
| AFX_WM_CHANGE_CURRENT_FOLDER | Struktura wysyła ten komunikat do elementu nadrzędnego CMFCShellListCtrl , gdy użytkownik zmienił bieżący folder. |
Nie używany. | Nie używany. | Nie używany. |
| AFX_WM_CHANGEVISUALMANAGER | Platforma wysyła ten komunikat do wszystkich okien ramek, gdy użytkownik zmieni bieżący program Visual Manager. W odpowiedzi na ten komunikat okno ramki ponownie oblicza swój region i dostosowuje inne parametry zgodnie z potrzebami. Jeśli chcesz otrzymywać powiadomienia o tym zdarzeniu, możesz przetworzyć komunikat AFX_WM_CHANGEVISUALMANAGER w aplikacji. Należy wywołać program obsługi klasy bazowej (OnChangeVisualManager), aby upewnić się, że odbywa się wewnętrzne przetwarzanie tego zdarzenia przez strukturę. |
Nie używany. | Nie używany. | Nie używany. |
| AFX_WM_CHANGING_ACTIVE_TAB | Wysłane do obiektu nadrzędnego CMFCTabCtrl obiektu. Przetwórz ten komunikat, jeśli chcesz otrzymywać powiadomienia z CMFCTabCtrl obiektów, gdy użytkownik resetuje kartę. |
Indeks karty, która jest aktywowana. | Nie używany. | Niezerowa. |
| AFX_WM_CHECKEMPTYMINIFRAME | Tylko do użytku wewnętrznego. | Nie dotyczy. | Nie dotyczy. | Nie dotyczy. |
| AFX_WM_CREATETOOLBAR | Wysyłane z CMFCToolBarsListPropertyPage momentu utworzenia nowego paska narzędzi przez użytkownika podczas procesu dostosowywania. Ten komunikat można przetworzyć, aby utworzyć wystąpienie niestandardowego obiektu pochodnego CMFCToolBar. Jeśli obsłużysz ten komunikat i utworzysz własny pasek narzędzi, pomiń wywołanie domyślnej procedury obsługi. |
Nie używany. | Wskaźnik do ciągu zawierającego nazwę paska narzędzi. | Wskaźnik do nowo utworzonego paska narzędzi. Wartość NULL wskazuje, że tworzenie paska narzędzi zostało anulowane. |
| AFX_WM_CUSTOMIZEHELP | Wysłane do głównego okna ramki z arkusza CMFCToolbarCustomize Dialog właściwości dostosowywania, gdy użytkownik naciśnie przycisk Pomoc lub F1. |
Określa aktywną stronę arkusza właściwości dostosowywania. | Wskaźnik do CMFCToolbarCustomize Dialog obiektu. |
Zero. |
| AFX_WM_CUSTOMIZETOOLBAR | Spowoduje to CMFCToolbarCustomize Dialog wysłanie tej wiadomości w celu powiadomienia ramki nadrzędnej o utworzeniu nowego paska narzędzi przez użytkownika. |
Wartość TRUE po uruchomieniu dostosowywania wartość FALSE po zakończeniu dostosowywania. | Nie używany. | Zero. |
| AFX_WM_DELETETOOLBAR | Wysłane do głównego okna ramki, gdy użytkownik ma usunąć pasek narzędzi w trybie dostosowywania. Przetwórz ten komunikat, aby wykonać dodatkowe akcje, gdy użytkownik usunie pasek narzędzi w trybie dostosowywania. Należy również wywołać domyślną procedurę obsługi ( OnToolbarDelete), która usuwa pasek narzędzi. Domyślna procedura obsługi zwraca wartość wskazującą, czy można usunąć pasek narzędzi. |
Nie używany. | Wskaźnik do CMFCToolBar obiektu do usunięcia. |
Niezerowe, jeśli nie można usunąć paska narzędzi; w przeciwnym razie 0. |
| AFX_WM_GETDOCUMENTCOLORS | CMFCColorMenuButton Wysyła ten komunikat do głównego okna ramki w celu pobrania kolorów dokumentu. |
Nie używany. | [in, out] Wskaźnik do CList<COLORREF, COLORREF> obiektu. |
Zero. |
| AFX_WM_GETDRAGBOUNDS | Tylko do użytku wewnętrznego. | Nie dotyczy. | Nie dotyczy. | Nie dotyczy. |
| AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM | Wysłane do głównego okna ramki, gdy użytkownik wyróżni element listy wstążki. | Indeks wyróżnionego elementu | Wskaźnik do CMFCBaseRibbonElement |
Nie używany. |
| AFX_WM_ON_AFTER_SHELL_COMMAND | Wysłane do elementu nadrzędnego lub CMFCShellListCtrl CMFCShellTreeCtrl kontrolek, gdy użytkownik zakończy wykonywanie polecenia powłoki. |
Identyfikator polecenia, które zostało wykonane przez użytkownika | Nie używany. | Jeśli aplikacja przetwarza ten komunikat, powinna zwrócić zero. |
| AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU | Platforma wysyła ten komunikat do elementu nadrzędnego wstążki, zanim wyświetli menu podręczne. Ten komunikat można przetworzyć i zmodyfikować menu podręczne w dowolnym momencie. | Nie używany. | Wskaźnik do CMFCBaseRibbonElement |
Nie używany. |
| AFX_WM_ON_CANCELTABMOVE | Tylko do użytku wewnętrznego. | Nie dotyczy. | Nie dotyczy. | |
| AFX_WM_ON_CHANGE_RIBBON_CATEGORY | Platforma wysyła ten komunikat do ramki głównej, gdy użytkownik zmieni aktywną kategorię Kontrolka wstążki. | Nie używany. | Wskaźnik do CMFCRibbonBar , którego kategoria uległa zmianie. |
Nie używany. |
| AFX_WM_ON_CLOSEPOPUPWINDOW | Platforma wysyła tę wiadomość, aby powiadomić właściciela CMFCDesktopAlertWnd o tym, że okno ma zostać zamknięte. |
Nie używany. | Wskaźnik do CMFCDesktopAlertWnd obiektu. |
Nie używany. |
| AFX_WM_ON_DRAGCOMPLETE | Tylko do użytku wewnętrznego. | Nie dotyczy. | Nie dotyczy. | Nie dotyczy. |
| AFX_WM_ON_GET_TAB_TOOLTIP | Wysłane do głównego okna ramki, gdy okno karty ma wyświetlać etykietkę narzędzia dla karty, jeśli niestandardowe etykietki narzędzi są włączone. | Nie używany. | Wskaźnik do CMFCTabToolTipInfo struktury. |
Nie używany. |
| AFX_WM_ON_HSCROLL | Wysłane do kontrolki paska sterowania z możliwością zmiany rozmiaru. Przetwórz ten komunikat, aby otrzymywać powiadomienia z CMFCTabCtrl obiektów, gdy zdarzenie przewijania występuje na pasku przewijania poziomego widżetu z kartami. |
Wyraz o niskiej kolejności określa wartość paska przewijania, która wskazuje żądanie przewijania użytkownika. Aby uzyskać więcej informacji, zobacz tabelę w dalszej części tego tematu. | Nie używany. | Niezerowa. |
| AFX_WM_ON_MOVE_TAB | Wysłane do elementu nadrzędnego okna z kartą, gdy użytkownik przeciąga kartę do nowej pozycji. | Indeks na podstawie zera karty w pierwotnej pozycji. | [out] Indeks karty na podstawie zera w nowej pozycji. | Zero. |
| AFX_WM_ON_MOVETABCOMPLETE | Tylko do użytku wewnętrznego. | Nie dotyczy. | Nie dotyczy. | Nie dotyczy. |
| AFX_WM_ON_MOVETOTABGROUP | Wysłane do głównego okna ramki, gdy użytkownik przenosi okno podrzędne MDI z jednej grupy kart do innej. | Dojście do okna z kartami (CMFCTabCtrl), z którego usunięto okno podrzędne MDI. |
[out] Dojście do okna z kartami (CMFCTabCtrl), do którego wstawiono okno podrzędne MDI. |
Ignorowane. |
| AFX_WM_ON_PRESS_CLOSE_BUTTON | Wysłane do elementu nadrzędnego CDockablePane , gdy użytkownik kliknie przycisk Zamknij na podpis paska sterowania. |
Nie używany. | Wskaźnik do okienka z możliwością dokowania, na którym użytkownik kliknął przycisk Zamknij . | WARTOŚĆ TRUE, jeśli nie można zamknąć okienka; w przeciwnym razie FAŁSZ. |
| AFX_WM_ON_RENAME_TAB | Wysłane do nadrzędnego okna z kartami po zmianie nazwy karty edytowalnej przez użytkownika. | Indeks oparty na zera zmienionej nazwie karty. | [out] Wskaźnik do ciągu zawierającego nową nazwę karty. | Nonzero, jeśli aplikacja przetwarza ten komunikat; struktura spowoduje pominięcie wywołania metody CMFCBaseTabCtrl::SetTabLabel. Jeśli zostanie zwrócone zero, CMFCBaseTabCtrl::SetTabLabel zostanie wywołana przez platformę. |
| AFX_WM_ON_RIBBON_CUSTOMIZE | Wysłane do ramki nadrzędnej po rozpoczęciu dostosowywania przez użytkownika. Przetwórz ten komunikat, jeśli chcesz wyświetlić własne okno dialogowe dostosowywania. | Nie używany. | Wskaźnik do kontrolki wstążki do dostosowania. | Nonzero, jeśli aplikacja przetwarza ten komunikat i wyświetla własne okno dialogowe dostosowywania. Jeśli aplikacja zwróci zero, platforma wyświetli wbudowane okno dialogowe dostosowywania. |
| AFX_WM_ON_TABGROUPMOUSEMOVE | Tylko do użytku wewnętrznego. | Nie dotyczy. | Nie dotyczy. | Nie dotyczy. |
| AFX_WM_POSTSETPREVIEWFRAME | Wysłane w celu powiadomienia ramki głównej, że użytkownik zmienił tryb podglądu wydruku | Wartość TRUE wskazuje, że tryb podglądu wydruku jest ustawiony. FAŁSZ wskazuje, że tryb podglądu wydruku jest wyłączony. | Nie używany. | Nie używany. |
| AFX_WM_PROPERTY_CHANGED | Wysłane do właściciela kontrolki siatki właściwości (CMFCPropertyGridCtrl), gdy użytkownik zmieni wartość wybranej właściwości. |
Identyfikator kontrolki listy właściwości. | Wskaźnik do właściwości (CMFCPropertyGridProperty), która uległa zmianie. |
Nie używany. |
| AFX_WM_RESETCONTEXTMENU | Wysłane do głównego okna ramki, gdy użytkownik resetuje menu kontekstowe podczas dostosowywania. | Identyfikator zasobu menu kontekstowego. | Wskaźnik do bieżącego menu kontekstowego, CMFCPopupMenu. |
Nie używany. |
| AFX_WM_RESETKEYBOARD | Platforma wysyła ten komunikat do głównego okna ramki, gdy użytkownik resetuje wszystkie akceleratory klawiatury podczas dostosowywania. | Nie używany. | Nie używany. | Nie używany. |
| AFX_WM_RESETMENU | Platforma wysyła ten komunikat do właściciela menu (okno ramki), gdy użytkownik resetuje menu ramki aplikacji podczas dostosowywania | Identyfikator zasobu menu. | Nie używany. | Nie używany. |
| AFX_WM_RESETPROMPT | Platforma wysyła ten komunikat, gdy użytkownik resetuje pasek narzędzi z okna dialogowego dostosowywania paska narzędzi. Domyślna procedura obsługi wyświetla pole komunikatu z pytaniem, czy użytkownik chce zresetować pasek narzędzi. | Nie używany. | Nie używany. | Nie używany. |
| AFX_WM_RESETTOOLBAR | Obiekt CMFCToolBar wysyła ten komunikat, gdy pasek narzędzi zostanie przywrócony do pierwotnego stanu, czyli załadowany z zasobów. Przetwórz ten komunikat, aby ponownie włączyć przyciski paska narzędzi, których klasy pochodzą z CMFCToolbarButtonklasy . Aby uzyskać więcej informacji, zobacz CMFCToolbarComboBoxButton. |
Identyfikator zasobu paska narzędzi, którego stan został przywrócony. | Nie używany. | Zero. |
| AFX_WM_SHOWREGULARMENU | CMFCToolbarMenuButton obiekt wysyła tę wiadomość do właściciela, gdy użytkownik kliknie zwykły przycisk menu. Przetwarzaj ten komunikat za każdym razem, gdy używasz CMFCToolbarMenuButton polecenia , aby wyświetlić menu podręczne, gdy użytkownik kliknie przycisk. |
Identyfikator polecenia przycisku, który wysyła komunikat. | Współrzędne ekranu kursora. Wyraz o niskiej kolejności określa współrzędną x. Wyraz o wysokiej kolejności określa współrzędną y. | Nie używany. |
| AFX_WM_TOOLBARMENU | Wysłane do głównego okna ramki, gdy użytkownik zwolni prawy przycisk myszy, gdy wskaźnik myszy znajduje się w kliencie lub w obszarze innym niż klient okienka. | Nie używany. | Współrzędne ekranu wskaźnika myszy. Wyraz o niskiej kolejności określa współrzędną x. Wyraz o wysokiej kolejności określa współrzędną y. | Zero, jeśli aplikacja przetwarza ten komunikat; w przeciwnym razie, nonzero. |
| AFX_WM_UPDATETOOLTIPS | Wysłane do wszystkich właścicieli etykietek narzędzi, aby wskazać, że ich kontrolki etykietki narzędzi powinny zostać ponownie odtworzone. | Typ kontrolki, która powinna przetworzyć ten komunikat. Zapoznaj się z tabelą w dalszej części tego tematu, aby zapoznać się z listą możliwych wartości. | Nie używany. | Nie używany. |
| AFX_WM_WINDOW_HELP | CMFCWindowsManagerDialog Wysyła tę wiadomość do ramki nadrzędnej, gdy użytkownik kliknie przycisk Pomoc lub wprowadzi tryb pomocy, klikając przycisk Podpis pomocy lub F1. |
Nie używany. | Wskaźnik do wystąpienia klasy CMFCWindowsManagerDialog. |
Nie używany. |
W poniższej tabeli przedstawiono wartości dla małego słowa parametru lParam metody AFX_WM_HSCROLL:
| Wartość | Znaczenie |
|---|---|
| SB_ENDSCROLL | Użytkownik kończy przewijanie. |
| SB_LEFT | Użytkownik przewija się do lewego górnego rogu. |
| SB_RIGHT | Użytkownik przewija do prawej dolnej części. |
| SB_LINELEFT | Użytkownik przewija się w lewo po jednej jednostce. |
| SB_LINERIGHT | Użytkownik przewija się w prawo po jednej jednostce. |
| SB_PAGELEFT | Użytkownik przewija się w lewo o szerokość okna. |
| SB_PAGERIGHT | Użytkownik przewija w prawo szerokość okna. |
| SB_THUMBPOSITION | Użytkownik przeciągnął pole przewijania (kciuk) i zwolnił przycisk myszy. Wyraz o wysokiej kolejności wskazuje położenie pola przewijania na końcu operacji przeciągania. |
| SB_THUMBTRACK | Użytkownik przeciąga pole przewijania. Komunikat AFX_WM_ON_HSCROLL jest wysyłany wielokrotnie z tą wartością, dopóki użytkownik nie zwolni przycisku myszy. Wyraz o wysokiej kolejności wskazuje położenie, do którego przeciągano pole przewijania. |
Uwaga
Wyraz o wysokiej kolejności parametru lParam określa bieżące położenie pola przewijania, jeśli wyraz o niskiej kolejności jest SB_THUMBPOSITION lub SB_THUMBTRACK; w przeciwnym razie ten wyraz nie jest używany.
W poniższej tabeli wymieniono wartości flagi dla parametru lParam komunikatu AFX_WM_UPDATETOOLTIPS:
| Flaga | Wartość |
|---|---|
| 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 |