AFX – zprávy
Tyto zprávy se používají v prostředí MFC.
Zprávy
Následující tabulka uvádí zprávy, které se používají v knihovně MFC:
| Message | Popis | [v] wParam | lParam (všechny parametry jsou [in] pokud není uvedeno jinak.) | Návratová hodnota |
|---|---|---|---|---|
| AFX_WM_ACCGETOBJECT | Nepoužívá se. | Nepoužívá se. | Nevztahuje se. | Nevztahuje se. |
| AFX_WM_ACCGETSTATE | Používá se pro podporu přístupnosti. Odeslat tuto zprávu nebo CMFCPopupMenu CMFCRibbonPanelMenu načíst stav aktuálního prvku. |
Index elementu, což může být tlačítko nabídky nebo oddělovač. | Nepoužívá se. | Stav elementu. Je -1, pokud je index neplatný, 0, pokud tlačítko nabídky nemá žádné speciální atributy. Jinak se jedná o kombinaci následujících příznaků: TBBS_DISABLED – položka je zakázaná TBBS_CHECKED — položka je zaškrtnutá TBBS_BUTTON – položka je standardní tlačítko TBBS_PRESSED – tlačítko se stiskne TBBS_INDETERMINATE – nedefinovaný stav TBBS_SEPARATOR – místo tlačítka nabídky tvoří tento prvek oddělení mezi ostatními položkami nabídky. |
| AFX_WM_CHANGE_ACTIVE_TAB | Architektura odešle tuto zprávu do ovládacího prvku řídicího panelu umožňující změnu velikosti. Tuto zprávu můžete zpracovat tak, aby přijímala oznámení z CMFCTabCtrl objektů, když uživatel změní aktivní kartu. |
Index karty. | Nepoužívá se. | Nenulový. |
| AFX_WM_CHANGE_CURRENT_FOLDER | Rozhraní odešle tuto zprávu nadřazené po CMFCShellListCtrl změně aktuální složky uživateli. |
Nepoužívá se. | Nepoužívá se. | Nepoužívá se. |
| AFX_WM_CHANGEVISUALMANAGER | Architektura odešle tuto zprávu do všech oken rámců, když uživatel změní aktuální Visual Manager. V reakci na tuto zprávu okno rámce přepočítá její oblast a podle potřeby upraví další parametry. Pokud potřebujete být upozorněni na tuto událost, můžete ve své aplikaci zpracovat zprávu AFX_WM_CHANGEVISUALMANAGER. Je nutné volat obslužnou rutinu základní třídy (OnChangeVisualManager), aby se zajistilo, že probíhá interní zpracování této události architektury. |
Nepoužívá se. | Nepoužívá se. | Nepoužívá se. |
| AFX_WM_CHANGING_ACTIVE_TAB | Odesláno nadřazené objektu CMFCTabCtrl . Tuto zprávu můžete zpracovat, pokud chcete dostávat oznámení z CMFCTabCtrl objektů, když uživatel resetuje kartu. |
Index aktivované karty. | Nepoužívá se. | Nenulový. |
| AFX_WM_CHECKEMPTYMINIFRAME | Jen pro interní potřebu | Nevztahuje se. | Nevztahuje se. | Nevztahuje se. |
| AFX_WM_CREATETOOLBAR | Odesláno, když CMFCToolBarsListPropertyPage uživatel během procesu přizpůsobení vytvoří nový panel nástrojů. Tuto zprávu můžete zpracovat pro vytvoření instance vlastního objektu CMFCToolBar odvozeného objektu. Pokud tuto zprávu zpracujete a vytvoříte vlastní panel nástrojů, vynecháte volání výchozí obslužné rutiny. |
Nepoužívá se. | Ukazatel na řetězec, který obsahuje název panelu nástrojů. | Ukazatel na nově vytvořený panel nástrojů Hodnota NULL označuje, že vytvoření panelu nástrojů bylo zrušeno. |
| AFX_WM_CUSTOMIZEHELP | Když uživatel stiskne tlačítko Nápověda nebo klávesu F1, odešle se do okna hlavního rámce ze seznamu CMFCToolbarCustomize Dialog vlastností přizpůsobení. |
Určuje aktivní stránku seznamu vlastností přizpůsobení. | Ukazatel na CMFCToolbarCustomize Dialog objekt. |
0 |
| AFX_WM_CUSTOMIZETOOLBAR | Tato CMFCToolbarCustomize Dialog zpráva odešle upozornění nadřazeného rámce, že uživatel vytváří nový panel nástrojů. |
TRUE při spuštění vlastního nastavení, NEPRAVDA po dokončení vlastního nastavení. | Nepoužívá se. | 0 |
| AFX_WM_DELETETOOLBAR | Odesláno do hlavního okna rámce, když se uživatel chystá odstranit panel nástrojů v režimu přizpůsobení. Tuto zprávu zpracujte a proveďte další akce, když uživatel odstraní panel nástrojů v režimu přizpůsobení. Měli byste také volat výchozí obslužnou rutinu ( OnToolbarDelete), která odstraní panel nástrojů. Výchozí obslužná rutina vrátí hodnotu, která určuje, jestli je možné panel nástrojů odstranit. |
Nepoužívá se. | Ukazatel na CMFCToolBar objekt, který se má odstranit. |
Nenulové, pokud nelze odstranit panel nástrojů; jinak 0. |
| AFX_WM_GETDOCUMENTCOLORS | CMFCColorMenuButton odešle tuto zprávu do okna hlavního rámce, aby se načetly barvy dokumentu. |
Nepoužívá se. | [in, out] Ukazatel na CList<COLORREF, COLORREF> objekt. |
0 |
| AFX_WM_GETDRAGBOUNDS | Jen pro interní potřebu | Nevztahuje se. | Nevztahuje se. | Nevztahuje se. |
| AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM | Odesláno do hlavního okna rámce, když uživatel zvýrazní položku seznamu pásu karet. | Index zvýrazněné položky | Ukazatel na CMFCBaseRibbonElement |
Nepoužívá se. |
| AFX_WM_ON_AFTER_SHELL_COMMAND | Odeslání nadřazeného prvku nebo CMFCShellTreeCtrl ovládacích CMFCShellListCtrl prvků, když uživatel dokončí provádění příkazu prostředí. |
ID příkazu, který uživatel spustil | Nepoužívá se. | Pokud aplikace tuto zprávu zpracuje, měla by vrátit nulu. |
| AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU | Architektura odešle tuto zprávu nadřazené kartě pásu karet před zobrazením místní nabídky. Tuto zprávu můžete kdykoli zpracovat a upravit místní nabídky. | Nepoužívá se. | Ukazatel na CMFCBaseRibbonElement |
Nepoužívá se. |
| AFX_WM_ON_CANCELTABMOVE | Jen pro interní potřebu | Nevztahuje se. | Nevztahuje se. | |
| AFX_WM_ON_CHANGE_RIBBON_CATEGORY | Architektura odešle tuto zprávu do hlavního rámce, když uživatel změní aktivní kategorii ovládacího prvku pásu karet. | Nepoužívá se. | Ukazatel na CMFCRibbonBar kategorii, jejíž kategorie se změnila. |
Nepoužívá se. |
| AFX_WM_ON_CLOSEPOPUPWINDOW | Architektura odešle tuto zprávu, která informuje vlastníka CMFCDesktopAlertWnd o tom, že okno se chystá zavřít. |
Nepoužívá se. | Ukazatel na CMFCDesktopAlertWnd objekt. |
Nepoužívá se. |
| AFX_WM_ON_DRAGCOMPLETE | Jen pro interní potřebu | Nevztahuje se. | Nevztahuje se. | Nevztahuje se. |
| AFX_WM_ON_GET_TAB_TOOLTIP | Odesláno do okna hlavního rámce, když se okno karty chystá zobrazit popis pro kartu, pokud jsou povoleny vlastní popisy. | Nepoužívá se. | Ukazatel na CMFCTabToolTipInfo strukturu. |
Nepoužívá se. |
| AFX_WM_ON_HSCROLL | Odesláno do ovládacího prvku řídicího panelu umožňující změnu velikosti. Tuto zprávu můžete zpracovat a přijímat oznámení z CMFCTabCtrl objektů, když dojde k události posouvání na vodorovném posuvníku widgetu s kartami. |
Slovo s nízkým pořadím určuje hodnotu posuvníku, která označuje požadavek uživatele na posouvání. Další informace najdete v tabulce dále v tomto tématu. | Nepoužívá se. | Nenulový. |
| AFX_WM_ON_MOVE_TAB | Odesláno nadřazené okno s kartami, když uživatel přetáhne kartu na nové místo. | Index karty založený na nule v původní pozici. | [ven] Index na základě nuly na kartě v nové pozici. | 0 |
| AFX_WM_ON_MOVETABCOMPLETE | Jen pro interní potřebu | Nevztahuje se. | Nevztahuje se. | Nevztahuje se. |
| AFX_WM_ON_MOVETOTABGROUP | Odesláno do hlavního okna rámce, když uživatel přesune podřízené okno MDI z jedné skupiny s kartami do jiné. | Úchyt pro okno s kartami (CMFCTabCtrl), ze kterého bylo odebráno podřízené okno MDI. |
[ven] Úchyt pro okno s kartami (CMFCTabCtrl), do kterého bylo vloženo podřízené okno MDI. |
Ignorovaný. |
| AFX_WM_ON_PRESS_CLOSE_BUTTON | Odesláno nadřazené CDockablePane sadě, když uživatel klikne na tlačítko Zavřít na titulku řídicího panelu. |
Nepoužívá se. | Ukazatel na ukotvené podokno, na kterém uživatel klikl na tlačítko Zavřít . | TRUE, pokud nelze zavřít podokno; jinak NEPRAVDA. |
| AFX_WM_ON_RENAME_TAB | Odesláno nadřazené okno s kartami po přejmenování upravitelné karty uživatelem. | Index založený na nule přejmenované karty. | [ven] Ukazatel na řetězec, který obsahuje nový název karty. | Nenulové, pokud aplikace zpracuje tuto zprávu; rozhraní potlačí volání CMFCBaseTabCtrl::SetTabLabel. Pokud je vrácena nula, pak CMFCBaseTabCtrl::SetTabLabel je volána architekturou. |
| AFX_WM_ON_RIBBON_CUSTOMIZE | Odesláno do nadřazeného rámce při spuštění vlastního nastavení uživatelem. Tuto zprávu můžete zpracovat, pokud chcete zobrazit vlastní dialogové okno vlastního nastavení. | Nepoužívá se. | Ukazatel na ovládací prvek pásu karet, který chcete přizpůsobit. | Nenulové, pokud aplikace zpracuje tuto zprávu a zobrazí vlastní dialogové okno pro přizpůsobení. Pokud aplikace vrátí nulu, architektura zobrazí integrované dialogové okno přizpůsobení. |
| AFX_WM_ON_TABGROUPMOUSEMOVE | Jen pro interní potřebu | Nevztahuje se. | Nevztahuje se. | Nevztahuje se. |
| AFX_WM_POSTSETPREVIEWFRAME | Odesláno s oznámením hlavního rámce, že uživatel změnil režim náhledu tisku. | HODNOTA TRUE označuje, že je nastavený režim náhledu tisku. NEPRAVDA označuje, že je režim náhledu tisku vypnutý. | Nepoužívá se. | Nepoužívá se. |
| AFX_WM_PROPERTY_CHANGED | Odesláno vlastníkovi ovládacího prvku mřížky vlastností (CMFCPropertyGridCtrl), když uživatel změní hodnotu vybrané vlastnosti. |
ID ovládacího prvku seznamu vlastností. | Ukazatel na vlastnost (CMFCPropertyGridProperty), která se změnila. |
Nepoužívá se. |
| AFX_WM_RESETCONTEXTMENU | Odesláno do okna hlavního rámce, když uživatel resetuje místní nabídku během přizpůsobení. | ID prostředku místní nabídky. | Ukazatel na aktuální místní nabídku , CMFCPopupMenu. |
Nepoužívá se. |
| AFX_WM_RESETKEYBOARD | Architektura odešle tuto zprávu do hlavního okna rámce, když uživatel resetuje všechny akcelerátory klávesnice během přizpůsobení. | Nepoužívá se. | Nepoužívá se. | Nepoužívá se. |
| AFX_WM_RESETMENU | Architektura odešle tuto zprávu vlastníkovi nabídky (okno rámce), když uživatel během vlastního nastavení resetuje nabídku rámečku aplikace. | ID prostředku nabídky. | Nepoužívá se. | Nepoužívá se. |
| AFX_WM_RESETPROMPT | Rozhraní odešle tuto zprávu, když uživatel resetuje panel nástrojů z dialogového okna přizpůsobení panelu nástrojů. Výchozí obslužná rutina zobrazí okno se zprávou, které se zeptá, jestli chce uživatel obnovit panel nástrojů. | Nepoužívá se. | Nepoužívá se. | Nepoužívá se. |
| AFX_WM_RESETTOOLBAR | Objekt CMFCToolBar odešle tuto zprávu při obnovení panelu nástrojů do původního stavu, tj. načteného z prostředků. Zpracovat tuto zprávu znovu vložit tlačítka panelu nástrojů, jejichž třídy jsou odvozeny z CMFCToolbarButton. Další informace najdete na webu CMFCToolbarComboBoxButton. |
ID prostředku panelu nástrojů, jehož stav byl obnoven. | Nepoužívá se. | 0 |
| AFX_WM_SHOWREGULARMENU | CMFCToolbarMenuButton objekt odešle tuto zprávu vlastníkovi, když uživatel klikne na tlačítko běžné nabídky. Tuto zprávu zpracovat pokaždé, když uživatel CMFCToolbarMenuButton klikne na tlačítko, zobrazí místní nabídku. |
ID příkazu tlačítka, které zprávu odešle. | Souřadnice obrazovky kurzoru Slovo s nízkým pořadím určuje souřadnici x. Slovo s vysokým pořadím určuje souřadnici y. | Nepoužívá se. |
| AFX_WM_TOOLBARMENU | Odesláno do okna hlavního rámce, když uživatel uvolní pravé tlačítko myši, zatímco ukazatel myši je v klientské nebo nekližní oblasti podokna. | Nepoužívá se. | Souřadnice obrazovky ukazatele myši Slovo s nízkým pořadím určuje souřadnici x. Slovo s vysokým pořadím určuje souřadnici y. | Nula, pokud aplikace zpracuje tuto zprávu; jinak, nenulová. |
| AFX_WM_UPDATETOOLTIPS | Odesláno všem vlastníkům popisků, aby bylo možné označit, že by se měly znovu vytvořit ovládací prvky popisu. | Typ ovládacího prvku, který by měl tuto zprávu zpracovat. Seznam možných hodnot najdete v tabulce dále v tomto tématu. | Nepoužívá se. | Nepoužívá se. |
| AFX_WM_WINDOW_HELP | CMFCWindowsManagerDialog odešle tuto zprávu do nadřazeného rámce, když uživatel klikne na tlačítko Nápověda nebo přejde do režimu nápovědy kliknutím na tlačítko Titulky nápovědy nebo klávesou F1. |
Nepoužívá se. | Ukazatel na instanci .CMFCWindowsManagerDialog |
Nepoužívá se. |
Následující tabulka ukazuje hodnoty pro nízké slovo lParam parametru AFX_WM_HSCROLL metody:
| Hodnota | Význam |
|---|---|
| SB_ENDSCROLL | Uživatel ukončí posouvání. |
| SB_LEFT | Uživatel se posune do levého horního rohu. |
| SB_RIGHT | Uživatel se posune do pravého dolního rohu. |
| SB_LINELEFT | Uživatel se posune doleva o jednu jednotku. |
| SB_LINERIGHT | Uživatel se posune doprava o jednu jednotku. |
| SB_PAGELEFT | Uživatel se posune doleva o šířku okna. |
| SB_PAGERIGHT | Uživatel se posune doprava o šířku okna. |
| SB_THUMBPOSITION | Uživatel přetáhl posuvník (palec) a vydal tlačítko myši. Slovo s vysokým pořadím označuje pozici posuvníku na konci operace přetažení. |
| SB_THUMBTRACK | Uživatel přetahuje posuvník. Zpráva AFX_WM_ON_HSCROLL se odešle opakovaně s touto hodnotou, dokud uživatel nespustí tlačítko myši. Slovo s vysokým pořadím označuje pozici, do které bylo pole posuvníku přetaženo. |
Poznámka:
Slovo lParam s vysokým pořadím určuje aktuální pozici posuvníku, pokud je slovo s nízkým pořadím SB_THUMBPOSITION nebo SB_THUMBTRACK; jinak se toto slovo nepoužívá.
Následující tabulka uvádí hodnoty příznaku pro parametr lParam zprávy AFX_WM_UPDATETOOLTIPS:
| Příznak | Hodnota |
|---|---|
| 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 |