Udostępnij za pośrednictwem

Klasa CDialogBar

  • Artykuł

Udostępnia funkcje okna dialogowego bez moderowania systemu Windows na pasku sterowania.

Składnia

class CDialogBar : public CControlBar

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CDialogBar::CDialogBar CDialogBar Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
CDialogBar::Create Tworzy pasek okna dialogowego i dołącza go do CDialogBar obiektu.

Uwagi

Pasek okna dialogowego przypomina okno dialogowe, w którym zawiera standardowe kontrolki systemu Windows, między którymi użytkownik może karty. Innym podobieństwem jest utworzenie szablonu okna dialogowego reprezentującego pasek okna dialogowego.

Tworzenie i używanie paska dialogowego jest podobne do tworzenia i używania CFormView obiektu. Najpierw użyj edytora okien dialogowych, aby zdefiniować szablon okna dialogowego z stylem WS_CHILD i nie ma innego stylu. Szablon nie może mieć WS_VISIBLE stylu. W kodzie aplikacji wywołaj konstruktor, aby skonstruować CDialogBar obiekt, a następnie wywołaj Create polecenie , aby utworzyć okno paska dialogowego CDialogBar i dołączyć go do obiektu.

Aby uzyskać więcej informacji na temat CDialogBarprogramu , zobacz artykuł Paski okien dialogowych i Uwagi techniczne 31, Paski sterowania.

Uwaga

W bieżącej wersji CDialogBar obiekt nie może hostować kontrolek Windows Forms. Aby uzyskać więcej informacji na temat kontrolek formularzy systemu Windows w programie Visual C++, zobacz Using a Windows Form User Control in MFC (Używanie kontrolki użytkownika formularza systemu Windows w MFC).

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CControlBar

CDialogBar

Wymagania

Nagłówek: afxext.h

CDialogBar::CDialogBar

CDialogBar Tworzy obiekt.

CDialogBar();

CDialogBar::Create

Ładuje szablon zasobu okna dialogowego określony przez lpszTemplateName lub nIDTemplate, tworzy okno paska dialogowego, ustawia jego styl i kojarzy go z obiektem CDialogBar .

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

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

Parametry

pParentWnd
Wskaźnik do obiektu nadrzędnego CWnd .

lpszTemplateName
Wskaźnik do nazwy szablonu zasobu okna dialogowego CDialogBar obiektu.

nStyle
Styl paska narzędzi. Obsługiwane są dodatkowe style paska narzędzi:

  • CBRS_TOP Pasek sterowania znajduje się w górnej części okna ramki.

  • CBRS_BOTTOM pasek sterowania znajduje się w dolnej części okna ramki.

  • CBRS_NOALIGN pasek sterowania nie jest zmieniany po zmianie rozmiaru elementu nadrzędnego.

  • CBRS_TOOLTIPS Pasek sterowania wyświetla wskazówki dotyczące narzędzi.

  • CBRS_SIZE_DYNAMIC pasek sterowania jest dynamiczny.

  • CBRS_SIZE_FIXED pasek sterowania jest stały.

  • CBRS_FLOATING Pasek sterowania jest przestawny.

  • CBRS_FLYBY pasek stanu wyświetla informacje o przycisku.

  • CBRS_HIDE_INPLACE pasek sterowania nie jest wyświetlany użytkownikowi.

Nid
Identyfikator kontrolki paska dialogowego.

nIDTemplate
Identyfikator zasobu szablonu okna dialogowego CDialogBar obiektu.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Jeśli określisz styl wyrównania CBRS_TOP lub CBRS_BOTTOM, szerokość paska dialogowego jest taka, że w oknie ramowym i jego wysokości jest zasób określony przez nIDTemplate. Jeśli określisz styl wyrównania CBRS_LEFT lub CBRS_RIGHT, wysokość paska dialogowego to wysokość okna ramowego i jego szerokość jest zasobem określonym przez nIDTemplate.

Przykład

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

Zobacz też

Przykładowe CTRLBARS MFC
Klasa CControlBar
Wykres hierarchii
Klasa CFormView
Klasa CControlBar