CPaneDialog – třída

Třída CPaneDialog podporuje bezmodální dokovatelné dialogové okno.

Syntaxe

class CPaneDialog : public CDockablePane

Členové

Veřejné konstruktory

Název	Popis
CPaneDialog::CPaneDialog	Výchozí konstruktor.
CPaneDialog::~CPaneDialog	Destruktor.

Veřejné metody

Název	Popis
CPaneDialog::Create	Vytvoří dokovatelné dialogové okno a připojí ho k objektu CPaneDialog .
CPaneDialog::CreateObject	Používá se architekturou k vytvoření dynamické instance tohoto typu třídy.
CPaneDialog::GetThisClass	Používá se architekturou k získání ukazatele na CRuntimeClass objektu, který je přidružen k tomuto typu třídy.
CPaneDialog::HandleInitDialog	Zpracovává WM_INITDIALOG zprávu. (Předefinuje CBasePane::HandleInitDialog.)
CPaneDialog::OnEraseBkgnd	Zpracovává WM_ERASEBKGND zprávu. (Předefiny CWnd::OnEraseBkgnd.)
CPaneDialog::OnLButtonDblClk	Zpracovává zprávu WM_LBUTTONDBLCLK. (Předefiny CWnd::OnLButtonDblClk.)
CPaneDialog::OnLButtonDown	Zpracovává zprávu WM_LBUTTONDOWN. (Předefiny CWnd::OnLButtonDown.)
CPaneDialog::OnUpdateCmdUI	Volá se rozhraním pro aktualizaci okna dialogového okna. (Přepsání CDockablePane::OnUpdateCmdUI.)
CPaneDialog::OnWindowPosChanging	Zpracovává zprávu WM_WINDOWPOSCHANGING. (Předefiny CWnd::OnWindowPosChanging.)
CPaneDialog::SetOccDialogInfo	Určuje šablonu pro dialogové okno, které je kontejner ovládacího prvku OLE.

Poznámky

Vytvořte CPaneDialog objekt ve dvou krocích. Nejprve vytvořte objekt v kódu. Za druhé volání CPaneDialog::Create. Je nutné zadat platný název šablony prostředku nebo ID šablony a předat ukazatel na nadřazené okno. Jinak se proces vytváření nezdaří. Dialogové okno musí určovat styl WS_CHILD a WS_VISIBLE. Doporučujeme také zadat styly WS_CLIPCHILDREN a WS_CLIPSIBLINGS. Další informace naleznete v tématu Styly oken.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CBasePane

Podokno CPane

CDockablePane

CPaneDialog

Požadavky

Hlavička: afxpanedialog.h

CPaneDialog::Create

Vytvoří dokovací dialogové okno a připojí ho k objektu CPaneDialog .

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
[v] Název dialogového okna ukotvení.

pParentWnd
[v] Odkazuje na nadřazené okno.

bHasGripper
[v] TRUE pro vytvoření dokovací dialogové okno s titulkem (úchyt); jinak NEPRAVDA.

lpszTemplateName
[v] Název šablony dialogového okna prostředku

nStyle
[v] Styl Windows.

Nid
[v] ID ovládacího prvku.

nIDTemplate
[v] ID prostředku šablony dialogového okna.

dwTabbedStyle
[v] Styl okna s kartami, které vede k tomu, že uživatel přetáhne jiné ovládací podokno na titulek tohoto podokna ovládacích prvků. Výchozí hodnota je AFX_CBRS_REGULAR_TABS. Další informace naleznete v části Poznámky CBasePane::CreateEx metoda.

dwControlBarStyle
[v] Další atributy stylu Výchozí hodnota je AFX_DEFAULT_DOCKING_PANE_STYLE. Další informace naleznete v části Poznámky CBasePane::CreateEx metoda.

Návratová hodnota

TRUE, pokud tato metoda bude úspěšná; jinak NEPRAVDA.

Poznámky

Příklad

Následující příklad ukazuje, jak použít metodu Create CPaneDialog ve třídě. Tento příklad je součástí ukázky Nastavení velikosti podokna.

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

Zpracovává WM_INITDIALOG zprávu.

afx_msg LRESULT HandleInitDialog(
    WPARAM wParam,
    LPARAM lParam);

Parametry

wParam
[v] Popisovač ovládacího prvku, který má dostat výchozí fokus klávesnice.

lParam
[v] Určuje další inicializační data.

Návratová hodnota

TRUE, pokud tato metoda je úspěšná; jinak NEPRAVDA. Kromě toho pravda nastaví fokus klávesnice na ovládací prvek určený parametrem wParam ; NEPRAVDA zabraňuje nastavení výchozího fokusu klávesnice.

Poznámky

Architektura používá tuto metodu k inicializaci ovládacích prvků a vzhledu dialogového okna. Architektura volá tuto metodu před zobrazením dialogového okna.

CPaneDialog::SetOccDialogInfo

Určuje šablonu pro dialogové okno, které je kontejner ovládacího prvku OLE.

virtual BOOL SetOccDialogInfo(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Parametry

pOccDialogInfo
[v] Ukazatel na šablonu dialogového okna, která slouží k vytvoření objektu dialogového okna. Hodnota tohoto parametru je následně předána do COccManager::CreateDlgControls metoda.

Návratová hodnota

Vždy PRAVDA.

Poznámky

Tato metoda podporuje třídu COccManager , která spravuje lokality ovládacích prvků OLE a ovládací prvky ActiveX. Struktura _AFX_OCC_DIALOG_INFO je definována v souboru hlavičky afxocc.h.

Viz také

Graf hierarchie
Třídy
CDockablePane – třída
Styly oken