Classe CPaneDialog

La CPaneDialog classe supporta una finestra di dialogo non modale e ancorabile.

Sintassi

class CPaneDialog : public CDockablePane

Membri

Costruttori pubblici

Metodi pubblici

Osservazioni:

Costruire un CPaneDialog oggetto in due passaggi. Creare prima di tutto l'oggetto nel codice. In secondo luogo, chiamare CPaneDialog::Create. È necessario specificare un nome di modello di risorsa o un ID modello valido e passare un puntatore alla finestra padre. In caso contrario, il processo di creazione non riesce. La finestra di dialogo deve specificare lo stile WS_CHILD e WS_VISIBLE. È consigliabile specificare anche gli stili di WS_CLIPCHILDREN e WS_CLIPSIBLINGS. Per altre informazioni, vedere Stili finestra.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

CPaneDialog

Requisiti

Intestazione: afxpanedialog.h

CPaneDialog::Create

Crea una finestra di dialogo di ancoraggio e la collega a un CPaneDialog oggetto .

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

Parametri

lpszWindowName
[in] Nome della finestra di dialogo di ancoraggio.

pParentWnd
[in] Punta alla finestra padre.

bHasGripper
[in] TRUE per creare la finestra di dialogo di ancoraggio con una didascalia (gripper); in caso contrario, FALSE.

lpszTemplateName
[in] Nome del modello di finestra di dialogo della risorsa.

nStyle
[in] Stile di Windows.

nID
[in] ID del controllo.

nIDTemplate
[in] ID risorsa del modello di finestra di dialogo.

dwTabbedStyle
[in] Stile della finestra a schede risultante quando l'utente trascina un altro riquadro di controllo nella didascalia di questo riquadro di controllo. Il valore predefinito è AFX_CBRS_REGULAR_TABS. Per altre informazioni, vedere la sezione Osservazioni del metodo CBasePane::CreateEx .

dwControlBarStyle
[in] Attributi di stile aggiuntivi. Il valore predefinito è AFX_DEFAULT_DOCKING_PANE_STYLE. Per altre informazioni, vedere la sezione Osservazioni del metodo CBasePane::CreateEx .

Valore restituito

TRUE se il metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

Esempio

Nell'esempio seguente viene illustrato come usare il Create metodo nella CPaneDialog classe . Questo esempio fa parte dell'esempio Set Pane Size .This example is part of the Set Pane Size sample.

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

Gestisce il messaggio di WM_INITDIALOG .

afx_msg LRESULT HandleInitDialog(
    WPARAM wParam,
    LPARAM lParam);

Parametri

wParam
[in] Handle per il controllo che deve ricevere lo stato attivo predefinito della tastiera.

lParam
[in] Specifica dati di inizializzazione aggiuntivi.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE. TRUE imposta inoltre lo stato attivo della tastiera sul controllo specificato dal parametro wParam ; FALSE impedisce di impostare lo stato attivo predefinito della tastiera.

Osservazioni:

Il framework usa questo metodo per inizializzare i controlli e l'aspetto di una finestra di dialogo. Il framework chiama questo metodo prima di visualizzare la finestra di dialogo.

CPaneDialog::SetOccDialogInfo

Specifica il modello per una finestra di dialogo che è un contenitore di controlli OLE.

virtual BOOL SetOccDialogInfo(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Parametri

pOccDialogInfo
[in] Puntatore a un modello di finestra di dialogo utilizzato per creare l'oggetto finestra di dialogo. Il valore di questo parametro viene successivamente passato al metodo COccManager::CreateDlgControls .

Valore restituito

Sempre TRUE.

Osservazioni:

Questo metodo supporta la classe COccManager , che gestisce i siti di controllo OLE e i controlli ActiveX. La struttura _AFX_OCC_DIALOG_INFO è definita nel file di intestazione afxocc.h.

Vedi anche

Grafico della gerarchia
Classi
Classe CDockablePane
Stili di finestra