Messaggi di AFX

Questi messaggi sono utilizzati in MFC.

Messaggi

Nella tabella seguente sono elencati i messaggi utilizzati nella libreria MFC:

Messaggio

Descrizione

[in] wParam

lParam (tutti i parametri siano [in] non specificato diversamente.)

Valore restituito

AFX_WM_ACCGETOBJECT

Non utilizzato.

Non utilizzato.

Non applicabile.

Non applicabile.

AFX_WM_ACCGETSTATE

Utilizzato per il supporto per l'accessibilità.Inviare il messaggio a CMFCPopupMenu o a CMFCRibbonPanelMenu per recuperare lo stato dell'elemento corrente.

Indice dell'elemento, che un pulsante o un carattere separatore del menu.

Non utilizzato.

Lo stato dell'elemento.È -1 se l'indice non è valido, 0 se il pulsante del menu non dispone di attributi speciali.In caso contrario è una combinazione dei seguenti flag:

TBBS_DISABLED – l'elemento è disabilitato

TBBS_CHECKED – l'elemento viene controllato

TBBS_BUTTON – l'elemento è un pulsante standard

TBBS_PRESSED – il pulsante viene premuto

TBBS_INDETERMINATE – stato non definito

TBBS_SEPARATOR - anziché un pulsante del menu, questo elemento forma una separazione tra altre voci di menu

AFX_WM_CHANGE_ACTIVE_TAB

Il framework invia il messaggio al controllo ridimensionabile barra di controllo.Elabora questo messaggio per ricevere notifiche dagli oggetti di CMFCTabCtrl quando un utente modifica una scheda attiva.

L'indice di una scheda.

Non utilizzato.

Diverso da zero.

AFX_WM_CHANGE_CURRENT_FOLDER

Il framework invia il messaggio al padre di CMFCShellListCtrl quando l'utente ha modificato la cartella corrente.

Non utilizzato.

Non utilizzato.

Non utilizzato.

AFX_WM_CHANGEVISUALMANAGER

Il framework invia il messaggio a tutte le applicazioni utilizzano quando l'utente modifica il gestore visualizzazione corrente.In risposta a questo messaggio, una finestra cornice ricalcola la relativa area e modificare altri parametri in base alle necessità.È possibile elaborare il messaggio di AFX_WM_CHANGEVISUALMANAGER nell'applicazione se è necessario essere informati su questo evento.È necessario chiamare il gestore della classe base (OnChangeVisualManager) per assicurarsi che l'elaborazione interna del framework di questo evento si verifica.

Non utilizzato.

Non utilizzato.

Non utilizzato.

AFX_WM_CHANGING_ACTIVE_TAB

Inviato al padre dell'oggetto di CMFCTabCtrl.Elabora questo messaggio se si desidera ricevere notifiche dagli oggetti di CMFCTabCtrl quando un utente reimposta una scheda.

L'indice della scheda da attivare.

Non utilizzato.

Diverso da zero.

AFX_WM_CHECKEMPTYMINIFRAME

Solo per uso interno.

Non applicabile.

Non applicabile.

Non applicabile.

AFX_WM_CREATETOOLBAR

Inviato da CMFCToolBarsListPropertyPage quando un utente crea una nuova barra degli strumenti durante il processo di personalizzazione.È possibile elaborare questo messaggio per creare un'istanza di un oggetto derivato CMFCToolBar- personalizzato.Se si gestisce questo messaggio e creare una barra degli strumenti, omettere la chiamata al gestore predefinito.

Non utilizzato.

Un puntatore a una stringa contenente il nome della barra degli strumenti.

Un puntatore alla barra degli strumenti appena creato.Il valore indica che la creazione della barra degli strumenti è stata annullata.

AFX_WM_CUSTOMIZEHELP

Inviato alla finestra cornice principale dalla finestra delle proprietà CMFCToolbarCustomizeDialog di personalizzazione quando viene premuto il pulsante Guida o il tasto F1.

Specifica la pagina attiva la finestra delle proprietà di personalizzazione.

Un puntatore a un oggetto di CMFCToolbarCustomizeDialog.

Zero.

AFX_WM_CUSTOMIZETOOLBAR

CMFCToolbarCustomizeDialog invia il messaggio per notificare al frame padre che l'utente sta creando una nuova barra degli strumenti.

TRUE quando la personalizzazione viene avviata, FALSE quando la personalizzazione viene completata.

Non utilizzato.

Zero.

AFX_WM_DELETETOOLBAR

Inviato alla finestra cornice principale quando l'utente sta per eliminare una barra degli strumenti in modalità di personalizzazione.

Elabora questo messaggio per intraprendere azioni aggiuntive quando un utente elimina una barra degli strumenti in modalità di personalizzazione.È inoltre necessario chiamare il gestore predefinito (OnToolbarDelete), che elimina la barra degli strumenti.Il gestore predefinito restituisce un valore che indica se è possibile eliminare la barra degli strumenti.

Non utilizzato.

Puntatore a un oggetto di CMFCToolBar da eliminare.

Diverso da zero se una barra degli strumenti non può essere eliminato; in caso contrario 0.

AFX_WM_GETDOCUMENTCOLORS

CMFCColorMenuButton invia il messaggio alla finestra cornice principale per recuperare i colori documenti.

Non utilizzato.

[in, out] puntatore a un oggetto di CList<COLORREF, COLORREF>.

Zero.

AFX_WM_GETDRAGBOUNDS

Solo per uso interno.

Non applicabile.

Non applicabile.

Non applicabile.

AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM

Inviato alla finestra cornice principale quando un utente evidenzia un elemento elenco della barra multifunzione.

Indice dell'elemento evidenziato

Un puntatore a CMFCBaseRibbonElement

Non utilizzato.

AFX_WM_ON_AFTER_SHELL_COMMAND

Inviato al padre di CMFCShellListCtrl o comandi di CMFCShellTreeCtrl quando un utente completa eseguire un comando della shell.

ID di comando che l'utente ha eseguito

Non utilizzato.

Se i processi dell'applicazione questo messaggio, restituisce zero.

AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU

Il framework invia il messaggio al padre della barra multifunzione prima di visualizzare il menu di scelta rapida.È possibile elaborare questo messaggio e modificare i menu di scelta rapida in qualsiasi momento.

Non utilizzato.

Un puntatore a CMFCBaseRibbonElement

Non utilizzato.

AFX_WM_ON_CANCELTABMOVE

Solo per uso interno.

Non applicabile.

Non applicabile.

AFX_WM_ON_CHANGE_RIBBON_CATEGORY

Il framework invia il messaggio alla cornice principale quando l'utente modifica la categoria attiva il controllo della barra multifunzione.

Non utilizzato.

Un puntatore a CMFCRibbonBar della categoria ha modificato.

Non utilizzato.

AFX_WM_ON_CLOSEPOPUPWINDOW

Il framework invia il messaggio per informare il proprietario di CMFCDesktopAlertWnd che la finestra sta per chiudere.

Non utilizzato.

Un puntatore all'oggetto di CMFCDesktopAlertWnd.

Non utilizzato.

AFX_WM_ON_DRAGCOMPLETE

Solo per uso interno.

Non applicabile.

Non applicabile.

Non applicabile.

AFX_WM_ON_GET_TAB_TOOLTIP

Inviato alla finestra cornice principale quando una finestra a schede sta la visualizzazione di una descrizione comandi della scheda, se le descrizioni comandi personalizzate abilitate.

Non utilizzato.

Un puntatore a una struttura di CMFCTabToolTipInfo.

Non utilizzato.

AFX_WM_ON_HSCROLL

Inviato al controllo ridimensionabile barra di controllo.Elabora questo messaggio per ricevere notifiche dagli oggetti di CMFCTabCtrl quando un evento di scorrimento si trova nella barra di scorrimento orizzontale a schede widget.

Il word meno significativa specifica un valore della barra di scorrimento che indica la richiesta di scorrimento dell'utente.Per ulteriori informazioni, vedere la tabella più avanti in questo argomento.

Non utilizzato.

Diverso da zero.

AFX_WM_ON_MOVE_TAB

Inviato al padre di una finestra a schede quando l'utente trascina una scheda in una nuova posizione.

L'indice in base zero della scheda nella posizione originale.

[out] l'indice in base zero della scheda nella nuova posizione.

Zero.

AFX_WM_ON_MOVETABCOMPLETE

Solo per uso interno.

Non applicabile.

Non applicabile.

Non applicabile.

AFX_WM_ON_MOVETOTABGROUP

Inviato alla finestra cornice principale quando un utente sposta una finestra figlio MDI da un gruppo catalogato a un altro.

Un handle di finestra a schedeCMFCTabCtrl() da cui la finestra figlio MDI è stata rimossa.

[out] handle Alla finestra a schedeCMFCTabCtrl() che la finestra figlio MDI viene immessa.

Ignorato.

AFX_WM_ON_PRESS_CLOSE_BUTTON

Inviato al padre di CDockablePane quando l'utente fa clic sul pulsante Chiudi sulla barra del titolo della barra di controllo.

Non utilizzato.

Un puntatore a un riquadro ancorabile su cui l'utente ha fatto clic sul pulsante Chiudi.

TRUE se un riquadro non può essere chiuso, in caso contrario FALSE.

AFX_WM_ON_RENAME_TAB

Inviato al padre della finestra a schede dopo che l'utente ha modificato una scheda modificabile.

L'indice in base zero della scheda rinominata.

[out] puntatore A una stringa contenente il nome della scheda.

Diverso da zero se i processi dell'applicazione questo messaggio, il framework dalla chiamata a CMFCBaseTabCtrl::SetTabLabel.Se restituire zero, quindi CMFCBaseTabCtrl::SetTabLabel viene chiamato dal framework.

AFX_WM_ON_RIBBON_CUSTOMIZE

Inviato al frame padre quando l'utente avvia la personalizzazione.Elabora questo messaggio per visualizzare la finestra di dialogo di personalizzazione.

Non utilizzato.

Un puntatore al controllo della barra multifunzione da personalizzare.

Diverso da zero se i processi dell'applicazione questo messaggio e visualizzare la relativa finestra di dialogo di personalizzazione.Se l'applicazione restituisce zero, il framework di visualizzare la finestra di dialogo incorporata di personalizzazione.

AFX_WM_ON_TABGROUPMOUSEMOVE

Solo per uso interno.

Non applicabile.

Non applicabile.

Non applicabile.

AFX_WM_POSTSETPREVIEWFRAME

Inviato per notificare alla cornice principale che l'utente ha modificato la modalità anteprima di stampa

TRUE indica che la modalità anteprima di stampa è impostata su.FALSE indica che la modalità anteprima di stampa è disattivata.

Non utilizzato.

Non utilizzato.

AFX_WM_PROPERTY_CHANGED

Inviato al proprietario del controllo griglia delle proprietà (CMFCPropertyGridCtrl) quando l'utente modifica il valore della proprietà selezionata.

ID del controllo dell'elenco.

Un puntatore alla proprietà (CMFCPropertyGridProperty) che ha modificato.

Non utilizzato.

AFX_WM_RESETCONTEXTMENU

Inviato alla finestra cornice principale quando l'utente reimposta il menu di scelta rapida durante la personalizzazione.

ID di risorsa del menu di scelta rapida.

Un puntatore al menu di scelta rapida corrente, CMFCPopupMenu.

Non utilizzato.

AFX_WM_RESETKEYBOARD

Il framework invia il messaggio alla finestra cornice principale quando l'utente reimposta tutti i tasti di scelta rapida durante la personalizzazione.

Non utilizzato.

Non utilizzato.

Non utilizzato.

AFX_WM_RESETMENU

Il framework invia il messaggio al proprietario del menu (una finestra cornice) quando l'utente reimposta un menu di frame di applicazione durante la personalizzazione

L'id della risorsa menu

Non utilizzato.

Non utilizzato.

AFX_WM_RESETPROMPT

Il framework invia il messaggio quando l'utente reimposta una barra degli strumenti dalla barra degli strumenti della finestra di dialogo.Il gestore di impostazione predefinita visualizzata una finestra di messaggio in cui viene richiesto se l'utente desidera reimpostare la barra degli strumenti.

Non utilizzato.

Non utilizzato.

Non utilizzato.

AFX_WM_RESETTOOLBAR

Un oggetto di CMFCToolBar invia il messaggio quando una barra degli strumenti viene ripristinato allo stato originale, ovvero, caricare le risorse.Elabora questo messaggio reinserire i pulsanti della barra degli strumenti di cui le classi che derivano da CMFCToolbarButton.Per ulteriori informazioni, vedere CMFCToolbarComboBoxButton.

ID di risorsa di una barra degli strumenti con lo stato è stato ripristinato.

Non utilizzato.

Zero.

AFX_WM_SHOWREGULARMENU

l'oggetto diCMFCToolbarMenuButton invia il messaggio al proprietario quando l'utente fa clic su un pulsante standard del menu.Elaborare ogni volta che il messaggio che si utilizza CMFCToolbarMenuButton per visualizzare un menu di scelta rapida quando l'utente fa clic su un pulsante.

L'id di comando di un pulsante che invia il messaggio.

Coordinate dello schermo del cursore.Il word meno significativa specifica la coordinata x.Il word più significativa specifica la coordinata y.

Non utilizzato.

AFX_WM_TOOLBARMENU

Inviato alla finestra cornice principale quando l'utente rilascia il pulsante destro del mouse mentre il puntatore del mouse consiste nell'area non client di un riquadro.

Non utilizzato.

Coordinate dello schermo del puntatore del mouse.Il word meno significativa specifica la coordinata x.Il word più significativa specifica la coordinata y.

Zero se i processi dell'applicazione questo messaggio, in caso contrario, diverso da zero.

AFX_WM_UPDATETOOLTIPS

Inviato a tutti i proprietari di descrizione comandi per indicare che i controlli di descrizione comandi devono essere ricreati.

Il tipo di controllo che deve elaborare questo messaggio.Vedere la tabella più avanti in questo argomento per un elenco di valori possibili.

Non utilizzato.

Non utilizzato.

AFX_WM_WINDOW_HELP

CMFCWindowsManagerDialog invia il messaggio al frame padre quando l'utente fa clic sul pulsante Guida, oppure attivata la modalità guida facendo clic sul pulsante della barra del titolo Guida o il tasto F1.

Non utilizzato.

Un puntatore a un'istanza di CMFCWindowsManagerDialog.

Non utilizzato.

Nella tabella seguente vengono mostrati i valori per il word inferiore del parametro di lParam il metodo di AFX_WM_HSCROLL:

Valore

Significato

SB_ENDSCROLL

L'utente termina lo scorrimento.

SB_LEFT

Scorre dell'utente in alto a sinistra.

SB_RIGHT

Scorre dell'utente nella parte inferiore destra.

SB_LINELEFT

L'utente scorre sinistro da un'unità.

SB_LINERIGHT

Scorre dell'utente a destra da un'unità.

SB_PAGELEFT

L'utente scorre sinistro della larghezza della finestra.

SB_PAGERIGHT

Scorre dell'utente a destra della larghezza della finestra.

SB_THUMBPOSITION

L'utente ha trascinato la casella di scorrimento appare) e ha rilasciato il pulsante del mouse.Il word più significativo indica la posizione della casella di scorrimento alla fine dell'operazione di trascinamento.

SB_THUMBTRACK

L'utente sta trascinando la casella di scorrimento.Il messaggio di AFX_WM_ON_HSCROLL viene inviato ripetutamente con questo valore finché non rilasciare il pulsante del mouse.Il word più significativo indica la posizione in cui la casella di scorrimento è stato trascinato.

[!NOTA]

Il word più significativa del parametro di lParam specifica la posizione corrente della casella di scorrimento se il word meno significativa è SB_THUMBPOSITION o SB_THUMBTRACK; in caso contrario, questa parola non viene utilizzata.

Nella tabella seguente sono elencati i valori di flag per il parametro di lParam del messaggio di AFX_WM_UPDATETOOLTIPS:

Flag

Valore

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

Vedere anche

Concetti

Macro MFC e Globals