Klasa CPaneDialog
Klasa CPaneDialog
obsługuje okno dialogowe bez moderowania, dokowalne.
Składnia
class CPaneDialog : public CDockablePane
Elementy członkowskie
Konstruktory publiczne
Nazwa/nazwisko | opis |
---|---|
CPaneDialog::CPaneDialog |
Konstruktor domyślny. |
CPaneDialog::~CPaneDialog |
Destruktor. |
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
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 w celu utworzenia okna dialogowego dokowania z podpisem (uchwyt); w przeciwnym razie, FAŁSZ.
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 jest wynikiem przeciągania przez użytkownika 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.