Share via


Mensajes de AFX

Estos mensajes se utilizan en MFC.

Mensajes

La tabla siguiente se enumeran los mensajes que se utilizan en la biblioteca MFC:

Mensaje

Descripción

[in] wParam

lParam (los parámetros Todo se [in] a menos que se indique lo contrario.)

Valor devuelto

AFX_WM_ACCGETOBJECT

No se utiliza.

No se utiliza.

No es aplicable

No es aplicable

AFX_WM_ACCGETSTATE

Se utiliza para la compatibilidad con la accesibilidad.Enviar este mensaje a CMFCPopupMenu o a CMFCRibbonPanelMenu recuperar el estado del elemento actual.

Índice del elemento, que puede ser un botón de menú o un separador.

No se utiliza.

El estado del elemento.Es -1 si el índice no es válido, 0 si el botón de menú no tiene ningún atributo especial.Si no es una combinación de los siguientes indicadores:

TBBS_DISABLED – el elemento está deshabilitado

TBBS_CHECKED – se comprueba el elemento

TBBS_BUTTON – el elemento es un mismo botón estándar

TBBS_PRESSED – se presiona el botón

TBBS_INDETERMINATE – estado undefined

TBBS_SEPARATOR - en lugar de un botón de menú, este elemento forma una separación entre otros elementos de menú

AFX_WM_CHANGE_ACTIVE_TAB

El marco envía este mensaje al control de tamaño variable de barra de control.Procesar este mensaje para recibir notificaciones de los objetos de CMFCTabCtrl cuando un usuario cambia una pestaña activa.

El índice de una pestaña.

No se utiliza.

Distinto de cero.

AFX_WM_CHANGE_CURRENT_FOLDER

El marco envía este mensaje al elemento primario de CMFCShellListCtrl cuando el usuario ha cambiado la carpeta actual.

No se utiliza.

No se utiliza.

No se utiliza.

AFX_WM_CHANGEVISUALMANAGER

El marco envía este mensaje a todas las ventanas de marco cuando el usuario cambia el administrador Visual actual.En respuesta a este mensaje, una ventana de marco actualiza su región y ajusta otros parámetros según sea necesario.Puede procesar el mensaje de AFX_WM_CHANGEVISUALMANAGER en la aplicación si necesita ser notificará este evento.Debe llamar al controlador de la clase base (OnChangeVisualManager) para asegurarse de que tiene lugar el procesamiento interno de este evento.

No se utiliza.

No se utiliza.

No se utiliza.

AFX_WM_CHANGING_ACTIVE_TAB

Enviado al elemento primario del objeto de CMFCTabCtrl.Procesar este mensaje si desea recibir notificaciones de los objetos de CMFCTabCtrl cuando un usuario restablece una pestaña.

El índice de tabulación se está activando que.

No se utiliza.

Distinto de cero.

AFX_WM_CHECKEMPTYMINIFRAME

Solo para uso interno.

No es aplicable

No es aplicable

No es aplicable

AFX_WM_CREATETOOLBAR

Enviado desde CMFCToolBarsListPropertyPage cuando un usuario crea una barra de herramientas nueva durante el proceso de personalización.Puede procesar este mensaje para crear instancias de un objeto CMFCToolBar- derivado personalizado.Si controla este mensaje y crea posee la barra de herramientas, se omitirá la llamada al controlador predeterminado.

No se utiliza.

Un puntero a una cadena que contiene el nombre de la barra de herramientas.

Un puntero a la barra de herramientas recién creada.NULL indica que la creación de la barra de herramientas se canceló.

AFX_WM_CUSTOMIZEHELP

Enviado a la ventana de marco principal de la hoja de propiedades CMFCToolbarCustomizeDialog de personalización cuando el usuario presiona el botón Ayuda o F1.

Especifica la página activa de la hoja de propiedades de personalización.

Un puntero a un objeto de CMFCToolbarCustomizeDialog.

Cero

AFX_WM_CUSTOMIZETOOLBAR

CMFCToolbarCustomizeDialog envía este mensaje para notificar el cuadro primario que el usuario está creando una nueva barra de herramientas.

TRUE cuando se inicia la personalización, FALSE cuando la personalización.

No se utiliza.

Cero

AFX_WM_DELETETOOLBAR

Enviado a la ventana de marco principal cuando el usuario está a punto de eliminar una barra de herramientas en el modo de personalización.

Procesar este mensaje para tomar medidas adicionales cuando un usuario elimina una barra de herramientas en modo de personalización.También debe llamar al controlador predeterminado (OnToolbarDelete), lo que elimina la barra de herramientas.El controlador predeterminado devuelve un valor que indica si es posible eliminar la barra de herramientas.

No se utiliza.

Puntero a un objeto de CMFCToolBar que se va a eliminar.

Distinto de cero si una barra de herramientas no puede eliminarse; si no 0.

AFX_WM_GETDOCUMENTCOLORS

CMFCColorMenuButton envía este mensaje en la ventana de marco principal para recuperar los colores del documento.

No se utiliza.

[in, out] Puntero a un objeto de CList<COLORREF, COLORREF>.

Cero

AFX_WM_GETDRAGBOUNDS

Solo para uso interno.

No es aplicable

No es aplicable

No es aplicable

AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM

Enviado a la ventana de marco principal cuando un usuario resalta un elemento de lista de la cinta de opciones.

Índice del elemento resaltado

Un puntero a CMFCBaseRibbonElement

No se utiliza.

AFX_WM_ON_AFTER_SHELL_COMMAND

Enviados a un elemento primario de CMFCShellListCtrl o controles de CMFCShellTreeCtrl cuando un usuario termina de ejecutar un comando de shell.

El identificador de comando que el usuario ha ejecutado

No se utiliza.

Si los procesos de aplicación este mensaje, se devuelve cero.

AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU

El marco envía este mensaje al elemento primario de la cinta de opciones antes de enviar el menú emergente.Puede procesar este mensaje y modificar menús emergentes en cualquier momento.

No se utiliza.

Un puntero a CMFCBaseRibbonElement

No se utiliza.

AFX_WM_ON_CANCELTABMOVE

Solo para uso interno.

No es aplicable

No es aplicable

AFX_WM_ON_CHANGE_RIBBON_CATEGORY

El marco envía este mensaje al marco principal cuando el usuario cambia la categoría activo del Control ribbon.

No se utiliza.

Un puntero a CMFCRibbonBar cuya categoría ha cambiado.

No se utiliza.

AFX_WM_ON_CLOSEPOPUPWINDOW

El marco envía este mensaje para notificar al propietario de CMFCDesktopAlertWnd que la ventana está a punto de cerrarla.

No se utiliza.

Un puntero al objeto de CMFCDesktopAlertWnd.

No se utiliza.

AFX_WM_ON_DRAGCOMPLETE

Solo para uso interno.

No es aplicable

No es aplicable

No es aplicable

AFX_WM_ON_GET_TAB_TOOLTIP

Enviado a la ventana de marco principal cuando una ventana de la pestaña se va a mostrar la información sobre herramientas de una pestaña, si se habilitan la información sobre herramientas personalizadas.

No se utiliza.

Un puntero a una estructura de CMFCTabToolTipInfo.

No se utiliza.

AFX_WM_ON_HSCROLL

Enviado al control de tamaño variable de barra de control.Procesar este mensaje para recibir notificaciones de los objetos de CMFCTabCtrl cuando un evento de desplazamiento aparece en la barra de desplazamiento horizontal con fichas widget.

La palabra de orden inferior especifica un valor de desplazamiento que indica la solicitud de desplazamiento del usuario.Para obtener más información, vea la tabla más adelante en este tema.

No se utiliza.

Distinto de cero.

AFX_WM_ON_MOVE_TAB

Enviado al elemento primario de una ventana con fichas cuando un usuario arrastra una pestaña a una nueva posición.

El índice cero- basado en la ficha en su posición original.

[out] El índice cero- basado de la pestaña en la nueva posición.

Cero

AFX_WM_ON_MOVETABCOMPLETE

Solo para uso interno.

No es aplicable

No es aplicable

No es aplicable

AFX_WM_ON_MOVETOTABGROUP

Enviado a la ventana de marco principal cuando un usuario mueve una ventana MDI secundaria a partir de un grupo con fichas a otro.

Un identificador de la ventana con fichas (CMFCTabCtrl) de las que se ha quitado la ventana MDI secundaria.

[out] Un identificador de la ventana con fichas (CMFCTabCtrl) a las que se ha insertado la ventana MDI secundaria.

Se omitirá.

AFX_WM_ON_PRESS_CLOSE_BUTTON

Enviados a un elemento primario de CDockablePane cuando el usuario hace clic en el botón Cerrar en la leyenda de la barra de control.

No se utiliza.

Un puntero a un panel acoplable en el que el usuario hizo clic en el botón Cerrar.

TRUE si un panel no puede cerrar; si no es FALSE.

AFX_WM_ON_RENAME_TAB

Enviado al elemento primario de la ventana con fichas cuando el usuario cambió una ficha modificable.

El índice cero- basado en la ficha cuyo nombre ha cambiado.

[out] Un puntero a una cadena que contiene el nuevo nombre de la pestaña.

Distinto de cero si los procesos de aplicación este mensaje; el marco suprimirá la llamada a CMFCBaseTabCtrl::SetTabLabel.Si se devuelve cero, después CMFCBaseTabCtrl::SetTabLabel llama el marco.

AFX_WM_ON_RIBBON_CUSTOMIZE

Enviado al cuadro primario cuando el usuario inicia la personalización.Procesar este mensaje si desea mostrar dispone del cuadro de diálogo personalización.

No se utiliza.

Un puntero al control de la cinta que se personalizará.

Distinto de cero si los procesos de aplicación este mensaje y muestra su propio cuadro de diálogo personalización.Si la aplicación devuelve cero, el marco se mostrará el cuadro de diálogo integrado de personalización.

AFX_WM_ON_TABGROUPMOUSEMOVE

Solo para uso interno.

No es aplicable

No es aplicable

No es aplicable

AFX_WM_POSTSETPREVIEWFRAME

Enviados para notificar al marco principal que el usuario cambia el modo de vista previa de impresión

TRUE indica que está establecido el modo de vista previa de impresión.FALSE indica que se desactiva el modo de vista previa de impresión.

No se utiliza.

No se utiliza.

AFX_WM_PROPERTY_CHANGED

Enviado al propietario del control de cuadrícula de propiedades (CMFCPropertyGridCtrl) cuando el usuario cambia el valor de la propiedad seleccionada.

El identificador de control de la lista de propiedades.

Un puntero a la propiedad (CMFCPropertyGridProperty) que cambió.

No se utiliza.

AFX_WM_RESETCONTEXTMENU

Enviado a la ventana de marco principal cuando el usuario restablece el menú contextual durante la personalización.

El Id. de recurso de menú contextual.

Un puntero al menú contextual actual, CMFCPopupMenu.

No se utiliza.

AFX_WM_RESETKEYBOARD

El marco envía este mensaje en la ventana de marco principal cuando el usuario restablece todos los aceleradores de teclado durante la personalización.

No se utiliza.

No se utiliza.

No se utiliza.

AFX_WM_RESETMENU

El marco envía este mensaje al propietario de menú (una ventana de marco) cuando el usuario restaurar un menú del cuadro de la aplicación durante la personalización

El identificador de recurso de menú

No se utiliza.

No se utiliza.

AFX_WM_RESETPROMPT

El marco envía este mensaje cuando el usuario restablece una barra de herramientas de la barra de herramientas personalizar el cuadro de diálogo.El controlador predeterminado muestra un cuadro de mensaje que pregunta si el usuario desea restaurar la barra de herramientas.

No se utiliza.

No se utiliza.

No se utiliza.

AFX_WM_RESETTOOLBAR

Un objeto de CMFCToolBar envía este mensaje cuando una barra de herramientas se restaura su estado original, es decir, carga de recursos.Procesar este mensaje para reinsertar los botones de la barra de herramientas cuyas clases se derivan de CMFCToolbarButton.Para obtener más información, vea CMFCToolbarComboBoxButton.

El Id. de recurso de una barra de herramientas cuya restablecieron a estado.

No se utiliza.

Cero

AFX_WM_SHOWREGULARMENU

el objeto de CMFCToolbarMenuButton envía este mensaje al propietario cuando el usuario hace clic en un botón de menú regular.Procesar este mensaje cada vez que se usa CMFCToolbarMenuButton para mostrar un menú emergente cuando el usuario hace clic en un botón.

El identificador de comando de un botón que envía el mensaje.

Coordenadas de pantalla del cursor.La palabra de orden inferior especifica la x-coordenada.La palabra de alto nivel especifica la y-coordenada.

No se utiliza.

AFX_WM_TOOLBARMENU

Enviado a la ventana de marco principal cuando el usuario suelta el botón secundario del mouse mientras el puntero del mouse se encuentra en el área de cliente o de no cliente de un panel.

No se utiliza.

Coordenadas de la pantalla del puntero del mouse.La palabra de orden inferior especifica la x-coordenada.La palabra de alto nivel especifica la y-coordenada.

Cero si los procesos de aplicación este mensaje; si no, distinto de cero.

AFX_WM_UPDATETOOLTIPS

Enviado a todos los propietarios de información sobre herramientas para indicar que los controles de información sobre herramientas deben ser recreado.

El tipo de control que debe procesar este mensaje.Vea la tabla más adelante en este tema para obtener una lista de valores posibles.

No se utiliza.

No se utiliza.

AFX_WM_WINDOW_HELP

CMFCWindowsManagerDialog envía este mensaje al cuadro primario cuando el usuario hace clic en el botón Ayuda, o entra en el modo de ayuda haciendo clic en el botón de título Ayuda o F1.

No se utiliza.

Un puntero a la instancia de CMFCWindowsManagerDialog.

No se utiliza.

La tabla siguiente se muestran los valores para word insuficiente de parámetro de lParam del método de AFX_WM_HSCROLL:

Valor

Significado

SB_ENDSCROLL

El usuario finaliza el desplazamiento.

SB_LEFT

Los desplazamientos de usuario al superior izquierdo.

SB_RIGHT

Los desplazamientos de usuario al bajo- derecho.

SB_LINELEFT

El usuario se desplaza a la izquierda por una unidad.

SB_LINERIGHT

Los desplazamientos de usuario derecha por una unidad.

SB_PAGELEFT

El usuario se desplaza a la izquierda el ancho de la ventana.

SB_PAGERIGHT

Los desplazamientos de usuario derecha según el ancho de la ventana.

SB_THUMBPOSITION

El usuario ha arrastrado el cuadro de desplazamiento (control) y se libera el botón del mouse.La palabra de alto nivel indica la posición del cuadro de desplazamiento al final de la operación de arrastre.

SB_THUMBTRACK

El usuario está arrastrando el cuadro de desplazamiento.El mensaje de AFX_WM_ON_HSCROLL se envía repetidamente con este valor hasta el usuario suelta el botón del mouse.La palabra de alto nivel indica la posición en la que se ha arrastrado el cuadro de desplazamiento.

[!NOTA]

La palabra de alto nivel del parámetro de lParam especifica la posición actual del cuadro de desplazamiento si la palabra de orden inferior es SB_THUMBPOSITION o SB_THUMBTRACK; si no, esta palabra no se utiliza.

La tabla siguiente se enumeran los valores de marca para el parámetro de lParam de mensajes de AFX_WM_UPDATETOOLTIPS:

Marcador

Valor

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

Vea también

Conceptos

Macros y funciones globales de MFC