CDockablePane Class

Artículo
06/10/2015

Implementa un panel que se puede acoplar en un sitio de vinculación o incluir en un panel con fichas.

class CDockablePane : public CPane

Members

Constructores públicos

Name	Descripción
CDockablePane::CDockablePane	Las construcciones e inicializan un objeto de CDockablePane .

Métodos públicos

Name	Descripción
CDockablePane::AttachToTabWnd	Asocia un panel a otro panel. Esto crea un panel con fichas.
CDockablePane::CalcFixedLayout	Devuelve el tamaño del rectángulo del panel.
CDockablePane::CanAcceptMiniFrame	Determina si es el mínimo cuadro especificado se puede acoplar el panel.
CDockablePane::CanAcceptPane	Determina si otro panel se puede acoplar el panel actual.
CDockablePane::CanAutoHide	Determina si el panel admite oculta automáticamente el modo. (Reemplaza CBasePane::CanAutoHide.)
CDockablePane::CanBeAttached	determina si el panel actual se puede acoplar a otro panel.
CDockablePane::ConvertToTabbedDocument	Convierte uno o varios paneles acoplable a MDI con documentos.
CDockablePane::CopyState	Copia el estado de un panel acoplable.
CDockablePane::Create	Hace que el control de Windows y lo asocia al objeto de CDockablePane .
CDockablePane::CreateDefaultPaneDivider	Crea un divisor predeterminado para el panel mientras se está acoplado a una ventana de marco.
CDockablePane::CreateEx	Hace que el control de Windows y lo asocia al objeto de CDockablePane .
CDockablePane::CreateTabbedPane	Crea un panel con fichas del panel actual.
CDockablePane::DockPaneContainer	Acoplar un contenedor al panel.
CDockablePane::DockPaneStandard	Acoplar un panel mediante el acoplamiento de esquema (estándar).
CDockablePane::DockToFrameWindow	Utilizado de forma interna. Para acoplar un panel, utilice CPane::DockPane o CDockablePane::DockToWindow.
CDockablePane::DockToRecentPos	Acoplar un panel a su posición reciente almacenada de acoplamiento.
CDockablePane::DockToWindow	Lo acopla un panel de acoplamiento a otro panel acoplable.
CDockablePane::EnableAutohideAll	Habilita o las neutralizaciones ocultan automáticamente el modo para este panel junto con otros paneles del contenedor.
CDockablePane::EnableGripper	Muestra u oculta la leyenda (de).
CDockablePane::GetAHRestoredRect	Especifica la posición del panel a es visible en ocultan automáticamente el modo.
CDockablePane::GetAHSlideMode	Recupera el modo automático de la diapositiva hide para el panel.
CDockablePane::GetAutoHideButton	Utilizado de forma interna.
CDockablePane::GetAutoHideToolBar	Utilizado de forma interna.
CDockablePane::GetCaptionHeight	Devuelve el alto de la leyenda actual.
CDockablePane::GetDefaultPaneDivider	Devuelve el divisor de paneles predeterminado para el contenedor del panel.
CDockablePane::GetDockingStatus	Determina la capacidad de un panel de acoplarse basándose en la ubicación especificada del puntero.
CDockablePane::GetDragSensitivity	Devuelve el carácter de arrastre de un panel acoplable.
CDockablePane::GetLastPercentInPaneContainer	Recupera el porcentaje de espacio que un panel ocupa dentro de su contenedor.
CDockablePane::GetTabArea	Recupera el área de la pestaña del panel.
CDockablePane::GetTabbedPaneRTC	Devuelve información de clase en tiempo de ejecución sobre una ventana con fichas se crea a otro panel acoplar el panel actual.
CDockablePane::HasAutoHideMode	Especifica si un panel acoplable puede intercambiarse oculta automáticamente el modo.
CDockablePane::HitTest	Especifica la ubicación específica en un panel en el que el usuario hace clic en un mouse.
CDockablePane::IsAccessibilityCompatible	Utilizado de forma interna.
CDockablePane::IsAutohideAllEnabled	Indica si el panel acoplable y el resto de los paneles del contenedor se pueden colocar en ocultan automáticamente el modo.
CDockablePane::IsAutoHideMode	Determina si es un panel en oculta automáticamente el modo.
CDockablePane::IsChangeState	Utilizado de forma interna.
CDockablePane::IsDocked	determina si el panel actual está acoplado.
CDockablePane::IsHideInAutoHideMode	Determina el comportamiento de un panel que sea en ocultar automáticamente el modo si se muestre (o oculto) llamando a ShowPane.
CDockablePane::IsInFloatingMultiPaneFrameWnd	Especifica si el panel está en una ventana de marco de multi- panel.
CDockablePane::IsResizable	Especifica si el panel se puede cambiar.
CDockablePane::IsTabLocationBottom	Especifica si las pestañas se encuentran en la parte superior o inferior del panel.
CDockablePane::IsTracked	Especifica si un panel sea arrastrado por el usuario.
CDockablePane::IsVisible	Determina si el panel actual está visible.
CDockablePane::LoadState	Utilizado de forma interna.
CDockablePane::OnAfterChangeParent	Llamado por el marco al elemento primario de un panel ha cambiado. (Reemplaza CPane::OnAfterChangeParent.)
CDockablePane::OnAfterDockFromMiniFrame	Llamado por el marco cuando se acopla de punto flotante de una barra de acoplamiento en una ventana de marco.
CDockablePane::OnBeforeChangeParent	Llamado por el marco al elemento primario del panel va a cambiar. (Reemplaza CPane::OnBeforeChangeParent.)
CDockablePane::OnBeforeFloat	Llamado por el marco cuando un panel está a punto de flotar. (Reemplaza CPane::OnBeforeFloat.)
CDockablePane::RemoveFromDefaultPaneDividier	El marco de trabajo llama a este método cuando se desacoplando un panel.
CDockablePane::ReplacePane	Reemplaza el panel con un panel especificado.
CDockablePane::RestoreDefaultPaneDivider	El marco de trabajo llama a este método mientras un panel se deserializa para restaurar el divisor de paneles predeterminado.
CDockablePane::SaveState	Utilizado de forma interna.
CDockablePane::Serialize	Serializa el panel. (Reemplaza CBasePane::Serialize.)
CDockablePane::SetAutoHideMode	Alterna el panel acoplable entre visible y oculta automáticamente el modo.
CDockablePane::SetAutoHideParents	Establece el botón de ocultar automáticamente y oculta automáticamente la barra de herramientas del panel.
CDockablePane::SetDefaultPaneDivider	Utilizado de forma interna.
CDockablePane::SetLastPercentInPaneContainer	Establece el porcentaje de espacio que un panel ocupa dentro de su contenedor.
CDockablePane::SetResizeMode	Utilizado de forma interna.
CDockablePane::SetRestoredDefaultPaneDivider	Establece el divisor de paneles predeterminado restaurado.
CDockablePane::SetTabbedPaneRTC	Establece la información de la clase en tiempo de ejecución para una ventana con fichas se crea a dos paneles se acoplan.
CDockablePane::ShowPane	Muestra u oculta el panel.
CDockablePane::Slide	Muestra u oculta un panel con una animación el deslizar que se muestra cuando el panel en oculta automáticamente el modo.
CDockablePane::ToggleAutoHide	Alterna ocultan automáticamente el modo. (Reemplaza CPane::ToggleAutoHide .)
CDockablePane::UndockPane	Desacopla un panel de la ventana de marco principal o de un contenedor de ventana de marco.
CDockablePane::UnSetAutoHideMode	Utilizado de forma interna. Para establecer el modo de ocultar automáticamente, utilice CDockablePane::SetAutoHideMode

Métodos protegidos

Name	Descripción
CDockablePane::CheckAutoHideCondition	Determina si el panel acoplable está oculto (en ocultar automáticamente el modo).
CDockablePane::CheckStopSlideCondition	Determina cuando un panel de acoplamiento de ocultar automáticamente parará deslizar.
CDockablePane::DrawCaption	Dibuja la leyenda del panel acoplable (de).
CDockablePane::OnPressButtons	Se llama cuando el usuario presiona un botón de título distinto de los botones de AFX_HTCLOSE y de AFX_HTMAXBUTTON .
CDockablePane::OnSlide	Llamado por el marco para mostrar el efecto de la diapositiva de ocultar automáticamente cuando se muestra o se oculta el panel.

miembros de datos

Name	Descripción
CDockablePane::m_bDisableAnimation	Especifica si ocultar automáticamente la animación de panel acoplable está deshabilitado.
CDockablePane::m_bHideInAutoHideMode	Determina el comportamiento del panel cuando el panel en oculta automáticamente el modo.
CDockablePane::m_nSlideSteps	Especifica la velocidad de la animación del panel cuando se está mostrando o se está mostrando cuando en ocultar automáticamente el modo.

Comentarios

CDockablePane implementa la siguiente funcionalidad:

Acoplar un panel a una ventana de marco principal.
Pasa un panel a ocultar automáticamente el modo.
Adjuntar un panel a una ventana con fichas.
Flotante de un panel en una ventana de marco.
Acoplar un panel a otro panel que flota en una ventana de marco.
Cambiar el tamaño de un panel.
Estado y de carga para un panel acoplable.

Nota

La información de estado se guarda en el Registro de Windows.
Crear un panel con o sin una leyenda. La leyenda puede tener una etiqueta de texto y puede rellenarse con un color de degradado.
Arrastrar un panel mientras muestra el contenido del panel
Arrastrar un panel mientras muestra un rectángulo de arrastre.

Nota
La información de estado se guarda en el Registro de Windows.

Para utilizar un panel acoplable en la aplicación, derive la clase del panel de la clase de CDockablePane . Inserte el objeto derivado en el objeto de la ventana de marco principal o en un objeto de la ventana que controla la instancia del panel. Llamar a continuación al método de CDockablePane::Create o el método de CDockablePane::CreateEx cuando se procesa el mensaje de WM_CREATE en la ventana de marco principal. Finalmente, configurar el objeto de panel llamando a CBasePane::EnableDocking, CBasePane::DockPane, o CDockablePane::AttachToTabWnd.

Sugerencias de personalización

Las sugerencias siguientes se aplican a los objetos de CDockablePane :

Si llama a CDockablePane::AttachToTabWnd para dos no-tabulados, los paneles acoplables, un puntero a una ventana con fichas se devolverán en el parámetro de ppTabbedControlBar . Puede agregar las pestañas en la ventana con fichas mediante este parámetro.
La clase de panel con fichas creado por CDockablePane::AttachToTabWnd viene determinada por el objeto de CDockablePane en el parámetro de pTabControlBarAttachTo . Puede llamar a CDockablePane::SetTabbedPaneRTC para establecer la clase de panel con fichas que CDockablePane creará. dwTabbedStyle de CDockablePane::Create determina el tipo predeterminado al crear CDockablePane. si dwTabbedStyle es AFX_CBRS_OUTLOOK_TABS el tipo predeterminado es CMFCOutlookBar (Clase); si dwTabbedStyle es AFX_CBRS_REGULAR_TABS el tipo predeterminado es CTabbedPane (Clase).
Si desea acoplar un panel acoplable a otro, llame al método de CDockablePane::DockToWindow . El panel original debe acoplar en alguna parte antes de llamar a este método.
Los controles de CDockablePane::m_bHideInAutoHideMode de variable miembro cómo los paneles acoplable se comportan en modo de ocultar automáticamente cuando se llama a CDockablePane::ShowPane. Si está establecido en esta variable miembro a TRUE, los paneles acoplable y sus botones automático de ocultar se ocultarán. Si no, deslizarán en y out.
Puede deshabilitar oculta automáticamente la animación estableciendo a la variable miembro de CDockablePane::m_bDisableAnimation a TRUE.

Ejemplo

El ejemplo siguiente muestra cómo configurar un objeto de CDockablePane mediante varios métodos en la clase de CDockablePane . El ejemplo muestra cómo habilitar el ocultar automáticamente toda la característica del panel acoplable, habilita la leyenda o el agarrador, habilita el modo de ocultar automáticamente, muestra el panel, y anima un panel que sea en ocultar automáticamente el modo. Este fragmento de código es parte de Ejemplo de demostración de Visual Studio.

  // GetOwner is an inherited method.
    CDockablePane* pParentBar = DYNAMIC_DOWNCAST(CDockablePane, GetOwner());


...


        pParentBar->EnableAutohideAll();
        pParentBar->EnableGripper(true);
        pParentBar->SetAutoHideMode(true, CBRS_ALIGN_LEFT);
        pParentBar->ShowPane(true,false,true);
        pParentBar->Slide(true);