Classe CPaneDialog

A classe CPaneDialog dá suporte a uma caixa de diálogo sem janela restrita e encaixada.

Sintaxe

class CPaneDialog : public CDockablePane

Membros

Construtores públicos

Nome	Descrição
CPaneDialog::CPaneDialog	Construtor padrão.
CPaneDialog::~CPaneDialog	Destruidor.

Métodos públicos

Nome	Descrição
CPaneDialog::Create	Cria uma caixa de diálogo encaixada e a anexa a um objeto CPaneDialog.
CPaneDialog::CreateObject	Usado pela estrutura para criar uma instância dinâmica desse tipo de classe.
CPaneDialog::GetThisClass	Usado pela estrutura para obter um ponteiro para o objeto CRuntimeClass associado a esse tipo de classe.
CPaneDialog::HandleInitDialog	Identifica a mensagem WM_INITDIALOG. (Redefine CBasePane::HandleInitDialog.)
CPaneDialog::OnEraseBkgnd	Manipula a mensagem de WM_ERASEBKGND. (Redefine CWnd::OnEraseBkgnd.)
CPaneDialog::OnLButtonDblClk	Manipula a mensagem de WM_LBUTTONDBLCLK. (Redefines CWnd::OnLButtonDblClk.)
CPaneDialog::OnLButtonDown	Manipula a mensagem de WM_LBUTTONDOWN. (Redefine CWnd::OnLButtonDown.)
CPaneDialog::OnUpdateCmdUI	Chamado pela estrutura para atualizar a janela da caixa de diálogo. (Substitui CDockablePane::OnUpdateCmdUI.)
CPaneDialog::OnWindowPosChanging	Manipula a mensagem de WM_WINDOWPOSCHANGING. (Redefine CWnd::OnWindowPosChanging.)
CPaneDialog::SetOccDialogInfo	Especifica o modelo para uma caixa de diálogo que é um contêiner de controle OLE.

Comentários

Construa um objeto CPaneDialog em duas etapas. Primeiro, construa o objeto em seu código. Em segundo lugar, chame CPaneDialog::Create. Você deve especificar um nome de modelo de recurso válido ou uma ID de modelo e passar um ponteiro para a janela pai. Caso contrário, o processo de criação falhará. A caixa de diálogo deve especificar o estilo WS_CHILD e WS_VISIBLE. Recomendamos que você também especifique os estilos WS_CLIPCHILDREN e WS_CLIPSIBLINGS. Para obter mais informações, consulte Estilos de Janela.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

CPaneDialog

Requisitos

Cabeçalho: afxpanedialog.h

CPaneDialog::Create

Cria uma caixa de diálogo de encaixe e a anexa a um objetoCPaneDialog.

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
[entrada] O nome da caixa de diálogo de encaixe.

pParentWnd
[in] Aponta para a janela pai.

bHasGripper
[entrada] TRUE para criar a caixa de diálogo de encaixe com uma legenda (gripper), caso contrário, FALSE.

lpszTemplateName
[entrada] O nome do modelo de caixa de diálogo do recurso.

nEstilo
[entrada] O estilo do Windows.

Nid
[entrada] A ID de controle.

nIDTemplate
[entrada] A ID do recurso do modelo de caixa de diálogo.

dwTabbedStyle
[entrada] O estilo da janela com as guias que resulta quando o usuário arrasta outro painel de controle para a legenda desse painel de controle. O valor padrão é AFX_CBRS_REGULAR_TAB. Para obter mais informações, consulte a seção Comentários do método CBasePane::CreateEx.

dwControlBarStyle
[entrada] Atributos de estilo adicionais. O valor padrão é AFX_DEFAULT_DOCKING_PANE_STYLE. Para obter mais informações, consulte a seção Comentários do método CBasePane::CreateEx.

Valor de retorno

TRUE se esse método tiver êxito, caso contrário, FALSE.

Comentários

Exemplo

O seguinte exemplo demonstra como usar o método Create na classe CPaneDialog. Este exemplo faz parte do exemplo Definir Tamanho do Painel.

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

Identifica a mensagem WM_INITDIALOG.

afx_msg LRESULT HandleInitDialog(
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

wParam
[entrada] Manipule para o controle que deve receber o foco padrão do teclado.

lParam
[entrada] Especifica dados de inicialização adicionais.

Valor de retorno

TRUE se o método for bem-sucedido; caso contrário, FALSE. Além disso, TRUE define o foco do teclado para o controle especificado pelo parâmetro wParam, FALSE impede a configuração do foco padrão do teclado.

Comentários

A estrutura usa esse método para inicializar controles e a aparência de uma caixa de diálogo. A estrutura chama esse método antes de exibir a caixa de diálogo.

CPaneDialog::SetOccDialogInfo

Especifica o modelo para uma caixa de diálogo que é um contêiner de controle OLE.

virtual BOOL SetOccDialogInfo(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Parâmetros

pOccDialogInfo
[entrada] Ponteiro para um modelo de caixa de diálogo usado para criar o objeto da caixa de diálogo. O valor desse parâmetro é posteriormente passado para o método COccManager::CreateDlgControls.

Valor de retorno

Sempre TRUE.

Comentários

Esse método dá suporte à classe COccManager, que gerencia sites de controle OLE e controles ActiveX. A estrutura de _AFX_OCC_DIALOG_INFO é definida no arquivo de cabeçalho afxocc.h.

Confira também

Gráfico da hierarquia
Classes
Classe CDockablePane
Estilos de janela