Condividi tramite

Classe CDialogBar

  • Articolo

Fornisce la funzionalità di una finestra di dialogo non modale di Windows in una barra di controllo.

Sintassi

class CDialogBar : public CControlBar

Membri

Costruttori pubblici

Nome Descrizione
CDialogBar::CDialogBar Costruisce un oggetto CDialogBar.

Metodi pubblici

Nome Descrizione
CDialogBar::Create Crea una barra della finestra di dialogo di Windows e la collega all'oggetto CDialogBar .

Osservazioni:

Una barra di dialogo è simile a una finestra di dialogo in cui contiene controlli Windows standard tra cui l'utente può eseguire la scheda. Un'altra somiglianza consiste nel creare un modello di finestra di dialogo per rappresentare la barra delle finestre di dialogo.

La creazione e l'uso di una barra delle finestre di dialogo è simile alla creazione e all'uso di un CFormView oggetto . Usare prima di tutto l'editor di dialoghi per definire un modello di dialogo con lo stile WS_CHILD e nessun altro stile. Il modello non deve avere lo stile WS_VISIBLE. Nel codice dell'applicazione chiamare il costruttore per costruire l'oggetto CDialogBar , quindi chiamare Create per creare la finestra della barra della finestra di dialogo e collegarla all'oggetto CDialogBar .

Per altre informazioni su CDialogBar, vedere l'articolo Barre dei dialoghi e Note tecniche 31, Barre di controllo.

Nota

Nella versione corrente un CDialogBar oggetto non può ospitare Windows Form controlli. Per altre informazioni sui controlli Windows Form in Visual C++, vedere Uso di un controllo utente di Windows Form in MFC.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CControlBar

CDialogBar

Requisiti

Intestazione: afxext.h

CDialogBar::CDialogBar

Costruisce un oggetto CDialogBar.

CDialogBar();

CDialogBar::Create

Carica il modello di risorsa della finestra di dialogo specificato da lpszTemplateName o nIDTemplate, crea la finestra della barra di dialogo, ne imposta lo stile e lo associa all'oggetto CDialogBar .

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

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

Parametri

pParentWnd
Puntatore all'oggetto padre CWnd .

lpszTemplateName
Puntatore al nome del CDialogBar modello di risorsa della finestra di dialogo dell'oggetto.

nStyle
Stile della barra degli strumenti. Sono supportati altri stili della barra degli strumenti:

  • CBRS_TOP barra di controllo si trova nella parte superiore della finestra cornice.

  • CBRS_BOTTOM barra di controllo si trova nella parte inferiore della finestra cornice.

  • CBRS_NOALIGN barra di controllo non viene riposizionata quando l'elemento padre viene ridimensionato.

  • CBRS_TOOLTIPS barra di controllo visualizza i suggerimenti degli strumenti.

  • CBRS_SIZE_DYNAMIC barra di controllo è dinamica.

  • CBRS_SIZE_FIXED barra di controllo è fissa.

  • CBRS_FLOATING barra di controllo è mobile.

  • CBRS_FLYBY barra di stato visualizza informazioni sul pulsante.

  • CBRS_HIDE_INPLACE barra di controllo non viene visualizzata all'utente.

nID
ID del controllo della barra delle finestre di dialogo.

nIDTemplate
ID risorsa del CDialogBar modello della finestra di dialogo dell'oggetto.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Se si specifica lo stile di allineamento CBRS_TOP o CBRS_BOTTOM, la larghezza della barra delle finestre di dialogo è quella della finestra cornice e l'altezza è quella della risorsa specificata da nIDTemplate. Se si specifica lo stile di allineamento CBRS_LEFT o CBRS_RIGHT, l'altezza della barra di dialogo è quella della finestra cornice e la larghezza è quella della risorsa specificata da nIDTemplate.

Esempio

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;
}

Vedi anche

MFC Sample CTRLBARS
CControlBar Class
Grafico della gerarchia
Classe CFormView
CControlBar Class