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 utilizado. | 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 utilizado. | 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 utilizado. | Diferente de cero. |
| AFX_WM_CHECKEMPTYMINIFRAME | Solo para uso interno. | 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 utilizado. | 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 utilizado. | 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 utilizado. | 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 utilizado. | [in, out] Puntero a un objeto 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 | 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 utilizado. |
| 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 utilizado. | 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 utilizado. | Un puntero a CMFCBaseRibbonElement. |
No utilizado. |
| 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 Control de cinta de opciones activa. | No utilizado. | Puntero a la categoría CMFCRibbonBar cuya categoría ha cambiado. |
No utilizado. |
| 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 utilizado. | Puntero al objeto CMFCDesktopAlertWnd. |
No utilizado. |
| AFX_WM_ON_DRAGCOMPLETE | Solo para uso interno. | 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 utilizado. | Un puntero a una estructura CMFCTabToolTipInfo. |
No utilizado. |
| 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 utilizado. | 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 | Solo para uso interno. | 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 utilizado. | 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 utilizado. | 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 | Solo para uso interno. | 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 utilizado. |
| 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 utilizado. |
| 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 utilizado. | 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 utilizado. |
| 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 utilizado. | 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 utilizado. | Puntero a la instancia de CMFCWindowsManagerDialog. |
No utilizado. |
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 |