CPaneDialog, classe

La CPaneDialog classe prend en charge une boîte de dialogue sans mode et ancreable.

Syntaxe

class CPaneDialog : public CDockablePane

Membres

Constructeurs publics

Nom	Description
CPaneDialog::CPaneDialog	Constructeur par défaut.
CPaneDialog::~CPaneDialog	Destructeur.

Méthodes publiques

Nom	Description
CPaneDialog ::Create	Crée une boîte de dialogue ancreable et l’attache à un CPaneDialog objet.
CPaneDialog::CreateObject	Utilisé par l'infrastructure pour créer une instance dynamique de ce type de classe.
CPaneDialog::GetThisClass	Utilisé par l’infrastructure pour obtenir un pointeur vers l’objet CRuntimeClass associé à ce type de classe.
CPaneDialog ::HandleInitDialog	Gère le message WM_INITDIALOG . (Redéfinit CBasePane::HandleInitDialog.)
CPaneDialog::OnEraseBkgnd	Gère le message WM_ERASEBKGND . (Redéfinissez CWnd ::OnEraseBkgnd.)
CPaneDialog::OnLButtonDblClk	Gère le message WM_LBUTTONDBLCLK . (Redéfinissez CWnd ::OnLButtonDblClk.)
CPaneDialog::OnLButtonDown	Gère le message WM_LBUTTONDOWN . (Redéfinissez CWnd ::OnLButtonDown.)
CPaneDialog::OnUpdateCmdUI	Appelé par l’infrastructure pour mettre à jour la fenêtre de boîte de dialogue. (Remplacements CDockablePane ::OnUpdateCmdUI.)
CPaneDialog::OnWindowPosChanging	Gère le message WM_WINDOWPOSCHANGING . (Redéfinissez CWnd ::OnWindowPosChanging.)
CPaneDialog ::SetOccDialogInfo	Spécifie le modèle d’une boîte de dialogue qui est un conteneur de contrôle OLE.

Notes

Construisez un CPaneDialog objet en deux étapes. Tout d’abord, construisez l’objet dans votre code. Ensuite, appelez CPaneDialog ::Create. Vous devez spécifier un nom de modèle de ressource valide ou un ID de modèle et passer un pointeur vers la fenêtre parente. Sinon, le processus de création échoue. La boîte de dialogue doit spécifier le style WS_CHILD et WS_VISIBLE. Nous vous recommandons également de spécifier les styles WS_CLIPCHILDREN et WS_CLIPSIBLINGS. Pour plus d’informations, consultez Styles de fenêtre.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

CPaneDialog

Spécifications

En-tête : afxpanedialog.h

CPaneDialog ::Create

Crée une boîte de dialogue d’ancrage et l’attache à un CPaneDialog objet.

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

Paramètres

lpszWindowName
[in] Nom de la boîte de dialogue d’ancrage.

pParentWnd
[in] Pointe vers la fenêtre parente.

bHasGripper
[in] TRUE pour créer la boîte de dialogue d’ancrage avec une légende (gripper) ; sinon, FALSE.

lpszTemplateName
[in] Nom du modèle de boîte de dialogue de ressource.

nStyle
[in] Style Windows.

nID
[in] ID de contrôle.

nIDTemplate
[in] ID de ressource du modèle de boîte de dialogue.

dwTabbedStyle
[in] Style de la fenêtre à onglets qui se traduit lorsque l’utilisateur fait glisser un autre volet de contrôle sur la légende de ce volet de contrôle. La valeur par défaut est AFX_CBRS_REGULAR_TABS. Pour plus d’informations, consultez la section Notes de la méthode CBasePane ::CreateEx .

dwControlBarStyle
[in] Attributs de style supplémentaires. La valeur par défaut est AFX_DEFAULT_DOCKING_PANE_STYLE. Pour plus d’informations, consultez la section Notes de la méthode CBasePane ::CreateEx .

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE.

Notes

Exemple

L’exemple suivant montre comment utiliser la Create méthode dans la CPaneDialog classe. Cet exemple fait partie de l’exemple Définir la taille du volet.

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

Gère le message WM_INITDIALOG .

afx_msg LRESULT HandleInitDialog(
    WPARAM wParam,
    LPARAM lParam);

Paramètres

wParam
[in] Gérez le contrôle qui doit recevoir le focus clavier par défaut.

lParam
[in] Spécifie des données d’initialisation supplémentaires.

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE. En outre, TRUE définit le focus clavier sur le contrôle spécifié par le paramètre wParam ; FALSE empêche la définition du focus clavier par défaut.

Notes

L’infrastructure utilise cette méthode pour initialiser les contrôles et l’apparence d’une boîte de dialogue. L’infrastructure appelle cette méthode avant d’afficher la boîte de dialogue.

CPaneDialog ::SetOccDialogInfo

Spécifie le modèle d’une boîte de dialogue qui est un conteneur de contrôle OLE.

virtual BOOL SetOccDialogInfo(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Paramètres

pOccDialogInfo
[in] Pointeur vers un modèle de boîte de dialogue utilisé pour créer l’objet de boîte de dialogue. La valeur de ce paramètre est ensuite passée à la méthode COccManager ::CreateDlgControls .

Valeur de retour

Toujours TRUE.

Notes

Cette méthode prend en charge la classe COccManager , qui gère les sites de contrôle OLE et les contrôles ActiveX. La structure _AFX_OCC_DIALOG_INFO est définie dans le fichier d’en-tête afxocc.h.

Voir aussi

Graphique hiérarchique
Classes
CDockablePane, classe
Styles de fenêtre