Classe CDialogBar

Fornece a funcionalidade de uma caixa de diálogo sem janela restrita do Windows em uma barra de controle.

Sintaxe

class CDialogBar : public CControlBar

Membros

Construtores públicos

Nome	Descrição
CDialogBar::CDialogBar	Constrói um objeto CDialogBar.

Métodos públicos

Nome	Descrição
CDialogBar::Create	Cria uma barra de diálogo do Windows e a anexa ao objeto CDialogBar.

Comentários

Uma barra de diálogo é semelhante a uma caixa de diálogo no sentido em que contém controles padrão do Windows entre os quais o usuário pode fazer a tabulação. Outra semelhança é que você cria um modelo de caixa de diálogo para representar a barra de diálogo.

Criar e usar uma barra de diálogo é semelhante à criação e ao uso de um objeto CFormView. Primeiro, use o editor de caixa de diálogo para definir um modelo de caixa de diálogo com o estilo WS_CHILD e nenhum outro estilo. O modelo não deve ter o estilo WS_VISIBLE. No código do aplicativo, chame o construtor para construir o objeto CDialogBar e, em seguida, chame Create para criar a janela da barra de diálogo e anexá-la ao objeto CDialogBar.

Para obter mais informações sobre CDialogBar, consulte o artigo Barras de Diálogo e a Nota Técnica 31, Barras de Controle.

Observação

Na versão atual, um objeto CDialogBar não pode hospedar controles de Windows Forms. Para obter mais informações sobre os controles do Windows Forms no Visual C++, consulte Usando um controle de usuário do Windows Forms no MFC.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CControlBar

CDialogBar

Requisitos

Cabeçalho: afxext.h

CDialogBar::CDialogBar

Constrói um objeto CDialogBar.

CDialogBar();

CDialogBar::Create

Carrega o modelo de recurso de caixa de diálogo especificado por lpszTemplateName ou nIDTemplate, cria a janela da barra de diálogo, define seu estilo e o associa ao objeto CDialogBar.

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

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

Parâmetros

pParentWnd
Um ponteiro para o objeto CWnd pai.

lpszTemplateName
Um ponteiro para o nome do modelo de recurso de caixa de diálogo do objeto CDialogBar.

nEstilo
O estilo de barra de ferramentas. Os outros estilos de barra de ferramentas com suporte são:

• CBRS_TOP A barra de controle está na parte superior da janela de quadros.

• CBRS_BOTTOM A barra de controle está na parte inferior da janela de quadros.

• CBRS_NOALIGN A barra de controle não é reposicionada quando o pai é redimensionado.

• CBRS_TOOLTIPS A barra de controle exibe dicas de ferramenta.

• CBRS_SIZE_DYNAMIC A barra de controle é dinâmica.

• CBRS_SIZE_FIXED A barra de controle é fixa.

• CBRS_FLOATING A barra de controle está flutuando.

• CBRS_FLYBY A barra de status exibe informações sobre o botão.

• CBRS_HIDE_INPLACE A barra de controle não é exibida para o usuário.

Nid
A ID de controle da barra de diálogo.

nIDTemplate
A ID do recurso do modelo de caixa de diálogo do objeto CDialogBar.

Valor de Devolução

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

Se você especificar o estilo de alinhamento CBRS_TOP ou CBRS_BOTTOM, a largura da barra de diálogo será a da janela do quadro e sua altura será a do recurso especificado por nIDTemplate. Se você especificar o estilo de alinhamento CBRS_LEFT ou CBRS_RIGHT, a altura da barra de diálogo será a da janela do quadro e sua largura será a do recurso especificado por nIDTemplate.

Exemplo

int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CMDIFrameWnd::OnCreate(lpCreateStruct) == -1)
      return -1;

   EnableDocking(CBRS_ALIGN_ANY);

   // m_wndDlgBar is a CDialogBar member of CMainFrame
   // IDD_DIALOGBAR - Resource ID of the dialog
   // template. This dialog template should be created
   // with  the  style  WS_CHILD and no other style.
   // The template must not have the style WS_VISIBLE.
   if (!m_wndDlgBar.Create(this, IDD_DIALOGBAR,
                           CBRS_LEFT | CBRS_TOOLTIPS | CBRS_FLYBY, IDD_DIALOGBAR))
   {
      TRACE0("Failed to create DlgBar\n");
      return -1; // Fail to create.
   }

   return 0;
}

Confira também

CTRLBARS de exemplo do MFC
Classe CControlBar
Gráfico da hierarquia
Classe CFormView
Classe CControlBar