Klasa CPaneDialog

Klasa CPaneDialog obsługuje okno dialogowe bez moderowania, dokowalne.

Składnia

class CPaneDialog : public CDockablePane

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
CPaneDialog::CPaneDialog	Konstruktor domyślny.
CPaneDialog::~CPaneDialog	Destruktora.

Metody publiczne

Nazwa/nazwisko	opis
CPaneDialog::Create	Tworzy okno dialogowe z możliwością dokowania i dołącza je do CPaneDialog obiektu.
CPaneDialog::CreateObject	Używana przez platformę do tworzenia wystąpienia dynamicznego tego typu klasy.
CPaneDialog::GetThisClass	Używany przez platformę do uzyskiwania wskaźnika do obiektu CRuntimeClass skojarzonego z tym typem klasy.
CPaneDialog::HandleInitDialog	Obsługuje komunikat WM_INITDIALOG. (Ponownie definiuje . CBasePane::HandleInitDialog)
CPaneDialog::OnEraseBkgnd	Obsługuje komunikat WM_ERASEBKGND. (Ponowne definicje CWnd::OnEraseBkgnd.)
CPaneDialog::OnLButtonDblClk	Obsługuje komunikat WM_LBUTTONDBLCLK. (Ponowne definicje CWnd::OnLButtonDblClk.)
CPaneDialog::OnLButtonDown	Obsługuje komunikat WM_LBUTTONDOWN. (Ponowne definicje CWnd::OnLButtonDown).
CPaneDialog::OnUpdateCmdUI	Wywoływana przez platformę w celu zaktualizowania okna dialogowego. (Przesłonięcia) CDockablePane::OnUpdateCmdUI.
CPaneDialog::OnWindowPosChanging	Obsługuje komunikat WM_WINDOWPOSCHANGING. (Ponowne definicje CWnd::OnWindowPosChanging.
CPaneDialog::SetOccDialogInfo	Określa szablon okna dialogowego, który jest kontenerem kontrolki OLE.

Uwagi

Skonstruuj CPaneDialog obiekt w dwóch krokach. Najpierw skonstruuj obiekt w kodzie. Po drugie wywołaj metodę CPaneDialog::Create. Należy określić prawidłową nazwę szablonu zasobu lub identyfikator szablonu i przekazać wskaźnik do okna nadrzędnego. W przeciwnym razie proces tworzenia zakończy się niepowodzeniem. Okno dialogowe musi określać styl WS_CHILD i WS_VISIBLE. Zalecamy również określenie stylów WS_CLIPCHILDREN i WS_CLIPSIBLINGS. Aby uzyskać więcej informacji, zobacz Style okien.

Hierarchia dziedziczenia

Cobject

Ccmdtarget

Cwnd

CBasePane

Cpane

Cdockablepane

CPaneDialog

Wymagania

Nagłówek: afxpanedialog.h

CPaneDialog::Create

Tworzy okno dialogowe dokowania i dołącza je do CPaneDialog obiektu.

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

Parametry

lpszWindowName
[in] Nazwa okna dialogowego dokowania.

pParentWnd
[in] Wskazuje okno nadrzędne.

bHasGripper
[in] WARTOŚĆ TRUE, aby utworzyć okno dialogowe dokowania z podpis (uchwyt); w przeciwnym razie FALSE.

lpszTemplateName
[in] Nazwa szablonu okna dialogowego zasobu.

nStyle
[in] Styl systemu Windows.

Nid
[in] Identyfikator kontrolki.

nIDTemplate
[in] Identyfikator zasobu szablonu okna dialogowego.

dwTabbedStyle
[in] Styl okna z kartami, który powoduje przeciągnięcie innego okienka sterowania na podpis tego okienka sterowania. Wartość domyślna to AFX_CBRS_REGULAR_TABS. Aby uzyskać więcej informacji, zobacz sekcję Uwagi metody CBasePane::CreateEx .

dwControlBarStyle
[in] Dodatkowe atrybuty stylu. Wartość domyślna to AFX_DEFAULT_DOCKING_PANE_STYLE. Aby uzyskać więcej informacji, zobacz sekcję Uwagi metody CBasePane::CreateEx .

Wartość zwracana

Wartość TRUE, jeśli ta metoda powiedzie się; w przeciwnym razie, FAŁSZ.

Uwagi

Przykład

W poniższym przykładzie pokazano, jak używać Create metody w CPaneDialog klasie . Ten przykład jest częścią przykładu Ustawianie rozmiaru okienka.

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

Obsługuje komunikat WM_INITDIALOG.

afx_msg LRESULT HandleInitDialog(
    WPARAM wParam,
    LPARAM lParam);

Parametry

Wparam
[in] Dojmij do kontrolki, która ma odbierać domyślny fokus klawiatury.

Lparam
[in] Określa dodatkowe dane inicjowania.

Wartość zwracana

Wartość TRUE, jeśli ta metoda zakończyła się pomyślnie; w przeciwnym razie, FAŁSZ. Ponadto wartość TRUE ustawia fokus klawiatury na kontrolkę określoną przez parametr wParam ; Wartość FALSE uniemożliwia ustawienie domyślnego fokusu klawiatury.

Uwagi

Struktura używa tej metody do inicjowania kontrolek i wyglądu okna dialogowego. Struktura wywołuje tę metodę przed wyświetleniem okna dialogowego.

CPaneDialog::SetOccDialogInfo

Określa szablon okna dialogowego, który jest kontenerem kontrolki OLE.

virtual BOOL SetOccDialogInfo(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Parametry

pOccDialogInfo
[in] Wskaźnik do szablonu okna dialogowego używanego do tworzenia obiektu okna dialogowego. Wartość tego parametru jest następnie przekazywana do metody COccManager::CreateDlgControls .

Wartość zwracana

Zawsze prawda.

Uwagi

Ta metoda obsługuje klasę COccManager , która zarządza lokacjami kontrolek OLE i kontrolkami ActiveX. Struktura _AFX_OCC_DIALOG_INFO jest zdefiniowana w pliku nagłówkowym afxocc.h.

Zobacz też

Wykres hierarchii
Klasy
Klasa CDockablePane
Style okien