AFX-üzenetek

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.

Ezek az üzenetek az MFC-ben használatosak.

Messages

Az alábbi táblázat az MFC-kódtárban használt üzeneteket sorolja fel:

Üzenet Description [in] wParam lParam (Az összes paraméter [in], hacsak másként nem rendelkezik.) Visszaadott érték
AFX_WM_ACCGETOBJECT Nincs használatban. Nincs használatban. Nem alkalmazható. Nem alkalmazható.
AFX_WM_ACCGETSTATE Akadálymentességi támogatáshoz használható. Küldje el ezt az üzenetet CMFCPopupMenu az aktuális elem állapotának lekéréséhez vagy CMFCRibbonPanelMenu lekéréséhez. Elem indexe, amely lehet menügomb vagy elválasztó. Nincs használatban. Az elem állapota. -1, ha az index érvénytelen, 0, ha a menügomb nem rendelkezik speciális attribútumokkal. Ellenkező esetben a következő jelölők kombinációja:

TBBS_DISABLED – az elem le van tiltva

TBBS_CHECKED – az elem be van jelölve

TBBS_BUTTON – az elem egy szabványos nyomógomb

TBBS_PRESSED – gomb megnyomva

TBBS_INDETERMINATE – nem definiált állapot

TBBS_SEPARATOR – menügomb helyett ez az elem különválasztja a többi menüelemet
AFX_WM_CHANGE_ACTIVE_TAB A keretrendszer elküldi ezt az üzenetet az átméretezhető vezérlősáv-vezérlőnek. Feldolgozhatja ezt az üzenetet, hogy értesítéseket kapjon az objektumoktól CMFCTabCtrl , amikor egy felhasználó módosít egy aktív lapot. Egy lap indexe. Nincs használatban. Nonzero.
AFX_WM_CHANGE_CURRENT_FOLDER A keretrendszer elküldi ezt az üzenetet annak a szülőjének CMFCShellListCtrl , amikor a felhasználó módosította az aktuális mappát. Nincs használatban. Nincs használatban. Nincs használatban.
AFX_WM_CHANGEVISUALMANAGER A keretrendszer elküldi ezt az üzenetet az összes keretablaknak, amikor a felhasználó módosítja az aktuális Visual Managert. Az üzenetre válaszul a keretablak újraszámítja a régiót, és szükség szerint módosítja az egyéb paramétereket. Az AFX_WM_CHANGEVISUALMANAGER üzenetet feldolgozhatja az alkalmazásban, ha értesítést kell kapnia erről az eseményről. Az alaposztály-kezelőt (OnChangeVisualManager) meg kell hívnia annak biztosításához, hogy a keretrendszer az esemény belső feldolgozására kerüljön sor. Nincs használatban. Nincs használatban. Nincs használatban.
AFX_WM_CHANGING_ACTIVE_TAB Elküldve az objektum szülőjének CMFCTabCtrl . Dolgozza fel ezt az üzenetet, ha értesítéseket szeretne kapni az objektumoktól CMFCTabCtrl , amikor egy felhasználó alaphelyzetbe állít egy lapot. Az aktivált lap indexe. Nincs használatban. Nonzero.
AFX_WM_CHECKEMPTYMINIFRAME Csak belső használatra. Nem alkalmazható. Nem alkalmazható. Nem alkalmazható.
AFX_WM_CREATETOOLBAR Akkor küldi el CMFCToolBarsListPropertyPage , amikor egy felhasználó új eszköztárat hoz létre a testreszabási folyamat során. Ezt az üzenetet feldolgozva létrehozhat egy egyéni CMFCToolBar-származtatott objektumot. Ha ezt az üzenetet kezeli, és saját eszköztárat hoz létre, hagyja ki a hívást az alapértelmezett kezelőnek. Nincs használatban. Az eszköztár nevét tartalmazó sztringre mutató mutató. Mutató az újonnan létrehozott eszköztárra. A NULL azt jelzi, hogy az eszköztár létrehozása megszakadt.
AFX_WM_CUSTOMIZEHELP A testreszabási tulajdonságlapról CMFCToolbarCustomize Dialog a fő keretablakba küldve, amikor a felhasználó lenyomja a Súgó gombot vagy az F1 billentyűt. A testreszabási tulajdonságlap aktív lapját adja meg. Egy objektumra mutató CMFCToolbarCustomize Dialog mutató. Nulla.
AFX_WM_CUSTOMIZETOOLBAR Ez CMFCToolbarCustomize Dialog az üzenet értesíti a szülőkeretet, hogy a felhasználó új eszköztárat hoz létre. IGAZ a testreszabás indításakor, HAMIS, ha a testreszabás befejeződött. Nincs használatban. Nulla.
AFX_WM_DELETETOOLBAR A fő keretablakba küldve, amikor a felhasználó törölni készül egy eszköztárat a testreszabási módban.

Ezt az üzenetet feldolgozva további műveleteket hajthat végre, amikor egy felhasználó testreszabási módban töröl egy eszköztárat. Meg kell hívnia az alapértelmezett kezelőt (OnToolbarDelete), amely törli az eszköztárat. Az alapértelmezett kezelő egy értéket ad vissza, amely jelzi, hogy lehetséges-e törölni az eszköztárat.
Nincs használatban. Mutasson a CMFCToolBar törölni kívánt objektumra. Nem érvényes, ha az eszköztár nem törölhető; egyéb esetben 0.
AFX_WM_GETDOCUMENTCOLORS CMFCColorMenuButton ezt az üzenetet a fő keretablakba küldi a dokumentum színeinek lekéréséhez. Nincs használatban. [be, ki] Mutasson egy objektumra CList<COLORREF, COLORREF> . Nulla.
AFX_WM_GETDRAGBOUNDS Csak belső használatra. Nem alkalmazható. Nem alkalmazható. Nem alkalmazható.
AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM A fő keretablakba küldve, amikor egy felhasználó kiemel egy menüszalaglistaelemet. A kiemelt elem indexe Mutató a CMFCBaseRibbonElement Nincs használatban.
AFX_WM_ON_AFTER_SHELL_COMMAND A rendszerhéjparancsok végrehajtásának befejezésekor a rendszerhéj-parancsok szülőjének vagy CMFCShellTreeCtrl vezérlőinek CMFCShellListCtrl küldve. A felhasználó által végrehajtott parancs azonosítója Nincs használatban. Ha az alkalmazás feldolgozza ezt az üzenetet, nullát kell visszaadnia.
AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU A keretrendszer az előugró menü megjelenítése előtt elküldi ezt az üzenetet a menüszalag szülőjének. Ezt az üzenetet bármikor feldolgozhatja, és módosíthatja az előugró menüket. Nincs használatban. Mutató a CMFCBaseRibbonElement Nincs használatban.
AFX_WM_ON_CANCELTABMOVE Csak belső használatra. Nem alkalmazható. Nem alkalmazható.
AFX_WM_ON_CHANGE_RIBBON_CATEGORY A keretrendszer akkor küldi el ezt az üzenetet a főkeretbe, amikor a felhasználó módosítja az aktív menüszalag-vezérlő kategóriát. Nincs használatban. Mutató arra a CMFCRibbonBar kategóriára, amelynek a kategóriája megváltozott. Nincs használatban.
AFX_WM_ON_CLOSEPOPUPWINDOW A keretrendszer ezt az üzenetet küldi, hogy értesítse a tulajdonost CMFCDesktopAlertWnd arról, hogy az ablak hamarosan bezárul. Nincs használatban. Mutató az objektumhoz CMFCDesktopAlertWnd . Nincs használatban.
AFX_WM_ON_DRAGCOMPLETE Csak belső használatra. Nem alkalmazható. Nem alkalmazható. Nem alkalmazható.
AFX_WM_ON_GET_TAB_TOOLTIP Ha az egyéni elemleírások engedélyezve vannak, a fő keretablakba küldik, amikor egy tabulátorablak egy lap elemleírását szeretné megjeleníteni. Nincs használatban. Egy struktúra mutatója CMFCTabToolTipInfo . Nincs használatban.
AFX_WM_ON_HSCROLL Elküldve a méretezhető vezérlősáv vezérlőjének. Feldolgozhatja ezt az üzenetet, hogy értesítéseket kapjon az objektumoktól CMFCTabCtrl , amikor görgetési esemény történik a lapozott widget vízszintes görgetősávjában. Az alacsonyrendű szó egy görgetősáv-értéket ad meg, amely a felhasználó görgetési kérését jelzi. További információkért tekintse meg a témakör későbbi részében található táblázatot. Nincs használatban. Nonzero.
AFX_WM_ON_MOVE_TAB Egy lapozott ablak szülőjének küldve, amikor egy felhasználó új helyre húz egy lapot. A lap nulla alapú indexe az eredeti helyén. [kifelé] A tabulátor nulla alapú indexe az új helyén. Nulla.
AFX_WM_ON_MOVETABCOMPLETE Csak belső használatra. Nem alkalmazható. Nem alkalmazható. Nem alkalmazható.
AFX_WM_ON_MOVETOTABGROUP A fő keretablakba küldve, amikor egy felhasználó áthelyez egy MDI gyermekablakot az egyik lapozott csoportból a másikba. Egy többlapos ablak (CMFCTabCtrl) fogópontja, amelyből az MDI gyermekablaka el lett távolítva. [kifelé] Egy fogópont a többlapos ablakhoz (CMFCTabCtrl), amelyhez az MDI gyermekablak be lett szúrva. Figyelmen kívül hagyott.
AFX_WM_ON_PRESS_CLOSE_BUTTON Elküldve a szülőnek CDockablePane , amikor a felhasználó a vezérlősáv feliratán a Bezárás gombra kattint. Nincs használatban. Egy dokkolható ablaktábla mutatója, amelyen a felhasználó a Bezárás gombra kattintott. IGAZ, ha egy ablaktábla nem zárható be; egyéb esetben HAMIS.
AFX_WM_ON_RENAME_TAB A lapfül szülőjének küldve, miután a felhasználó átnevezett egy szerkeszthető lapot. Az átnevezett lap nulla alapú indexe. [kifelé] Az új lapnevet tartalmazó sztringre mutató mutató. Nonzero, ha az alkalmazás feldolgozza ezt az üzenetet; A keretrendszer letiltja a meghívást CMFCBaseTabCtrl::SetTabLabel. Ha a függvény nullát ad vissza, akkor CMFCBaseTabCtrl::SetTabLabel a keretrendszer meghívja.
AFX_WM_ON_RIBBON_CUSTOMIZE A szülőkeretbe küldve, amikor a felhasználó elkezdi a testreszabást. Feldolgozhatja ezt az üzenetet, ha meg szeretné jeleníteni a saját testreszabási párbeszédpaneljét. Nincs használatban. A testre szabandó menüszalag-vezérlőre mutató mutató. Nem kötelező, ha az alkalmazás feldolgozza ezt az üzenetet, és megjeleníti a saját testreszabási párbeszédpaneljét. Ha az alkalmazás nullát ad vissza, a keretrendszer megjeleníti a beépített testreszabási párbeszédpanelt.
AFX_WM_ON_TABGROUPMOUSEMOVE Csak belső használatra. Nem alkalmazható. Nem alkalmazható. Nem alkalmazható.
AFX_WM_POSTSETPREVIEWFRAME A fő keret értesítésére küldve, hogy a felhasználó módosította a nyomtatási kép módot Az IGAZ érték azt jelzi, hogy a nyomtatási kép mód be van állítva. A HAMIS azt jelzi, hogy a nyomtatási kép mód ki van kapcsolva. Nincs használatban. Nincs használatban.
AFX_WM_PROPERTY_CHANGED A tulajdonságrács-vezérlő (CMFCPropertyGridCtrl) tulajdonosának küldve, amikor a felhasználó módosítja a kijelölt tulajdonság értékét. A tulajdonságlista vezérlőazonosítója. A módosított tulajdonság (CMFCPropertyGridProperty) mutatója. Nincs használatban.
AFX_WM_RESETCONTEXTMENU A fő keretablakba küldve, amikor a felhasználó alaphelyzetbe állítja a helyi menüt a testreszabás során. A helyi menü erőforrás-azonosítója. Az aktuális helyi menüre mutató mutató. CMFCPopupMenu Nincs használatban.
AFX_WM_RESETKEYBOARD A keretrendszer elküldi ezt az üzenetet a fő keretablakba, amikor a felhasználó alaphelyzetbe állítja az összes billentyűzetgyorsítót a testreszabás során. Nincs használatban. Nincs használatban. Nincs használatban.
AFX_WM_RESETMENU A keretrendszer elküldi ezt az üzenetet a menü tulajdonosának (egy keretablaknak), amikor a felhasználó alaphelyzetbe állít egy alkalmazáskeret menüt a testreszabás során A menü erőforrás-azonosítója. Nincs használatban. Nincs használatban.
AFX_WM_RESETPROMPT A keretrendszer akkor küldi el ezt az üzenetet, ha a felhasználó visszaállít egy eszköztárat az eszköztár testreszabási párbeszédpaneléről. Az alapértelmezett kezelő egy üzenetmezőt jelenít meg, amely megkérdezi, hogy a felhasználó alaphelyzetbe kívánja-e állítani az eszköztárat. Nincs használatban. Nincs használatban. Nincs használatban.
AFX_WM_RESETTOOLBAR Az CMFCToolBar objektum akkor küldi el ezt az üzenetet, ha egy eszköztár visszaállítja az eredeti állapotát, vagyis betöltődik az erőforrásokból. Dolgozza fel ezt az üzenetet az eszköztárgombok újbóli beillesztéséhez, amelyek osztályai a következőből CMFCToolbarButtonszármaznak: További információért lásd CMFCToolbarComboBoxButton. Annak az eszköztárnak az erőforrás-azonosítója, amelynek állapotát visszaállították. Nincs használatban. Nulla.
AFX_WM_SHOWREGULARMENU CMFCToolbarMenuButton az objektum akkor küldi el ezt az üzenetet a tulajdonosának, ha a felhasználó egy normál menügombra kattint. Ezt az üzenetet minden alkalommal feldolgozhatja, CMFCToolbarMenuButton amikor egy előugró menüt jelenít meg, amikor a felhasználó egy gombra kattint. Az üzenetet küldő gomb parancsazonosítója. A kurzor képernyőkoordinátái. Az alacsonyrendű szó az x koordinátát adja meg. A magasrendű szó az y koordinátát határozza meg. Nincs használatban.
AFX_WM_TOOLBARMENU A fő keretablakba küldve, amikor a felhasználó felengedi az egér jobb gombját, miközben az egérmutató a panel ügyfél- vagy nem ügyfélterületén van. Nincs használatban. Az egérmutató képernyőkoordinátái. Az alacsonyrendű szó az x koordinátát adja meg. A magasrendű szó az y koordinátát határozza meg. Nulla, ha az alkalmazás feldolgozza ezt az üzenetet; egyéb esetben a nonzero.
AFX_WM_UPDATETOOLTIPS Minden elemleírás-tulajdonosnak elküldve, jelezve, hogy újra létre kell hozni az elemleírás-vezérlőket. Az üzenet feldolgozására vonatkozó vezérlő típusa. A lehetséges értékek listájáért tekintse meg a témakör későbbi részében található táblázatot. Nincs használatban. Nincs használatban.
AFX_WM_WINDOW_HELP CMFCWindowsManagerDialog ezt az üzenetet a szülőkeretbe küldi, amikor a felhasználó a Súgó gombra kattint, vagy a Súgó felirat gombjára vagy az F1 billentyűre kattintva belép a súgó üzemmódba. Nincs használatban. Mutató a példányra CMFCWindowsManagerDialog. Nincs használatban.

Az alábbi táblázat a AFX_WM_HSCROLL metódus lParam paraméterének alacsony szava értékeit mutatja be:

Érték Meaning
SB_ENDSCROLL A felhasználó befejezi a görgetést.
SB_LEFT A felhasználó a bal felső sarokba görget.
SB_RIGHT A felhasználó a jobb alsó sarokba görget.
SB_LINELEFT A felhasználó egy egységsel balra görget.
SB_LINERIGHT A felhasználó egy egységben görget.
SB_PAGELEFT A felhasználó az ablak szélessége szerint balra görget.
SB_PAGERIGHT A felhasználó jobbra görget az ablak szélessége szerint.
SB_THUMBPOSITION A felhasználó húzta a görgetődobozt (hüvelykujj), és felengedte az egérgombot. A magasrendű szó a görgetődoboz pozícióját jelzi a húzási művelet végén.
SB_THUMBTRACK A felhasználó húzza a görgetődobozt. A AFX_WM_ON_HSCROLL üzenet többször is el lesz küldve ezzel az értékkel, amíg a felhasználó fel nem oldja az egérgombot. A magasrendű szó azt a pozíciót jelzi, amelyre a görgetőmezőt húzták.

Megjegyzés:

Az lParam paraméter magasrendű szava határozza meg a görgetőmező aktuális pozícióját, ha az alacsonyrendű szó SB_THUMBPOSITION vagy SB_THUMBTRACK; ellenkező esetben ezt a szót nem használja a rendszer.

Az alábbi táblázat a AFX_WM_UPDATETOOLTIPS üzenet lParam paraméterének jelzőértékét sorolja fel:

Flag Érték
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

Lásd még

Makrók és globálisak