TN061: ON_NOTIFY a WM_NOTIFY – zprávy

Poznámka

Následující technická poznámka se od prvního zahrnutí do online dokumentace neaktualizovala. V důsledku toho můžou být některé postupy a témata zastaralé nebo nesprávné. Nejnovější informace doporučujeme vyhledat v online indexu dokumentace, které vás zajímá.

Tato technická poznámka obsahuje základní informace o nové zprávě WM_NOTIFY a popisuje doporučený (a nejběžnější) způsob zpracování WM_NOTIFY zpráv v aplikaci MFC.

Zprávy oznámení ve Windows 3.x

Ve Windows 3.x ovládací prvky upozorňují rodiče na události, jako jsou kliknutí myší, změny obsahu a výběru, a ovládání obrazu na pozadí odesláním zprávy nadřazené sadě. Jednoduchá oznámení se odesílají jako speciální WM_COMMAND zprávy s kódem oznámení (například BN_CLICKED) a ID ovládacího prvku zabalené do wParam a popisovače ovládacího prvku v lParam. Všimněte si, že vzhledem k tomu , že jsou wParam a lParam plné, neexistuje způsob, jak předat žádná další data – tyto zprávy mohou být pouze jednoduché oznámení. Například v oznámení BN_CLICKED neexistuje způsob, jak odeslat informace o umístění kurzoru myši při kliknutí na tlačítko.

Když ovládací prvky ve Windows 3.x potřebují odeslat zprávu s oznámením, která obsahuje další data, používají různé speciální zprávy, včetně WM_CTLCOLOR, WM_VSCROLL, WM_HSCROLL, WM_DRAWITEM, WM_MEASUREITEM, WM_COMPAREITEM, WM_DELETEITEM, WM_CHARTOITEM, WM_VKEYTOITEM atd. Tyto zprávy se dají promítnout zpět do ovládacího prvku, který je poslal. Další informace naleznete v tématu TN062: Message Reflexe ion for Windows Controls.

Zprávy s oznámením ve Win32

U ovládacích prvků, které existovaly ve Windows 3.1, používá rozhraní API Win32 většinu zpráv oznámení, které byly použity ve Windows 3.x. Win32 ale také přidává k těm podporovaným ve Windows 3.x řadu sofistikovaných a složitých ovládacích prvků. Tyto ovládací prvky často potřebují odesílat další data se zprávami s oznámeními. Místo přidání nové WM_* zprávy pro každé nové oznámení, které potřebuje další data, se návrháři rozhraní API Win32 rozhodli přidat pouze jednu zprávu, WM_NOTIFY, která může předávat libovolné množství dalších dat standardizovaným způsobem.

WM_NOTIFY zprávy obsahují ID ovládacího prvku odesílajícího zprávu v wParam a ukazatel na strukturu v lParam. Tato struktura je buď struktura NMHDR , nebo některá větší struktura, která má strukturu NMHDR jako svůj první člen. Všimněte si, že vzhledem k tomu , že je nejprve člen NMHDR , lze ukazatel na tuto strukturu použít buď jako ukazatel na NMHDR , nebo jako ukazatel na větší strukturu v závislosti na tom, jak ji přetypujete.

Ve většině případů ukazatel ukáže na větší strukturu a při použití ho budete muset přetypovat. V několika oznámeních, jako jsou běžná oznámení (jejichž názvy začínají NM_) a ovládací prvek popisku nástroje TTN_SHOW a TTN_POP oznámení, je ve skutečnosti použitá struktura NMHDR .

Struktura NMHDR nebo počáteční člen obsahuje popisovač a ID ovládacího prvku, který odesílá zprávu a kód oznámení (například TTN_SHOW). Formát struktury NMHDR je znázorněn níže:

typedef struct tagNMHDR {
    HWND hwndFrom;
    UINT idFrom;
    UINT code;
} NMHDR;

U TTN_SHOW zprávy by byl člen kódu nastavený na TTN_SHOW.

Většina oznámení předává ukazatel na větší strukturu, která jako první člen obsahuje strukturu NMHDR . Představte si například strukturu, kterou ovládací prvek zobrazení seznamu používá LVN_KEYDOWN zpráva s oznámením, která se odešle při stisknutí klávesy v ovládacím prvku zobrazení seznamu. Ukazatel odkazuje na LV_KEYDOWN strukturu, která je definována takto:

typedef struct tagLV_KEYDOWN {
    NMHDR hdr;
    WORD wVKey;
    UINT flags;
} LV_KEYDOWN;

Všimněte si, že vzhledem k tomu , že člen NMHDR je v této struktuře první, může být ukazatel, který jste předali v oznamovací zprávě, přetypovat na ukazatel na NMHDR nebo ukazatel na LV_KEYDOWN.

Oznámení společná pro všechny nové ovládací prvky Windows

Některá oznámení jsou společná pro všechny nové ovládací prvky Windows. Tato oznámení předávají ukazatel na strukturu NMHDR .

Kód oznámení	Odesláno z důvodu
NM_CLICK	Uživatel klikl na levé tlačítko myši v ovládacím prvku.
NM_DBLCLK	Uživatel poklikáním na levé tlačítko myši v ovládacím prvku
NM_RCLICK	Uživatel v ovládacím prvku klikl pravým tlačítkem myši.
NM_RDBLCLK	Uživatel poklikáním pravým tlačítkem myši v ovládacím prvku
NM_RETURN	Uživatel stiskl klávesu ENTER, zatímco ovládací prvek má fokus vstupu.
NM_SETFOCUS	Ovládací prvek dostal vstupní fokus.
NM_KILLFOCUS	Ovládací prvek ztratil fokus vstupu.
NM_OUTOFMEMORY	Ovládací prvek nemohl dokončit operaci, protože není k dispozici dostatek paměti.

ON_NOTIFY: Zpracování zpráv WM_NOTIFY v aplikacích MFC

Funkce CWnd::OnNotify zpracovává zprávy s oznámeními. Jeho výchozí implementace zkontroluje mapování zpráv, aby obslužné rutiny oznámení volání. Obecně platí, že nepřepíšete OnNotify. Místo toho zadáte funkci obslužné rutiny a přidáte položku mapy zpráv pro tuto obslužnou rutinu do mapy zpráv třídy okna vlastníka.

ClassWizard, prostřednictvím seznamu vlastností ClassWizard, může vytvořit ON_NOTIFY položku mapy zpráv a poskytnout vám funkci kostru obslužné rutiny. Další informace o použití TřídyWizard, aby to bylo jednodušší, naleznete v tématu Mapování zpráv na funkce.

Makro mapy zpráv ON_NOTIFY má následující syntaxi:

ON_NOTIFY(wNotifyCode, id, memberFxn)

kde parametry jsou:

wNotifyCode
Kód zprávy s oznámením, který se má zpracovat, například LVN_KEYDOWN.

id
Podřízený identifikátor ovládacího prvku, pro který je oznámení odesláno.

memberFxn
Členová funkce, která se má volat při odeslání tohoto oznámení.

Členová funkce musí být deklarována pomocí následujícího prototypu:

afx_msg void memberFxn(NMHDR* pNotifyStruct, LRESULT* result);

kde parametry jsou:

pNotify – struktura
Ukazatel na strukturu oznámení, jak je popsáno v části výše.

Výsledek
Ukazatel na kód výsledku, který nastavíte před vrácením.

Příklad

Chcete-li určit, že chcete, aby členská funkce OnKeydownList1 zpracovávala LVN_KEYDOWN zprávy z CListCtrl ID je IDC_LIST1, byste pomocí TřídyWizard přidali následující položky do mapy zpráv:

ON_NOTIFY(LVN_KEYDOWN, IDC_LIST1, OnKeydownList1)

Ve výše uvedeném příkladu je funkce poskytovaná classWizard:

void CMessageReflectionDlg::OnKeydownList1(NMHDR* pNMHDR, LRESULT* pResult)
{
    LV_KEYDOWN* pLVKeyDow = (LV_KEYDOWN*)pNMHDR;

    // TODO: Add your control notification handler
    //       code here

    *pResult = 0;
}

Všimněte si, že ClassWizard poskytuje ukazatel správného typu automaticky. Ke struktuře oznámení můžete přistupovat prostřednictvím pNMHDR nebo pLVKeyDow.

ON_NOTIFY_RANGE

Pokud potřebujete zpracovat stejnou zprávu WM_NOTIFY pro sadu ovládacích prvků, můžete místo ON_NOTIFY použít ON_NOTIFY_RANGE. Můžete mít například sadu tlačítek, pro které chcete provést stejnou akci pro určitou zprávu s oznámením.

Pokud používáte ON_NOTIFY_RANGE, zadáte souvislou oblast podřízených identifikátorů, pro které se má zpráva s oznámením zpracovat zadáním počátečního a koncového podřízeného identifikátoru rozsahu.

TřídaWizard nezpracuje ON_NOTIFY_RANGE; pokud ho chcete použít, musíte mapu zpráv upravit sami.

Položka mapy zpráv a prototyp funkce pro ON_NOTIFY_RANGE jsou následující:

ON_NOTIFY_RANGE(wNotifyCode, id, idLast, memberFxn)

kde parametry jsou:

wNotifyCode
Kód zprávy s oznámením, který se má zpracovat, například LVN_KEYDOWN.

id
První identifikátor v souvislé oblasti identifikátorů.

IdLast
Poslední identifikátor v souvislé oblasti identifikátorů.

memberFxn
Členová funkce, která se má volat při odeslání tohoto oznámení.

Členová funkce musí být deklarována pomocí následujícího prototypu:

afx_msg void memberFxn(UINT id, NMHDR* pNotifyStruct, LRESULT* result);

kde parametry jsou:

id
Podřízený identifikátor ovládacího prvku, který oznámení odeslal.

pNotify – struktura
Ukazatel na strukturu oznámení, jak je popsáno výše.

Výsledek
Ukazatel na kód výsledku, který nastavíte před vrácením.

ON_NOTIFY_EX, ON_NOTIFY_EX_RANGE

Pokud chcete, aby zprávu zpracovával více než jeden objekt směrování oznámení, můžete místo ON_NOTIFY (nebo ON_NOTIFY_RANGE) použít ON_NOTIFY_EX (nebo ON_NOTIFY_EX_RANGE). Jediným rozdílem mezi verzí EX a běžnou verzí je, že členová funkce volaná pro verzi EX vrací boOL , která označuje, zda má zpracování zpráv pokračovat nebo ne. Vrácení NEPRAVDA z této funkce umožňuje zpracovat stejnou zprávu ve více než jednom objektu.

TřídaWizard nezpracuje ON_NOTIFY_EX ani ON_NOTIFY_EX_RANGE; pokud chcete některou z nich použít, musíte mapu zpráv upravit sami.

Položka mapy zpráv a prototyp funkce pro ON_NOTIFY_EX a ON_NOTIFY_EX_RANGE jsou následující. Významy parametrů jsou stejné jako u jiných verzí než EX .

ON_NOTIFY_EX(nCode, id, memberFxn)
ON_NOTIFY_EX_RANGE(wNotifyCode, id, idLast, memberFxn)

Prototyp obou výše uvedených možností je stejný:

afx_msg BOOL memberFxn(UINT id, NMHDR* pNotifyStruct, LRESULT* result);

V obou případech obsahuje ID podřízený identifikátor ovládacího prvku, který oznámení odeslal.

Funkce musí vrátit hodnotu TRUE , pokud byla zpráva oznámení zcela zpracována nebo NEPRAVDA , pokud by jiné objekty ve směrování příkazů měly mít šanci zprávu zpracovat.

Viz také

Technické poznámky podle čísel
Technické poznámky podle kategorií