CMiniFrameWnd (clase)

Representa una ventana de marco de altura media, como las que se suelen ver alrededor de las barras de herramientas flotantes.

Sintaxis

class CMiniFrameWnd : public CFrameWnd

Miembros

Constructores públicos

Nombre	Descripción
CMiniFrameWnd::CMiniFrameWnd	Construye un objeto CMiniFrameWnd.

Métodos públicos

Nombre	Descripción
CMiniFrameWnd::Create	Se usa para crear un objeto CMiniFrameWnd después de la construcción.
CMiniFrameWnd::CreateEx	Se usa para crear un objeto CMiniFrameWnd (con opciones adicionales) después de la construcción.

Comentarios

Las ventanas minimarco se comportan como ventanas de marco normales, con la excepción de que no tienen menús ni botones para maximizar y minimizar y de que solo se necesita un único clic en el menú del sistema para descartarlas.

Para usar un objeto CMiniFrameWnd, primero hay que definir el objeto. A continuación, llame a la función miembro Crear para poder ver la ventana minimarco.

Si desea más información sobre cómo usar objetos CMiniFrameWnd, consulte el artículo Barras de herramientas de acoplamiento y flotantes.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

Requisitos

Encabezado: afxwin.h

CMiniFrameWnd::CMiniFrameWnd

Construye un objeto CMiniFrameWnd, pero no crea la ventana.

CMiniFrameWnd();

Comentarios

Para poder crear la ventana, llame a CMiniFrameWnd::Create.

CMiniFrameWnd::Create

Sirve para crear una ventana minimarco de Windows y la adjunta al objeto CMiniFrameWnd.

virtual BOOL Create(
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Parámetros

lpClassName
Se usa para apuntar a una cadena de caracteres que finaliza en null y que, a su vez, se usa para asignar el nombre de la clase Windows. El nombre de clase puede ser cualquier nombre registrado con la función global AfxRegisterWndClass. Si el valor es NULL, el marco registrará la clase de ventana. MFC proporciona a la clase predeterminada los estilos y atributos que se presentan a continuación:

• Establece el bit de estilo CS_DBLCLKS, que envía mensajes de doble clic al procedimiento de ventana cuando se hace doble clic con el mouse.

• Establece los bits de estilo CS_HREDRAW y CS_VREDRAW, que dirigen el contenido del área cliente que se va a volver a dibujar al cambiar el tamaño de ventana.

• Establece el cursor de clase en el IDC_ARROW estándar de Windows.

• Establece el pincel de fondo de clase en NULL, por lo que la ventana no borrará el fondo.

• Establece el icono de clase en el icono de logotipo de Windows estándar, la bandera ondeante.

• Establece la ventana en el tamaño y la posición predeterminados, como indica Windows.

lpWindowName
Se usa para apuntar a una cadena de caracteres que finaliza en null y que, a su vez, se usa para representar el nombre de la ventana.

dwStyle
[in] El valor de este parámetro se usa para especificar los atributos de estilo de la ventana. Aquí se pueden incluir estilos de ventana estándar y uno o varios de los siguientes estilos especiales:

• MFS_MOVEFRAME: con el que se puede mover la ventana minimarco al hacer clic en uno de sus bordes, no solo en el subtítulo.

• MFS_4THICKFRAME: con el que se deshabilita el cambio de tamaño de la ventana minimarco.

• MFS_SYNCACTIVE : con el que se sincroniza la activación de la ventana minimarco con la activación de su ventana primaria.

• MFS_THICKFRAME: con el que la ventana minimarco puede hacerse tan pequeña como lo permita el contenido del área cliente.

• MFS_BLOCKSYSMENU: con el que se deshabilita el acceso al menú del sistema y al menú de control y los convierte en parte del subtítulo (barra de título).

En CWnd::Create se describen los posibles valores de estilo de ventana. La combinación habitual empleada para ventanas minimarco es WS_POPUP|WS_CAPTION|WS_SYSMENU.

rect
Estructura RECT que se emplea para especificar las dimensiones deseadas de la ventana.

pParentWnd
Se usa para apuntar a la ventana primaria. Use NULL al trabajar con las ventanas de nivel superior.

Nid
Si la ventana minimarco se crea como una ventana secundaria, este es el id. del control secundario; de lo contrario, 0.

Valor devuelto

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.

Comentarios

Create inicializa el nombre de clase de ventana, así como el nombre de ventana, y registra los valores predeterminados del estilo y elemento primario.

CMiniFrameWnd::CreateEx

Crea un objeto CMiniFrameWnd.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Parámetros

dwExStyle
Especifica el estilo extendido del CMiniFrameWnd que se va a crear. Aplique a la ventana uno de los estilos de ventana extendidos.

lpClassName
El valor de este parámetro se usa para apuntar a una cadena de caracteres que finaliza en null y que, a su vez, se usa para asignar el nombre de la clase Windows (una estructura WNDCLASS). La clase puede recibir cualquier nombre registrado con la función global AfxRegisterWndClass o cualquiera de los nombres predefinidos de clase de control. No debe ser NULL.

lpWindowName
Se usa para apuntar a una cadena de caracteres que finaliza en null y que, a su vez, se usa para representar el nombre de la ventana.

dwStyle
[in] El valor de este parámetro se usa para especificar los atributos de estilo de la ventana. En Estilos de ventana y CWnd::Create se describen los valores posibles.

rect
Tamaño y posición de la ventana, en las coordenadas de cliente de pParentWnd.

pParentWnd
Se usa para apuntar al objeto de la ventana primaria.

Nid
El id. de la ventana secundaria.

Valor devuelto

Devuelve TRUE si la operación se realiza correctamente; de lo contrario, devuelve FALSE.

Comentarios

Los parámetros CreateEx especifican la posición inicial de WNDCLASS, el estilo de ventana y, de forma opcional, la posición inicial y el tamaño de la ventana. CreateEx también especifica el elemento primario de la ventana, si existiera, y el id.

Al ejecutarse CreateEx, Windows envía los mensajes WM_GETMINMAXINFO, WM_NCCREATE, WM_NCCALCSIZE y WM_CREATE a la ventana.

Para ampliar el control de mensajes predeterminado, derive una clase de CMiniFrameWnd, agregue un mapa de mensajes a la clase nueva y proporcione funciones de miembro para los mensajes anteriores. Invalide OnCreate, por ejemplo, para realizar la inicialización necesaria para una nueva clase.

Invalide más controladores de mensajes de Onmensaje para agregar más funcionalidades a la clase derivada.

Si se especifica el estilo WS_VISIBLE, Windows envía a la ventana todos los mensajes necesarios para activar y mostrar la ventana. Si el estilo de ventana especifica una barra de título, el título de la ventana al que apunta el parámetro lpszWindowName se muestra en la barra de título.

El valor del parámetro dwStyle puede establecerse con cualquier combinación de estilos de ventana.

Las ventanas del cuadro de herramientas paleta de estilo antiguo ya no están admitidas. El estilo antiguo sin un botón Cerrar "X" se admitía al ejecutar una aplicación MFC en versiones anteriores de Windows, pero ya no se hace en Visual C++.NET. Ahora únicamente los estilos nuevos WS_EX_TOOLWINDOW están admitidos. En Estilos de ventana extendidos puede leer una descripción.

Consulte también

CFrameWnd (clase)
Gráfico de jerarquías
CFrameWnd (clase)