Mensajes AFX

Estos mensajes se usan en MFC.

Mensajes

En la tabla siguiente se enumeran los mensajes que se usan en la biblioteca MFC:

Mensaje	Descripción	[in] wParam	lParam (todos los parámetros son [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 usa para la compatibilidad de accesibilidad. Envíe este mensaje a CMFCPopupMenu o CMFCRibbonPanelMenu para recuperar el estado del elemento actual.	Índice del elemento, que podría ser un botón de menú o separador.	No se utiliza.	Estado del elemento. Es -1 si el índice no es válido, 0 si el botón de menú no tiene atributos especiales. De lo contrario, es una combinación de las marcas siguientes: TBBS_DISABLED: el elemento está deshabilitado. TBBS_CHECKED: el elemento está activado. TBBS_BUTTON: el elemento es un botón de inserción estándar. TBBS_PRESSED: el botón está presionado. TBBS_INDETERMINATE: estado indefinido. 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 barra de control redimensionable. Procese este mensaje para recibir notificaciones de objetos CMFCTabCtrl cuando un usuario cambie una ficha activa.	Índice de una ficha.	No se utiliza.	Diferente 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 vuelve a calcular 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 recibir una notificación sobre este evento. Debe llamar al controlador de clase base (OnChangeVisualManager) para asegurarse de que tiene lugar el procesamiento interno del marco de este evento.	No se utiliza.	No se utiliza.	No se utiliza.
AFX_WM_CHANGING_ACTIVE_TAB	Envía el elemento primario del objeto CMFCTabCtrl. Procese este mensaje si quiere recibir notificaciones de objetos CMFCTabCtrl cuando un usuario restablece una ficha.	El índice de la ficha que se está activando.	No se utiliza.	Diferente de cero.
AFX_WM_CHECKEMPTYMINIFRAME	Para uso interno únicamente.	No es aplicable.	No es aplicable.	No es aplicable.
AFX_WM_CREATETOOLBAR	Se envía desde CMFCToolBarsListPropertyPage cuando un usuario crea una nueva barra de herramientas durante el proceso de personalización. Puede procesar este mensaje para crear una instancia de un objeto derivado de CMFCToolBar personalizado. Si controla este mensaje y crea su propia barra de herramientas, omita la llamada al controlador predeterminado.	No se utiliza.	Puntero a una cadena que contiene el nombre de la barra de herramientas.	Puntero a la barra de herramientas recién creada. NULL indica que se canceló la creación de la barra de herramientas.
AFX_WM_CUSTOMIZEHELP	Se envía a la ventana de marco principal desde la hoja de propiedades de personalización CMFCToolbarCustomize Dialog cuando el usuario presiona el botón Ayuda o la tecla F1.	Especifica la página activa de la hoja de propiedades de personalización.	Puntero a un objeto CMFCToolbarCustomize Dialog .	Cero.
AFX_WM_CUSTOMIZETOOLBAR	CMFCToolbarCustomize Dialog envía este mensaje para notificar al marco primario que el usuario está creando una nueva barra de herramientas.	TRUE cuando se inicia la personalización, FALSE cuando finaliza la personalización.	No se utiliza.	Cero.
AFX_WM_DELETETOOLBAR	Se envía a la ventana de marco principal cuando el usuario está a punto de eliminar una barra de herramientas en el modo de personalización. Procese este mensaje para realizar acciones adicionales cuando un usuario elimina una barra de herramientas en modo de personalización. También debe llamar al controlador predeterminado (OnToolbarDelete), 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 CMFCToolBar que se va a eliminar.	Distinto de cero si no se puede eliminar una barra de herramientas; de lo contrario, 0.
AFX_WM_GETDOCUMENTCOLORS	CMFCColorMenuButton envía este mensaje a la ventana de marco principal para recuperar los colores del documento.	No se utiliza.	[in, out] Puntero a un objeto CList<COLORREF, COLORREF>.	Cero.
AFX_WM_GETDRAGBOUNDS	Para uso interno únicamente.	No es aplicable.	No es aplicable.	No es aplicable.
AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM	Se envía 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	Se envía a un elemento primario de los controles CMFCShellListCtrl o CMFCShellTreeCtrl cuando un usuario termina de ejecutar un comando de shell.	El id. del comando que ejecutó el usuario.	No se utiliza.	Si la aplicación procesa este mensaje, debe devolver 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 mostrar el menú emergente. Puede procesar este mensaje y modificar los menús emergentes en cualquier momento.	No se utiliza.	Un puntero a CMFCBaseRibbonElement.	No se utiliza.
AFX_WM_ON_CANCELTABMOVE	Para uso interno únicamente.	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 Control de cinta de opciones activa.	No se utiliza.	Puntero a la categorí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 cerrarse.	No se utiliza.	Puntero al objeto CMFCDesktopAlertWnd.	No se utiliza.
AFX_WM_ON_DRAGCOMPLETE	Para uso interno únicamente.	No es aplicable.	No es aplicable.	No es aplicable.
AFX_WM_ON_GET_TAB_TOOLTIP	Se envía a la ventana de marco principal cuando una ventana de ficha está a punto de mostrar una información sobre herramientas para una ficha, si la información sobre herramientas personalizada está habilitada.	No se utiliza.	Un puntero a una estructura CMFCTabToolTipInfo.	No se utiliza.
AFX_WM_ON_HSCROLL	Se envía al control de barra de control redimensionable. Procese este mensaje para recibir notificaciones de objetos CMFCTabCtrl cuando se produzca un evento de desplazamiento en la barra de desplazamiento horizontal del widget con fichas.	La palabra de orden inferior especifica un valor de barra 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.	Diferente de cero.
AFX_WM_ON_MOVE_TAB	Se envía al elemento primario de una ventana con fichas cuando un usuario arrastra una ficha a una nueva posición.	Índice de base cero de la ficha en su posición original.	[out] Índice de base cero de la ficha en su nueva posición.	Cero.
AFX_WM_ON_MOVETABCOMPLETE	Para uso interno únicamente.	No es aplicable.	No es aplicable.	No es aplicable.
AFX_WM_ON_MOVETOTABGROUP	Se envía a la ventana de marco principal cuando un usuario mueve una ventana secundaria MDI de un grupo con fichas a otro.	Identificador de la ventana con fichas (CMFCTabCtrl) de la que se ha quitado la ventana secundaria MDI.	[out] Identificador de la ventana con fichas (CMFCTabCtrl) en la que se ha insertado la ventana secundaria MDI.	ignorado.
AFX_WM_ON_PRESS_CLOSE_BUTTON	Se envía a un elemento primario de CDockablePane cuando el usuario hace clic en el botón Cerrar en el título de la barra de control.	No se utiliza.	Puntero a un panel acoplable en el que el usuario ha hecho clic en el botón Cerrar.	TRUE si no se puede cerrar un panel; en caso contrario, FALSE.
AFX_WM_ON_RENAME_TAB	Se envía al elemento primario de la ventana con fichas después de que el usuario cambie el nombre de una ficha editable.	Índice de base cero de la ficha a la que se ha cambiado el nombre.	[out] Puntero a una cadena que contiene el nuevo nombre de ficha.	Distinto de cero si la aplicación procesa este mensaje; el marco suprimirá la llamada a CMFCBaseTabCtrl::SetTabLabel. Si se devuelve cero, el marco llama a CMFCBaseTabCtrl::SetTabLabel.
AFX_WM_ON_RIBBON_CUSTOMIZE	Se envía al marco primario cuando el usuario inicia la personalización. Procese este mensaje si desea mostrar su propio cuadro de diálogo de personalización.	No se utiliza.	Puntero al control de cinta de opciones que se va a personalizar.	Distinto de cero si la aplicación procesa este mensaje y muestra su propio cuadro de diálogo de personalización. Si la aplicación devuelve cero, el marco mostrará el cuadro de diálogo de personalización integrado.
AFX_WM_ON_TABGROUPMOUSEMOVE	Para uso interno únicamente.	No es aplicable.	No es aplicable.	No es aplicable.
AFX_WM_POSTSETPREVIEWFRAME	Se envía para notificar al marco principal que el usuario cambió el modo de vista previa de impresión.	TRUE indica que se ha establecido el modo de vista previa de impresión. FALSE indica que el modo de vista previa de impresión está desactivado.	No se utiliza.	No se utiliza.
AFX_WM_PROPERTY_CHANGED	Se envía al propietario del control de cuadrícula de propiedades (CMFCPropertyGridCtrl) cuando el usuario cambia el valor de la propiedad seleccionada.	El id. de control de la lista de propiedades.	Puntero a la propiedad (CMFCPropertyGridProperty) que se cambió.	No se utiliza.
AFX_WM_RESETCONTEXTMENU	Se envía a la ventana de marco principal cuando el usuario restablece el menú contextual durante la personalización.	[in] Id. de recurso del menú contextual.	Puntero al contexto actual, CMFCPopupMenu.	No se utiliza.
AFX_WM_RESETKEYBOARD	El marco envía este mensaje a 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 del menú (una ventana de marco) cuando el usuario restablece un menú marco de aplicación durante la personalización.	Id. del 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 desde el cuadro de diálogo de personalización de la barra de herramientas. El controlador predeterminado muestra un cuadro de mensaje que pregunta si el usuario quiere restablecer la barra de herramientas.	No se utiliza.	No se utiliza.	No se utiliza.
AFX_WM_RESETTOOLBAR	Un objeto CMFCToolBar envía este mensaje cuando se restaura una barra de herramientas a su estado original, es decir, se carga desde los recursos. Procese este mensaje para volver a insertar botones de barra de herramientas cuyas clases se derivan de CMFCToolbarButton. Para obtener más información, vea CMFCToolbarComboBoxButton.	Id. de recurso de una barra de herramientas cuyo estado se restauró.	No se utiliza.	Cero.
AFX_WM_SHOWREGULARMENU	El objeto CMFCToolbarMenuButton envía este mensaje a su propietario cuando el usuario hace clic en un botón de menú normal. Procese este mensaje cada vez que use CMFCToolbarMenuButton para mostrar un menú emergente cuando el usuario haga clic en un botón.	Id. de comando de un botón que envía el mensaje.	Coordenadas de pantalla del cursor. La palabra de orden inferior especifica la coordenada X. La palabra de orden superior especifica la coordenada Y.	No se utiliza.
AFX_WM_TOOLBARMENU	Se envía a la ventana de marco principal cuando el usuario suelta el botón derecho de un mouse mientras el puntero del mouse está en el área de cliente o de no cliente de un panel.	No se utiliza.	Coordenadas de pantalla del puntero del mouse. La palabra de orden inferior especifica la coordenada X. La palabra de orden superior especifica la coordenada Y.	Cero si la aplicación procesa este mensaje; de lo contrario, distinto de cero.
AFX_WM_UPDATETOOLTIPS	Se envía a todos los propietarios de información sobre herramientas para indicar que se deben volver a crear sus controles de información sobre herramientas.	Tipo de control que debe procesar este mensaje. Consulte 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 marco 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 la tecla F1.	No se utiliza.	Puntero a la instancia de CMFCWindowsManagerDialog.	No se utiliza.

En la tabla siguiente se muestran los valores de la palabra inferior del parámetro lParam del método AFX_WM_HSCROLL:

Valor	Significado
SB_ENDSCROLL	El usuario finaliza el desplazamiento.
SB_LEFT	El usuario se desplaza a la esquina superior izquierda.
SB_RIGHT	El usuario se desplaza a la esquina inferior derecha.
SB_LINELEFT	El usuario se desplaza a la izquierda una unidad.
SB_LINERIGHT	El usuario se desplaza a la derecha una unidad.
SB_PAGELEFT	El usuario se desplaza a la izquierda el ancho de la ventana.
SB_PAGERIGHT	El usuario se desplaza a la derecha el ancho de la ventana.
SB_THUMBPOSITION	El usuario ha arrastrado el cuadro de desplazamiento (pulgar) y ha liberado el botón del mouse. La palabra de orden superior 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 AFX_WM_ON_HSCROLL se envía repetidamente con este valor hasta que el usuario suelta el botón del mouse. La palabra de orden superior indica la posición a la que se ha arrastrado el cuadro de desplazamiento.

Nota:

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

En la tabla siguiente se enumeran los valores de marca para el parámetro lParam del mensaje AFX_WM_UPDATETOOLTIPS:

Marca	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

Consulte también

Macros y globales