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

Métodos públicos

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.

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 retorno

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