CSplitterWnd Class

Artículo
06/10/2015

Proporciona la funcionalidad de una ventana divisora, que es una ventana que contiene varios paneles.

class CSplitterWnd : public CWnd

Miembros

Constructores públicos

Name	Descripción
CSplitterWnd::CSplitterWnd	Llame a para construir un objeto de CSplitterWnd .

Métodos públicos

Name	Descripción
CSplitterWnd::ActivateNext	Ejecuta el comando siguiente en el panel o el panel Anteriores de.
CSplitterWnd::CanActivateNext	Comprueba si el comando siguiente en el panel o el panel Anteriores de es actualmente posible.
CSplitterWnd::Create	Llamada para crear una ventana y una publicación divisoras dinámicas en el objeto de CSplitterWnd .
CSplitterWnd::CreateScrollBarCtrl	crea un control de barra de desplazamiento compartido.
CSplitterWnd::CreateStatic	Llamada para crear una ventana y una publicación estáticas del divisor en el objeto de CSplitterWnd .
CSplitterWnd::CreateView	Llamada para crear un panel en una ventana divisora.
CSplitterWnd::DeleteColumn	Elimina una columna de la ventana divisora.
CSplitterWnd::DeleteRow	Elimina una fila de la ventana divisora.
CSplitterWnd::DeleteView	Elimina una vista en la ventana divisora.
CSplitterWnd::DoKeyboardSplit	Ejecuta el comando partido de teclado, normalmente “división ventana”.
CSplitterWnd::DoScroll	Performs sincronizó el desplazamiento de ventanas divididas.
CSplitterWnd::DoScrollBy	Desplaza las ventanas divididas por un número determinado de píxeles.
CSplitterWnd::GetActivePane	Determina el panel activo del foco o de la vista activa en el cuadro.
CSplitterWnd::GetColumnCount	Devuelve el recuento actual de la columna del panel.
CSplitterWnd::GetColumnInfo	Devuelve la información de la columna especificada.
CSplitterWnd::GetPane	devuelve el panel en la fila y la columna especificadas.
CSplitterWnd::GetRowCount	Devuelve el número de filas actual del panel.
CSplitterWnd::GetRowInfo	Devuelve la información de la fila especificada.
CSplitterWnd::GetScrollStyle	devuelve el estilo compartido de la barra de desplazamiento.
CSplitterWnd::IdFromRowCol	Devuelve el identificador de ventana secundaria del panel en la fila y la columna especificadas.
CSplitterWnd::IsChildPane	Llamada a determinar si la ventana está actualmente un panel secundario de esta ventana divisora.
CSplitterWnd::IsTracking	Determina si la barra de división se mueve actualmente.
CSplitterWnd::RecalcLayout	Llamada para redesplegar la ventana divisora después de ajustar la fila o el tamaño de columna.
CSplitterWnd::SetActivePane	Establece un panel sea el activo en el cuadro.
CSplitterWnd::SetColumnInfo	llamada para establecer la información especificada de la columna.
CSplitterWnd::SetRowInfo	llamada para establecer la información especificada de la fila.
CSplitterWnd::SetScrollStyle	Especifica el nuevo estilo de la barra de desplazamiento para el uso compartido de la barra de desplazamiento de la ventana divisora.
CSplitterWnd::SplitColumn	Indica que una ventana de marco divide verticalmente.
CSplitterWnd::SplitRow	Indica que una ventana de marco dividida horizontalmente.

Métodos protegidos

Name	Descripción
CSplitterWnd::OnDraw	Llamado por el marco para dibujar la ventana divisora.
CSplitterWnd::OnDrawSplitter	Representa una imagen de una ventana dividida.
CSplitterWnd::OnInvertTracker	Genera la imagen de una ventana dividida para ser del mismo taman-o y la forma que la ventana de marco.

Comentarios

Un panel normalmente es un objeto de aplicación concreto derivado de CView, pero puede ser cualquier objeto de CWnd que tiene el identificador adecuada de la ventana secundaria

Un objeto de CSplitterWnd se inserta normalmente en un objeto primario de CFrameWnd o de CMDIChildWnd . Cree un objeto de CSplitterWnd mediante los pasos siguientes:

Inserte una variable miembro de CSplitterWnd en el cuadro primario.
Reemplace la función principal del miembro de CFrameWnd:: OnCreateClient de marco.
Dentro de OnCreateClientinvalidado, llame a funciones miembro de Crear o de CreateStatic de CSplitterWnd.

Llame a la función miembro de Crear para crear una ventana dinámica splitter. Una ventana dinámica splitter se utiliza normalmente para crear y desplácese varios paneles individuales, o vistas, del mismo documento. El marco de trabajo crea automáticamente un panel inicial del divisor; el marco de trabajo crea, el tamaño, y elimina de los paneles adicionales mientras el usuario funciona los controles de la ventana divisora.

Cuando se llama a Crear, especifica un alto de fila y el ancho de columna mínimos que determine cuándo los paneles son demasiado pequeños mostrar totalmente. Después de llamar a Crear, puede ajustar estos mínimos llamando a SetColumnInfo y el miembro de SetRowInfo funciona.

También use SetColumnInfo y el miembro de SetRowInfo funciona para establecer un ancho “ideal” para una columna y el alto “ideal” para una fila. Cuando el marco muestra una ventana divisora, primero muestra el cuadro primario, la ventana divisora. El marco después muestra los paneles en columnas y filas según sus dimensiones ideales, trabajando superior izquierda a la esquina inferior derecha del área de cliente de la ventana divisora.

Todos los paneles en una ventana dinámica splitter deben ser de la misma clase. Las aplicaciones habituales que admiten las ventanas divisoras dinámicas incluyen Microsoft Word y Microsoft Excel.

Utilice la función miembro de CreateStatic para crear una ventana divisora estática. El usuario sólo puede cambiar el tamaño de los paneles en una ventana divisora estática, no el número u orden.

Debe crear específicamente los paneles de todo el divisor estático cuando se crea el divisor estático. Asegúrese de que crear todos los paneles antes de que la función principal del miembro de OnCreateClient de cuadro cambie, o marco no mostrará la ventana correctamente.

La función miembro de CreateStatic automáticamente inicializa un divisor estático con un alto de fila y el ancho de columna mínimos de 0. Después de llamar a Crear, ajuste estos mínimos llamando a SetColumnInfo y el miembro de SetRowInfo funciona. También use SetColumnInfo y SetRowInfo después de llamar a CreateStatic para indicar dimensiones ideales deseadas del panel.

Paneles individuales de un divisor estático pertenecen a clases diferentes. Para obtener ejemplos de las ventanas estáticas splitter, vea editor de gráficos y el administrador de archivos de Windows.

Una ventana divisora admite las barras de desplazamiento especiales (aparte de las barras de desplazamiento que los paneles pueden tener). Estas barras de desplazamiento son elementos secundarios del objeto de CSplitterWnd y comparten con los paneles.

Cree estas barras de desplazamiento especiales al crear la ventana divisora. Por ejemplo, CSplitterWnd que tiene una fila, dos columnas, y el estilo de WS_VSCROLL mostrarán una barra de desplazamiento vertical que sea compartida por los dos paneles. cuando el usuario mueve la barra de desplazamiento, los mensajes de WM_VSCROLL se envían a ambos paneles. cuando los paneles establecen la posición de la barra de desplazamiento, se establece la barra de desplazamiento compartida.

Para obtener más información sobre las ventanas divisoras, vea: