Clase CPaneDialog

La clase CPaneDialog admite un cuadro de diálogo no modal y acoplable.

Sintaxis

class CPaneDialog : public CDockablePane

Miembros

Constructores públicos

Nombre	Descripción
CPaneDialog::CPaneDialog	Constructor predeterminado.
CPaneDialog::~CPaneDialog	Destructor.

Métodos públicos

Nombre	Descripción
CPaneDialog::Create	Crea un cuadro de diálogo acoplable y lo adjunta a un objeto CPaneDialog.
CPaneDialog::CreateObject	Usado por el marco de trabajo para crear una instancia dinámica de este tipo de clase.
CPaneDialog::GetThisClass	Lo usa el marco para obtener un puntero al objeto CRuntimeClass asociado a este tipo de clase.
CPaneDialog::HandleInitDialog	Controla el mensaje WM_INITDIALOG. (Vuelve a definir CBasePane::HandleInitDialog.)
CPaneDialog::OnEraseBkgnd	Controla el mensaje WM_ERASEBKGND. (Vuelve a definir CWnd::OnEraseBkgnd.)
CPaneDialog::OnLButtonDblClk	Controla el mensaje WM_LBUTTONDBLCLK. (Vuelve a definir CWnd::OnLButtonDblClk.)
CPaneDialog::OnLButtonDown	Controla el mensaje WM_LBUTTONDOWN. (Vuelve a definir CWnd::OnLButtonDown.)
CPaneDialog::OnUpdateCmdUI	Lo llama el marco para actualizar la ventana del cuadro de diálogo. (Invalida CDockablePane::OnUpdateCmdUI).
CPaneDialog::OnWindowPosChanging	Controla el mensaje WM_WINDOWPOSCHANGING . (Vuelve a definir CWnd::OnWindowPosChanging.)
CPaneDialog::SetOccDialogInfo	Especifica la plantilla de un cuadro de diálogo que es un contenedor de control de OLE.

Comentarios

Construya un objeto CPaneDialog en dos pasos. En primer lugar, construya el objeto en su código. En segundo lugar, llame a CPaneDialog::Create. Debe especificar un nombre de plantilla de recurso válido o un id. de plantilla y pasar un puntero a la ventana primaria. De lo contrario, se produce un error en el proceso de creación. El cuadro de diálogo debe especificar el estilo WS_CHILD y WS_VISIBLE. Se recomienda que también especifique los estilos WS_CLIPCHILDREN y WS_CLIPSIBLINGS. Para más información, consulte Estilos de ventana.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

CPaneDialog

Requisitos

Encabezado: afxpanedialog.h

CPaneDialog::Create

Crea un cuadro de diálogo acoplable y lo adjunta a un objeto CPaneDialog.

BOOL Create(
    LPCTSTR lpszWindowName,
    CWnd* pParentWnd,
    BOOL bHasGripper,
    LPCTSTR lpszTemplateName,
    UINT nStyle,
    UINT nID,
    DWORD dwTabbedStyle= AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle=AFX_DEFAULT_DOCKING_PANE_STYLE);

BOOL Create(
    LPCTSTR lpszWindowName,
    CWnd* pParentWnd,
    BOOL bHasGripper,
    UINT nIDTemplate,
    UINT nStyle,
    UINT nID);

BOOL Create(
    CWnd* pParentWnd,
    LPCTSTR lpszTemplateName,
    UINT nStyle,
    UINT nID);

BOOL Create(
    CWnd* pParentWnd,
    UINT nIDTemplate,
    UINT nStyle,
    UINT nID);

Parámetros

lpszWindowName
[in] El nombre del cuadro de diálogo de acoplamiento.

pParentWnd
[in] Punteros a la ventana primaria.

bHasGripper
[in] TRUE para crear el cuadro de diálogo de acoplamiento con un título (agarrador); de lo contrario, FALSE.

lpszTemplateName
[in] El nombre de la plantilla de diálogo de recursos.

nStyle
[in] El estilo de Windows.

Nid
[in] La id. del control.

nIDTemplate
[in] El id. de recurso de la plantilla de diálogo.

dwTabbedStyle
[in] El estilo de la ventana con pestañas que resulta cuando el usuario arrastra otro panel de control al título de este panel de control. El valor predeterminado es AFX_CBRS_REGULAR_TABS. Para obtener más información, consulte la sección Comentarios del método CBasePane::CreateEx.

dwControlBarStyle
[in] Atributos de estilo adicionales. El valor predeterminado es AFX_DEFAULT_DOCKING_PANE_STYLE. Para obtener más información, consulte la sección Comentarios del método CBasePane::CreateEx.

Valor devuelto

TRUE si este método se realiza correctamente; de lo contrario, FALSE.

Comentarios

Ejemplo

El siguiente ejemplo muestra cómo se usa el método Create de la clase CPaneDialog. Este ejemplo forma parte de la muestra Establecer tamaño del panel.

CPaneDialog m_wndDlgBar;

// The this pointer points to a CMainFrame class which extends the CFrameWnd class.
if (!m_wndDlgBar.Create(_T("DialogBar"), this, TRUE,
                        MAKEINTRESOURCE(IDD_DLG_BAR),
                        WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_LEFT | CBRS_FLOAT_MULTI,
                        ID_VIEW_DLGBAR))
{
   TRACE0("Failed to create Dialog Bar\n");
   return FALSE; // fail to create
}

CPaneDialog::HandleInitDialog

Controla el mensaje WM_INITDIALOG.

afx_msg LRESULT HandleInitDialog(
    WPARAM wParam,
    LPARAM lParam);

Parámetros

wParam
[in] Manipula el control que recibirá el enfoque de teclado predeterminado.

lParam
[in] Especifica datos de inicialización adicionales.

Valor devuelto

TRUE si este método se ejecuta correctamente; de lo contrario, FALSE. Además, TRUE establece el foco del teclado en el control especificado por el parámetro wParam; FALSE impide establecer el enfoque de teclado predeterminado.

Comentarios

El marco usa este método para inicializar controles y la apariencia de un cuadro de diálogo. El marco llama a este método antes de mostrar el cuadro de diálogo.

CPaneDialog::SetOccDialogInfo

Especifica la plantilla de un cuadro de diálogo que es un contenedor de control de OLE.

virtual BOOL SetOccDialogInfo(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Parámetros

pOccDialogInfo
[in] Un puntero a una plantilla de cuadro de diálogo que se usa para crear el objeto de cuadro de diálogo. El valor de este parámetro se pasa posteriormente al método COccManager::CreateDlgControls.

Valor devuelto

Siempre TRUE.

Comentarios

Este método admite la clase COccManager, que administra los sitios de control de OLE y los controles de ActiveX. La estructura _AFX_OCC_DIALOG_INFO se define en el archivo de encabezado afxocc.h.

Consulte también

Gráfico de jerarquías
Clases
CDockablePane (clase)
Estilos de ventana