Üzenettérkép makrói (MFC)

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az üzenetleképezések támogatásához az MFC a következő makrókat biztosítja:

Message-Map deklarációs és elhatárolási makrók

Név	Description
`DECLARE_MESSAGE_MAP`	Deklarálja, hogy egy üzenettérképet használ egy osztály az üzenetek függvényekhez való leképezéséhez (az osztálydeklarációban kell használni).
`BEGIN_MESSAGE_MAP`	Elindítja az üzenettérkép definícióját (az osztály implementációjában kell használni).
`BEGIN_TEMPLATE_MESSAGE_MAP`	Elindítja az üzenettérkép definícióját egy olyan osztálytípuson, amely egyetlen sablonargumentumot tartalmaz.
`END_MESSAGE_MAP`	Véget vet az üzenettérkép definíciójának (az osztály implementációjában kell használni).

makrók Message-Mapping

Név	Description
`ON_COMMAND`	Azt jelzi, hogy melyik függvény fogja kezelni a megadott parancsüzenetet.
`ON_COMMAND_EX`	Azt jelzi, hogy melyik függvény fogja kezelni a megadott parancsüzenetet.
`ON_CONTROL`	Azt jelzi, hogy melyik függvény fogja kezelni a megadott vezérlőértesítési üzenetet.
`ON_MESSAGE`	Azt jelzi, hogy melyik függvény fogja kezelni a felhasználó által definiált üzeneteket.
`ON_OLECMD`	Azt jelzi, hogy melyik függvény fogja kezelni a DocObject vagy annak tárolója menüparancsait.
`ON_REGISTERED_MESSAGE`	Azt jelzi, hogy melyik függvény fogja kezelni a regisztrált felhasználó által megadott üzenetet.
`ON_REGISTERED_THREAD_MESSAGE`	Azt jelzi, hogy melyik függvény fogja kezelni a regisztrált, felhasználó által definiált üzenetet, ha van osztálya `CWinThread` .
`ON_THREAD_MESSAGE`	Azt jelzi, hogy melyik függvény fogja kezelni a felhasználó által definiált üzeneteket, ha van osztálya `CWinThread` .
`ON_UPDATE_COMMAND_UI`	Azt jelzi, hogy melyik függvény fogja kezelni a megadott felhasználói felület frissítési parancsüzenetét.

tartománymakrók Message-Map

Név	Description
`ON_COMMAND_RANGE`	Azt jelzi, hogy melyik függvény fogja kezelni a makró első két paraméterében megadott parancsazonosítók tartományát.
`ON_UPDATE_COMMAND_UI_RANGE`	Azt jelzi, hogy melyik frissítéskezelő fogja kezelni a makró első két paraméterében megadott parancsazonosítók tartományát.
`ON_CONTROL_RANGE`	Azt jelzi, hogy melyik függvény kezeli az értesítéseket a második és harmadik paraméterben megadott vezérlőazonosítók tartományától a makróig. Az első paraméter egy vezérlő-értesítési üzenet, például `BN_CLICKED`.

Az üzenetleképezésekről, az üzenettérkép-deklarációról és az elválasztó makrókról, valamint az üzenetleképezési makrókról további információt az Üzenettérképek és az Üzenetkezelés és -leképezés témakörökben talál. Az üzenetleképező tartományokról további információt a Message-Map tartományok kezelői című témakörben talál.

`BEGIN_MESSAGE_MAP`

Megkezdi az üzenettérkép definícióját.

Szemantika

BEGIN_MESSAGE_MAP( theClass, baseClass )

Paraméterek

theClass
Annak az osztálynak a nevét adja meg, amelynek üzenettérképe ez.

baseClass
A (z) alaposztályának theClassnevét adja meg.

Megjegyzések

Az osztály tagfüggvényeit definiáló implementációs (.cpp) fájlban indítsa el az üzenettérképet a BEGIN_MESSAGE_MAP makróval, majd adjon hozzá makróbejegyzéseket az egyes üzenetkezelő függvényekhez, és végezze el az üzenettérképet a END_MESSAGE_MAP makróval.

További információ az üzenettérképekről: Üzenettérképek

Example

BEGIN_MESSAGE_MAP(CMainFrame, CMDIFrameWnd)
   ON_WM_CREATE()
END_MESSAGE_MAP()

Requirements

Fejléc:afxwin.h

`BEGIN_TEMPLATE_MESSAGE_MAP`

Elindítja az üzenettérkép definícióját egy olyan osztálytípuson, amely egyetlen sablonargumentumot tartalmaz.

Szemantika

BEGIN_TEMPLATE_MESSAGE_MAP( theClass, type_name, baseClass )

Paraméterek

theClass
Annak az osztálynak a nevét adja meg, amelynek üzenettérképe ez.

type_name
Az osztályhoz megadott sablonparaméter neve.

baseClass
A (z) alaposztályának theClassnevét adja meg.

Megjegyzések

Ez a makró hasonló a BEGIN_MESSAGE_MAP makróhoz, de ez a makró egyetlen sablonargumentumot tartalmazó osztályokhoz készült.

Az osztály metódus-implementálási szakaszában indítsa el az üzenettérképet a BEGIN_TEMPLATE_MESSAGE_MAP makróval, majd adjon hozzá makróbejegyzéseket az egyes üzenetkezelő metódusokhoz, ahogyan egy normál üzenettérkép esetében tenné. A makróhoz BEGIN_MESSAGE_MAP hasonlóan töltse ki a sablon üzenettérképét a END_MESSAGE_MAP makróval.

A sablonosztályok üzenettérképeinek implementálásával kapcsolatos további információkért tekintse meg az Útmutató: Üzenettérkép létrehozása sablonosztályhoz című témakört.

Requirements

Fejléc:afxwin.h

`DECLARE_MESSAGE_MAP`

Deklarálja, hogy az osztály egy üzenettérképet határoz meg. A program minden CCmdTarget-származtatott osztályának tartalmaznia kell egy üzenettérképet az üzenetek kezeléséhez.

Szemantika

DECLARE_MESSAGE_MAP( )

Megjegyzések

Használja a makrót DECLARE_MESSAGE_MAP az osztálydeklaráció végén. Ezután az osztály tagfüggvényeit meghatározó .cpp fájlban használja a makrót, az BEGIN_MESSAGE_MAP egyes üzenetkezelő függvények makróbejegyzéseit és a makrót END_MESSAGE_MAP .

Megjegyzés:

Ha bármelyik tagot később DECLARE_MESSAGE_MAPdeklarálja, új hozzáférési típust (publicprivatevagy protected) kell megadnia számukra.

Az üzenetleképezésekkel és a makróval kapcsolatos további információkért tekintse meg az DECLARE_MESSAGE_MAPÜzenetkezelési és -leképezési témaköröket.

Example

class CMainFrame : public CMDIFrameWnd
{
   DECLARE_MESSAGE_MAP()

   // Remainder of class declaration omitted.

Requirements

Fejléc:afxwin.h

`END_MESSAGE_MAP`

Véget vet az üzenettérkép definíciójának.

Szemantika

END_MESSAGE_MAP( )

Megjegyzések

Az üzenetleképezésekkel és a makróval kapcsolatos további információkért tekintse meg az END_MESSAGE_MAPÜzenetkezelési és -leképezési témaköröket.

Requirements

Fejléc:afxwin.h

`ON_COMMAND`

Ez a makró egy parancsüzenetet képez le egy tagfüggvénybe.

Szemantika

ON_COMMAND( commandId, memberFxn )

Paraméterek

commandId
A parancs azonosítója.

memberFxn
Annak az üzenetkezelő függvénynek a neve, amelyhez a parancs megfeleltetve van.

Megjegyzések

Azt jelzi, hogy melyik függvény fogja kezelni a parancs felhasználói felületi objektumából érkező parancsüzeneteket, például egy menüelemet vagy egy eszköztárgombot.

Ha egy parancs-célobjektum egy Windows-üzenetet WM_COMMAND kap a megadott azonosítóval, ON_COMMAND meghívja a tagfüggvényt memberFxn az üzenet kezelésére.

Egyetlen parancs tagfüggvényhez való leképezéséhez használható ON_COMMAND . Parancsazonosítók ON_COMMAND_RANGE tartományának leképezése egy tagfüggvényre. Csak egy üzenettérkép-bejegyzés felelhet meg egy adott parancsazonosítónak. Vagyis egy parancs nem képezhető le egynél több kezelőhöz. További információkért és példákért tekintse meg az üzenetkezelési és -leképezési témaköröket.

Example

BEGIN_MESSAGE_MAP(CMFCListViewDoc, CDocument)
   ON_COMMAND(ID_MYCOMMAND, &CMFCListViewDoc::OnMycommand)
END_MESSAGE_MAP()

Requirements

Fejléc:afxmsg_.h

`ON_COMMAND_EX`

Kiterjesztett parancskezelő tagfüggvény.

Szemantika

ON_COMMAND_EX(commandId, memberFxn);

Paraméterek

commandId
A parancs azonosítója.

memberFxn
Annak az üzenetkezelő függvénynek a neve, amelyhez a parancs megfeleltetve van.

Megjegyzések

A parancsüzenet-kezelők kibővített formája speciális használatra is elérhető. A ON_COMMAND_EX makrót az ilyen üzenetkezelőkhöz használják, és a funkció szuperhalmazát ON_COMMAND biztosítja. A kiterjesztett parancskezelő tagfüggvények egyetlen paramétert használnak, amely UINT tartalmazza a parancsazonosítót, és visszaadnak egy BOOL. A visszatérési értéknek TRUE azt kell jeleznie, hogy a parancs kezelése megtörtént; ellenkező esetben az útválasztás továbbra is más parancs célobjektumokra fog irányulni.

További információ: Műszaki megjegyzés [TN006: Üzenettérképek]tm006-message-maps.md).

Requirements

Fejlécfájl: afxmsg_.h

`ON_CONTROL`

Azt jelzi, hogy melyik függvény fogja kezelni az egyéni vezérlésről szóló értesítési üzenetet.

Szemantika

ON_CONTROL( wNotifyCode, commandId, memberFxn )

Paraméterek

wNotifyCode
A vezérlő értesítési kódja.

commandId
A parancs azonosítója.

memberFxn
Annak az üzenetkezelő függvénynek a neve, amelyhez a parancs megfeleltetve van.

Megjegyzések

A vezérlő értesítési üzenetei azok, amelyeket a vezérlők a szülőablakba küldenek.

Az üzenettérképen pontosan egy ON_CONTROL makróutasításnak kell lennie minden vezérlőértesítési üzenethez, amelyet le kell képezni egy üzenetkezelő függvényre.

További információkért és példákért tekintse meg az üzenetkezelési és -leképezési témaköröket.

Requirements

Fejléc:afxmsg_.h

`ON_MESSAGE`

Azt jelzi, hogy melyik függvény fogja kezelni a felhasználó által definiált üzeneteket.

Szemantika

ON_MESSAGE( message, memberFxn )

Paraméterek

message
Az üzenet azonosítója.

memberFxn
Annak az üzenetkezelő függvénynek a neve, amelyhez az üzenet megfeleltetve van.

A függvény típusának a következőnek kell lennie afx_msg LRESULT (CWnd::*)(WPARAM, LPARAM): .

Megjegyzések

A felhasználó által definiált üzenetek olyan üzenetek, amelyek nem szabványos Windows-üzenetek WM_MESSAGE . Üzenetazonosító kiválasztásakor a (0x0400) tartományon WM_USER belüli értékeket kell használnia a 0x7FFF vagy WM_APP (0x8000) 0xBFFF. Az üzenetazonosítókkal kapcsolatos további információkért lásd: WM_APP.

Az üzenettérképen pontosan egy ON_MESSAGE makróutasításnak kell lennie minden felhasználó által definiált üzenethez, amelyet le kell képezni egy üzenetkezelő függvényre.

Megjegyzés:

A felhasználó által definiált üzenetek ON_MESSAGE mellett a kevésbé gyakori Windows-üzeneteket is kezeli. További információ: Üzenettérképek.

További információkért és példákért lásd: Üzenetkezelési és -leképezési témakörök és User-Defined kezelők

Example

#define WM_MYMESSAGE (WM_USER + 100)

BEGIN_MESSAGE_MAP(CMyWnd2, CWnd)
   ON_MESSAGE(WM_MYMESSAGE, OnMyMessage)
END_MESSAGE_MAP()

// inside the class declaration
afx_msg LRESULT OnMyMessage(WPARAM wParam, LPARAM lParam);

LRESULT CMyWnd2::OnMyMessage(WPARAM wParam, LPARAM lParam)
{
   UNREFERENCED_PARAMETER(wParam);
   UNREFERENCED_PARAMETER(lParam);

   // Handle message here.

   return 0;
}

Requirements

Fejléc:afxmsg_.h

`ON_OLECMD`

Parancsok átirányítása a parancsok küldőfelületén IOleCommandTargetkeresztül.

Szemantika

ON_OLECMD( pguid, olecmdid, commandId )

Paraméterek

pguid
Annak a parancscsoportnak az azonosítója, amelyhez a parancs tartozik. A standard csoporthoz használható NULL .

olecmdid
Az OLE parancs azonosítója.

commandId
A parancsot kibocsátó erőforrás vagy objektum menüazonosítója, eszköztárazonosítója, gombazonosítója vagy egyéb azonosítója.

Megjegyzések

IOleCommandTarget Lehetővé teszi a tároló számára, hogy fogadja a DocObject felhasználói felületéről származó parancsokat, és lehetővé teszi, hogy a tároló ugyanazokat a parancsokat küldje el a DocObject parancsainak (például Új, Megnyitás, Mentési beállítások és Nyomtatás a Fájl menüben, valamint Másolás, Beillesztés, Visszavonás stb.) egy DocObjectbe.

IOleCommandTarget egyszerűbb, mint az OLE Automationé IDispatch. IOleCommandTarget teljes egészében olyan parancsokra támaszkodik, amelyek ritkán rendelkeznek argumentumokkal, és nem tartalmaznak típusinformációkat (a típusbiztonság a parancsargumentumok esetében is csökken). Ha argumentumokkal kell elküldenie a parancsokat, használja a következőt COleServerDoc::OnExecOleCmd: .

A IOleCommandTarget standard menüparancsokat az MFC a következő makrókban implementálta:

ON_OLECMD_CLEARSELECTION( )

A Törlés szerkesztése parancsot küldi el. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_CLEARSELECTION, ID_EDIT_CLEAR)

ON_OLECMD_COPY( )

Elküldi a Másolás szerkesztése parancsot. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_COPY, ID_EDIT_COPY)

ON_OLECMD_CUT( )

A Kivágás szerkesztése parancsot küldi el. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_CUT, ID_EDIT_CUT)

ON_OLECMD_NEW( )

Elküldi az Új fájl parancsot. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_NEW, ID_FILE_NEW)

ON_OLECMD_OPEN( )

A Fájlmegnyitás parancs elküldése. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_OPEN, ID_FILE_OPEN)

ON_OLECMD_PAGESETUP( )

A Fájllap beállítása parancs elküldése. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_PAGESETUP, ID_FILE_PAGE_SETUP)

ON_OLECMD_PASTE( )

A Beillesztés szerkesztése parancsot küldi el. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_PASTE, ID_EDIT_PASTE)

ON_OLECMD_PASTESPECIAL( )

A Speciális beillesztés szerkesztése parancsot küldi el. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_PASTESPECIAL, ID_EDIT_PASTE_SPECIAL)

ON_OLECMD_PRINT( )

A Fájlnyomtatás parancs elküldése. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_PRINT, ID_FILE_PRINT)

ON_OLECMD_PRINTPREVIEW( )

A Fájlnyomtatás előnézete parancs elküldése. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_PRINTPREVIEW, ID_FILE_PRINT_PREVIEW)

ON_OLECMD_REDO( )

Elküldi az Edit Redo parancsot. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_REDO, ID_EDIT_REDO)

ON_OLECMD_SAVE( )

A Fájl mentése parancs elküldése. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_SAVE, ID_FILE_SAVE)

ON_OLECMD_SAVE_AS( )

A Fájl mentése másként parancsot küldi el. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_SAVEAS, ID_FILE_SAVE_AS)

ON_OLECMD_SAVE_COPY_AS( )

A Fájl mentése másolás másként parancsot küldi el. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_SAVECOPYAS, ID_FILE_SAVE_COPY_AS)

ON_OLECMD_SELECTALL( )

Elküldi az Összes kijelölése parancsot. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_SELECTALL, ID_EDIT_SELECT_ALL)

ON_OLECMD_UNDO( )

A Visszavonás szerkesztése parancsot küldi el. Implementálva a következő módon:

ON_OLECMD(NULL, OLECMDID_UNDO, ID_EDIT_UNDO)

Requirements

Fejléc:afxdocob.h

`ON_REGISTERED_MESSAGE`

A Windows RegisterWindowMessage függvény egy új ablaküzenet definiálására szolgál, amely garantáltan egyedi lesz a rendszerben.

Szemantika

ON_REGISTERED_MESSAGE( nMessageVariable, memberFxn )

Paraméterek

nMessageVariable
A regisztrált ablak-üzenet azonosító változója.

memberFxn
Annak az üzenetkezelő függvénynek a neve, amelyhez az üzenet megfeleltetve van.

Megjegyzések

Ez a makró azt jelzi, hogy melyik függvény fogja kezelni a regisztrált üzenetet.

További információkért és példákért tekintse meg az üzenetkezelési és -leképezési témaköröket.

Example

static UINT NEAR WM_FIND = RegisterWindowMessage(_T("COMMDLG_FIND"));

BEGIN_MESSAGE_MAP(CMyWnd3, CWnd)
   ON_REGISTERED_MESSAGE(WM_FIND, OnFind)
END_MESSAGE_MAP()

Requirements

Fejléc:afxmsg_.h

`ON_REGISTERED_THREAD_MESSAGE`

Azt jelzi, hogy melyik függvény fogja kezelni a Windows-függvény RegisterWindowMessage által regisztrált üzenetet.

Szemantika

ON_REGISTERED_THREAD_MESSAGE(nMessageVariable, memberFxn )

Paraméterek

nMessageVariable
A regisztrált ablak-üzenet azonosító változója.

memberFxn
Annak a -message-handler függvénynek a CWinThreadneve, amelyhez az üzenet megfeleltetve van.

Megjegyzések

RegisterWindowMessage olyan új ablaküzenetek definiálására szolgál, amelyek garantáltan egyediek lesznek a rendszerben. ON_REGISTERED_THREAD_MESSAGE osztály helyett ON_REGISTERED_MESSAGECWinThread kell használni.

Requirements

Fejléc:afxmsg_.h

`ON_THREAD_MESSAGE`

Azt jelzi, hogy melyik függvény fogja kezelni a felhasználó által definiált üzeneteket.

Szemantika

ON_THREAD_MESSAGE( message, memberFxn )

Paraméterek

message
Az üzenet azonosítója.

memberFxn
Annak a -message-handler függvénynek a CWinThreadneve, amelyhez az üzenet megfeleltetve van.

Megjegyzések

ON_THREAD_MESSAGE osztály helyett ON_MESSAGECWinThread kell használni. A felhasználó által definiált üzenetek olyan üzenetek, amelyek nem szabványos Windows-üzenetek WM_MESSAGE . Az üzenettérképen pontosan egy ON_THREAD_MESSAGE makróutasításnak kell lennie minden felhasználó által definiált üzenethez, amelyet le kell képezni egy üzenetkezelő függvényre.

Requirements

Fejléc:afxole.h

`ON_UPDATE_COMMAND_UI`

Ez a makró azt jelzi, hogy melyik függvény fogja kezelni a felhasználói felület frissítési parancsüzenetét.

Szemantika

ON_UPDATE_COMMAND_UI( messageId, memberFxn )

Paraméterek

messageId
Az üzenet azonosítója.

memberFxn
Annak az üzenetkezelő függvénynek a neve, amelyhez az üzenet megfeleltetve van.

Megjegyzések

Az üzenettérképen pontosan egy ON_UPDATE_COMMAND_UI makróutasításnak kell lennie minden olyan felhasználói felületi frissítési parancshoz, amelyet le kell képezni egy üzenetkezelő függvényre.

További információkért és példákért tekintse meg az üzenetkezelési és -leképezési témaköröket.

Requirements

Fejléc:afxole.h

`ON_COMMAND_RANGE`

Ezzel a makróval egy összefüggő parancsazonosító-tartományt képezhet le egyetlen üzenetkezelő függvényre.

Szemantika

ON_COMMAND_RANGE( id1, id2, memberFxn )

Paraméterek

id1
Parancsazonosító a parancsazonosítók egy összefüggő tartományának elején.

id2
Parancsazonosító a parancsazonosítók egy összefüggő tartományának végén.

memberFxn
Annak az üzenetkezelő függvénynek a neve, amelyhez a parancsok megfeleltetve vannak.

Megjegyzések

Az azonosítók tartománya a következővel id1 kezdődik és végződik id2: .

Parancsazonosítók ON_COMMAND_RANGE tartományának leképezése egy tagfüggvényre. Egyetlen parancs tagfüggvényhez való leképezéséhez használható ON_COMMAND . Csak egy üzenettérkép-bejegyzés felelhet meg egy adott parancsazonosítónak. Vagyis egy parancs nem képezhető le egynél több kezelőhöz. Az üzenettartományok leképezéséről további információt a Message-Map tartományok kezelői című témakörben talál.

Az üzenettérkép-tartományok nem támogatottak automatikusan, ezért a makrót önnek kell elhelyeznie.

Example

// The code fragment below shows how to use ON_COMMAND_RANGE macro
// to map a contiguous range of command IDs to a single message
// handler function (i.e. OnRangeCmds() in the sample below). In
// addition, it also shows how to use CheckMenuRadioItem() to check a
// selected menu item and makes it a radio item.

BEGIN_MESSAGE_MAP(CChildFrame, CMDIChildWnd)
   ON_COMMAND_RANGE(ID_COMMAND_RANGECMD1, ID_COMMAND_RANGECMD3, &CChildFrame::OnRangeCmds)
END_MESSAGE_MAP()

void CChildFrame::OnRangeCmds(UINT nID)
{
   CMenu* mmenu = AfxGetMainWnd()->GetMenu();
   CMenu* submenu = mmenu->GetSubMenu(5);
   submenu->CheckMenuRadioItem(ID_COMMAND_RANGECMD1, ID_COMMAND_RANGECMD3,
      nID, MF_BYCOMMAND);
}

Requirements

Fejléc:afxmsg_.h

`ON_UPDATE_COMMAND_UI_RANGE`

A parancsazonosítók egy összefüggő tartományát egyetlen frissítési üzenetkezelő függvényre képezi le.

Szemantika

ON_UPDATE_COMMAND_UI_RANGE( id1, id2, memberFxn )

Paraméterek

id1
Parancsazonosító a parancsazonosítók egy összefüggő tartományának elején.

id2
Parancsazonosító a parancsazonosítók egy összefüggő tartományának végén.

memberFxn
Annak a frissítési üzenetkezelő függvénynek a neve, amelyhez a parancsok megfeleltetve vannak.

Megjegyzések

Az üzenetkezelők frissítése frissíti a parancshoz társított menüelemek és eszköztárgombok állapotát. Az azonosítók tartománya a következővel id1 kezdődik és végződik id2: .

Az üzenettérkép-tartományok nem támogatottak automatikusan, ezért a makrót önnek kell elhelyeznie.

Requirements

Fejléc:afxmsg_.h

`ON_CONTROL_RANGE`

Ezzel a makróval egy összefüggő vezérlőazonosító-tartományt képezhet le egy adott Windows-értesítési üzenet egyetlen üzenetkezelő függvényére, például BN_CLICKED.

Szemantika

ON_CONTROL_RANGE( wNotifyCode, id1, id2, memberFxn )

Paraméterek

wNotifyCode
Az az értesítési kód, amelyre a kezelő válaszol.

id1
Parancsazonosító a vezérlőazonosítók egy összefüggő tartományának elején.

id2
Parancsazonosító a vezérlőazonosítók egy összefüggő tartományának végén.

memberFxn
Annak az üzenetkezelő függvénynek a neve, amelyhez a vezérlők le vannak képezve.

Megjegyzések

Az azonosítók tartománya a következővel id1 kezdődik és végződik id2: . A rendszer meghívja a kezelőt a megadott értesítésre, amely a megfeleltetett vezérlők bármelyikéből származik.

Az üzenettérkép-tartományok nem támogatottak automatikusan, ezért a makrót önnek kell elhelyeznie.

A vezérlőfüggvények vezérlőazonosítókhoz való implementálásával kapcsolatos további információkért tekintse meg Message-Map tartományok kezelőit.

Requirements

Fejléc:afxmsg_.h

Lásd még

ON_COMMAND
TN006: Üzenettérképek
COleCmdUI osztály
COleServerDoc::OnExecOleCmd
RegisterWindowMessage
User-Defined kezelők
CCmdUI osztály

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-02-25

Megosztás a következőn keresztül:

Üzenettérkép makrói (MFC)

Message-Map deklarációs és elhatárolási makrók

makrók Message-Mapping

tartománymakrók Message-Map

BEGIN_MESSAGE_MAP

Szemantika

Paraméterek

Megjegyzések

Example

Requirements

BEGIN_TEMPLATE_MESSAGE_MAP

Szemantika

Paraméterek

Megjegyzések

Requirements

DECLARE_MESSAGE_MAP

Szemantika

Megjegyzések

Example

Requirements

END_MESSAGE_MAP

Szemantika

Megjegyzések

Requirements

ON_COMMAND

Szemantika

Paraméterek

Megjegyzések

Example

Requirements

ON_COMMAND_EX

Szemantika

Paraméterek

Megjegyzések

Requirements

ON_CONTROL

Szemantika

Paraméterek

Megjegyzések

Requirements

ON_MESSAGE

Szemantika

Paraméterek

Megjegyzések

Example

Requirements

ON_OLECMD

Szemantika

Paraméterek

Megjegyzések

Requirements

ON_REGISTERED_MESSAGE

Szemantika

Paraméterek

Megjegyzések

Example

Requirements

ON_REGISTERED_THREAD_MESSAGE

Szemantika

Paraméterek

Megjegyzések

Requirements

ON_THREAD_MESSAGE

Szemantika

Paraméterek

Megjegyzések

Requirements

ON_UPDATE_COMMAND_UI

Szemantika

Paraméterek

Megjegyzések

Requirements

ON_COMMAND_RANGE

Szemantika

Paraméterek

Megjegyzések

Example

Requirements

ON_UPDATE_COMMAND_UI_RANGE

`BEGIN_MESSAGE_MAP`

`BEGIN_TEMPLATE_MESSAGE_MAP`

`DECLARE_MESSAGE_MAP`

`END_MESSAGE_MAP`

`ON_COMMAND`

`ON_COMMAND_EX`

`ON_CONTROL`

`ON_MESSAGE`

`ON_OLECMD`

`ON_REGISTERED_MESSAGE`

`ON_REGISTERED_THREAD_MESSAGE`

`ON_THREAD_MESSAGE`

`ON_UPDATE_COMMAND_UI`

`ON_COMMAND_RANGE`

`ON_UPDATE_COMMAND_UI_RANGE`

`ON_CONTROL_RANGE`