Condividi tramite

Messaggi AFX

  • Articolo

Questi messaggi vengono usati in MFC.

Messaggi

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

Message Descrizione [in] wParam lParam (tutti i parametri sono [in] se non diversamente specificato. Valore restituito
AFX_WM_ACCGETOBJECT Non utilizzato. Non utilizzato. Non applicabile. Non applicabile.
AFX_WM_ACCGETSTATE Usato per il supporto dell'accessibilità. Inviare questo messaggio a CMFCPopupMenu o CMFCRibbonPanelMenu per recuperare lo stato dell'elemento corrente. Indice dell'elemento, che può essere un pulsante o un separatore di menu. Non utilizzato. Stato dell'elemento. È -1 se l'indice non è valido, 0 se il pulsante di menu non ha attributi speciali. In caso contrario, è una combinazione dei flag seguenti:

TBBS_DISABLED : l'elemento è disabilitato

TBBS_CHECKED : l'elemento è selezionato

TBBS_BUTTON : l'elemento è un pulsante di pressione standard

TBBS_PRESSED : viene premuto il pulsante

TBBS_INDETERMINATE : stato non definito

TBBS_SEPARATOR - anziché un pulsante di menu, questo elemento costituisce una separazione tra altre voci di menu
AFX_WM_CHANGE_ACTIVE_TAB Il framework invia questo messaggio al controllo barra di controllo ridimensionabile. Elaborare questo messaggio per ricevere notifiche dagli CMFCTabCtrl oggetti quando un utente modifica una scheda attiva. Indice di una scheda. Non utilizzato. Diverso da zero.
AFX_WM_CHANGE_CURRENT_FOLDER Il framework invia questo messaggio all'elemento padre di CMFCShellListCtrl quando l'utente ha modificato la cartella corrente. Non utilizzato. Non utilizzato. Non utilizzato.
AFX_WM_CHANGEVISUALMANAGER Il framework invia questo messaggio a tutte le finestre cornice quando l'utente modifica l'oggetto Visual Manager corrente. In risposta a questo messaggio, una finestra cornice ricalcola l'area e regola gli altri parametri in base alle esigenze. È possibile elaborare il messaggio di AFX_WM_CHANGEVISUALMANAGER nell'applicazione se è necessario ricevere una notifica su questo evento. È necessario chiamare il gestore della classe di base (OnChangeVisualManager) per assicurarsi che venga eseguita l'elaborazione interna del framework di questo evento. Non utilizzato. Non utilizzato. Non utilizzato.
AFX_WM_CHANGING_ACTIVE_TAB Inviato all'elemento padre dell'oggetto CMFCTabCtrl . Elaborare questo messaggio se si desidera ricevere notifiche dagli CMFCTabCtrl oggetti quando un utente reimposta una scheda. Indice della scheda in fase di attivazione. 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 personalizzato derivato da CMFCToolBar. Se si gestisce questo messaggio e si crea una barra degli strumenti personalizzata, omettere la chiamata al gestore predefinito. Non utilizzato. Puntatore a una stringa contenente il nome della barra degli strumenti. Puntatore alla barra degli strumenti appena creata. NULL indica che la creazione della barra degli strumenti è stata annullata.
AFX_WM_CUSTOMIZEHELP Inviato alla finestra cornice principale dalla finestra CMFCToolbarCustomize Dialog delle proprietà di personalizzazione quando l'utente preme il pulsante ? o il tasto F1. Specifica la pagina attiva della finestra delle proprietà di personalizzazione. Puntatore a un oggetto CMFCToolbarCustomize Dialog. Zero.
AFX_WM_CUSTOMIZETOOLBAR Invia CMFCToolbarCustomize Dialog questo messaggio per notificare al frame padre che l'utente sta creando una nuova barra degli strumenti. TRUE all'avvio della personalizzazione, FALSE al termine della personalizzazione. Non utilizzato. Zero.
AFX_WM_DELETETOOLBAR Inviato alla finestra cornice principale quando l'utente sta per eliminare una barra degli strumenti nella modalità di personalizzazione.

Elaborare questo messaggio per eseguire azioni aggiuntive quando un utente elimina una barra degli strumenti in modalità di personalizzazione. È anche 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 CMFCToolBar oggetto da eliminare. Diverso da zero se non è possibile eliminare una barra degli strumenti; in caso contrario, 0.
AFX_WM_GETDOCUMENTCOLORS CMFCColorMenuButton invia questo messaggio alla finestra cornice principale per recuperare i colori del documento. Non utilizzato. [in, out] Puntatore a un CList<COLORREF, COLORREF> oggetto . 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 una voce di elenco della barra multifunzione. Indice dell'elemento evidenziato Puntatore a CMFCBaseRibbonElement Non utilizzato.
AFX_WM_ON_AFTER_SHELL_COMMAND Inviato a un elemento padre di CMFCShellListCtrl o CMFCShellTreeCtrl controlli quando un utente termina l'esecuzione di un comando della shell. ID del comando eseguito dall'utente Non utilizzato. Se l'applicazione elabora questo messaggio, deve restituire zero.
AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU Il framework invia questo messaggio all'elemento padre della barra multifunzione prima di visualizzare il menu a comparsa. È possibile elaborare questo messaggio e modificare i menu popup in qualsiasi momento. Non utilizzato. 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 questo messaggio al frame principale quando l'utente modifica la categoria di controllo della barra multifunzione attiva. Non utilizzato. Puntatore all'oggetto la CMFCRibbonBar cui categoria è stata modificata. Non utilizzato.
AFX_WM_ON_CLOSEPOPUPWINDOW Il framework invia questo messaggio per notificare al proprietario CMFCDesktopAlertWnd che la finestra sta per essere chiusa. Non utilizzato. Puntatore all'oggetto 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 di tabulazioni sta per visualizzare una descrizione comando per una scheda, se sono abilitate descrizioni comando personalizzate. Non utilizzato. Puntatore a una CMFCTabToolTipInfo struttura. Non utilizzato.
AFX_WM_ON_HSCROLL Inviato al controllo barra di controllo ridimensionabile. Elaborare questo messaggio per ricevere notifiche dagli CMFCTabCtrl oggetti quando si verifica un evento di scorrimento nella barra di scorrimento orizzontale del widget a schede. La parola con ordine basso 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 all'elemento padre di una finestra a schede quando un utente trascina una scheda in una nuova posizione. Indice in base zero della scheda nella posizione originale. [out] 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 a schede a un altro. Handle per la finestra a schede (CMFCTabCtrl) da cui è stata rimossa la finestra figlio MDI. [out] Handle per la finestra a schede (CMFCTabCtrl) in cui è stata inserita la finestra figlio MDI. Ignorato.
AFX_WM_ON_PRESS_CLOSE_BUTTON Inviato a un elemento padre di CDockablePane quando l'utente fa clic sul pulsante Chiudi sulla didascalia della barra di controllo. Non utilizzato. Puntatore a un riquadro ancorabile in cui l'utente ha fatto clic sul pulsante Chiudi . TRUE se non è possibile chiudere un riquadro; in caso contrario FALSE.
AFX_WM_ON_RENAME_TAB Inviato all'elemento padre della finestra a schede dopo che l'utente ha rinominato una scheda modificabile. Indice in base zero della scheda rinominata. [out] Puntatore a una stringa contenente il nuovo nome della scheda. Diverso da zero se l'applicazione elabora questo messaggio; il framework elimina la chiamata a CMFCBaseTabCtrl::SetTabLabel. Se viene restituito zero, CMFCBaseTabCtrl::SetTabLabel viene chiamato dal framework.
AFX_WM_ON_RIBBON_CUSTOMIZE Inviato al frame padre all'avvio della personalizzazione dell'utente. Elabora questo messaggio se vuoi visualizzare la tua finestra di dialogo di personalizzazione. Non utilizzato. Puntatore al controllo della barra multifunzione da personalizzare. Diverso da zero se l'applicazione elabora questo messaggio e visualizza la propria finestra di dialogo di personalizzazione. Se l'applicazione restituisce zero, il framework visualizzerà la finestra di dialogo di personalizzazione predefinita.
AFX_WM_ON_TABGROUPMOUSEMOVE Solo per uso interno. Non applicabile. Non applicabile. Non applicabile.
AFX_WM_POSTSETPREVIEWFRAME Inviato per notificare al frame principale che l'utente ha modificato la modalità di anteprima di stampa TRUE indica che è impostata la modalità di anteprima di stampa. 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 di proprietà. Puntatore alla proprietà (CMFCPropertyGridProperty) modificata. Non utilizzato.
AFX_WM_RESETCONTEXTMENU Inviato alla finestra cornice principale quando l'utente reimposta il menu di scelta rapida durante la personalizzazione. ID risorsa del menu di scelta rapida. Puntatore al menu di scelta rapida corrente, CMFCPopupMenu. Non utilizzato.
AFX_WM_RESETKEYBOARD Il framework invia questo messaggio alla finestra cornice principale quando l'utente reimposta tutti gli acceleratori di tastiera durante la personalizzazione. Non utilizzato. Non utilizzato. Non utilizzato.
AFX_WM_RESETMENU Il framework invia questo messaggio al proprietario del menu (una finestra cornice) quando l'utente reimposta un menu cornice dell'applicazione durante la personalizzazione ID risorsa del menu. Non utilizzato. Non utilizzato.
AFX_WM_RESETPROMPT Il framework invia questo messaggio quando l'utente reimposta una barra degli strumenti dalla finestra di dialogo Personalizza barra degli strumenti. Il gestore predefinito visualizza una finestra di messaggio che chiede se l'utente vuole reimpostare la barra degli strumenti. Non utilizzato. Non utilizzato. Non utilizzato.
AFX_WM_RESETTOOLBAR Un CMFCToolBar oggetto invia questo messaggio quando una barra degli strumenti viene ripristinata allo stato originale, ovvero caricata dalle risorse. Elaborare questo messaggio per reinserire i pulsanti della barra degli strumenti le cui classi sono derivate da CMFCToolbarButton. Per ulteriori informazioni, vedere CMFCToolbarComboBoxButton. ID risorsa di una barra degli strumenti il cui stato è stato ripristinato. Non utilizzato. Zero.
AFX_WM_SHOWREGULARMENU CMFCToolbarMenuButton l'oggetto invia questo messaggio al proprietario quando l'utente fa clic su un pulsante di menu normale. Elabora questo messaggio ogni volta che usi CMFCToolbarMenuButton per visualizzare un menu a comparsa quando l'utente fa clic su un pulsante. ID comando di un pulsante che invia il messaggio. Coordinate dello schermo del cursore. La parola con ordine basso specifica la coordinata x. La parola di ordine elevato specifica la coordinata y. Non utilizzato.
AFX_WM_TOOLBARMENU Inviato alla finestra cornice principale quando l'utente rilascia il pulsante destro di un mouse mentre il puntatore del mouse si trova nell'area client o non client di un riquadro. Non utilizzato. Coordinate dello schermo del puntatore del mouse. La parola con ordine basso specifica la coordinata x. La parola di ordine elevato specifica la coordinata y. Zero se l'applicazione elabora questo messaggio; in caso contrario, diverso da zero.
AFX_WM_UPDATETOOLTIPS Inviato a tutti i proprietari delle descrizioni comandi per indicare che i controlli della descrizione comando devono essere ricreati. Tipo di controllo che deve elaborare il messaggio. Vedere la tabella più avanti in questo argomento per un elenco di valori possibili. Non utilizzato. Non utilizzato.
AFX_WM_WINDOW_HELP CMFCWindowsManagerDialoginvia questo messaggio al frame padre quando l'utente fa clic sul pulsante ? oppure passa alla modalità Guida facendo clic sul pulsante Della Guida o sul tasto F1. Non utilizzato. Puntatore all'istanza di CMFCWindowsManagerDialog. Non utilizzato.

Nella tabella seguente vengono illustrati i valori per la parola bassa del parametro lParam del metodo AFX_WM_HSCROLL:

Valore Significato
SB_ENDSCROLL L'utente termina lo scorrimento.
SB_LEFT L'utente scorre verso l'alto a sinistra.
SB_RIGHT L'utente scorre verso il basso a destra.
SB_LINELEFT L'utente scorre verso sinistra di un'unità.
SB_LINERIGHT L'utente scorre verso destra di un'unità.
SB_PAGELEFT L'utente scorre verso sinistra in base alla larghezza della finestra.
SB_PAGERIGHT L'utente scorre verso destra in base alla larghezza della finestra.
SB_THUMBPOSITION L'utente ha trascinato la casella di scorrimento (pollice) e ha rilasciato il pulsante del mouse. La parola di ordine elevato 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 AFX_WM_ON_HSCROLL viene inviato ripetutamente con questo valore fino a quando l'utente non rilascia il pulsante del mouse. La parola di ordine elevato indica la posizione in cui è stata trascinata la casella di scorrimento.

Nota

La parola di ordine elevato del parametro lParam specifica la posizione corrente della casella di scorrimento se la parola in ordine basso è SB_THUMBPOSITION o SB_THUMBTRACK; in caso contrario, questa parola non viene utilizzata.

Nella tabella seguente sono elencati i valori del flag per il parametro 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

Vedi anche

Macro e globali