CPaneDialog-Klasse

  • Artikel

Die CPaneDialog Klasse unterstützt ein modusloses, andockbares Dialogfeld.

Syntax

class CPaneDialog : public CDockablePane

Member

Öffentliche Konstruktoren

Name Beschreibung
CPaneDialog::CPaneDialog Der Standardkonstruktor.
CPaneDialog::~CPaneDialog Destruktor.

Öffentliche Methoden

Name Beschreibung
CPaneDialog::Create Erstellt ein andockbares Dialogfeld und fügt es an ein CPaneDialog Objekt an.
CPaneDialog::CreateObject Wird vom Framework verwendet, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CPaneDialog::GetThisClass Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass -Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CPaneDialog::HandleInitDialog Behandelt die WM_INITDIALOG Nachricht. (Definiert CBasePane::HandleInitDialog.)
CPaneDialog::OnEraseBkgnd Behandelt die WM_ERASEBKGND Nachricht. (Definiert neu CWnd::OnEraseBkgnd.)
CPaneDialog::OnLButtonDblClk Behandelt die WM_LBUTTONDBLCLK Nachricht. (Definiert neu CWnd::OnLButtonDblClk.)
CPaneDialog::OnLButtonDown Behandelt die WM_LBUTTONDOWN Nachricht. (Definiert neu CWnd::OnLButtonDown.)
CPaneDialog::OnUpdateCmdUI Vom Framework aufgerufen, um das Dialogfeldfenster zu aktualisieren. (Außerkraftsetzungen CDockablePane::OnUpdateCmdUI.)
CPaneDialog::OnWindowPosChanging Behandelt die WM_WINDOWPOSCHANGING Nachricht. (Definiert neu CWnd::OnWindowPosChanging.)
CPaneDialog::SetOccDialogInfo Gibt die Vorlage für ein Dialogfeld an, bei dem es sich um einen OLE-Steuerelementcontainer handelt.

Hinweise

Erstellen Sie ein CPaneDialog Objekt in zwei Schritten. Erstellen Sie zunächst das Objekt in Ihrem Code. Rufen Sie zweitens CPaneDialog::Create auf. Sie müssen einen gültigen Ressourcenvorlagennamen oder eine Vorlagen-ID angeben und einen Zeiger an das übergeordnete Fenster übergeben. Andernfalls schlägt der Erstellungsprozess fehl. Das Dialogfeld muss die WS_CHILD und WS_VISIBLE Formatvorlage angeben. Es wird empfohlen, auch die formatvorlagen WS_CLIPCHILDREN und WS_CLIPSIBLINGS anzugeben. Weitere Informationen finden Sie unter "Fensterformatvorlagen".

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

CPaneDialog

Anforderungen

Kopfzeile: afxpanedialog.h

CPaneDialog::Create

Erstellt ein Andockdialogfeld und fügt es an ein CPaneDialog Objekt an.

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

Parameter

lpszWindowName
[in] Der Name des Andockdialogfelds.

pParentWnd
[in] Verweist auf das übergeordnete Fenster.

bHasGripper
[in] TRUE zum Erstellen des Andockdialogfelds mit einer Beschriftung (Ziehelement); andernfalls FALSE.

lpszTemplateName
[in] Der Name der Ressourcendialogvorlage.

nStyle
[in] Die Windows-Formatvorlage.

Nid
[in] Die Steuerelement-ID.

nIDTemplate
[in] Die Ressourcen-ID der Dialogfeldvorlage.

dwTabbedStyle
[in] Die Formatvorlage des Fensters im Registerkartenformat, das sich ergibt, wenn der Benutzer einen anderen Steuerelementbereich auf die Beschriftung dieses Steuerelementbereichs zieht. Der Standardwert ist AFX_CBRS_REGULAR_TABS. Weitere Informationen finden Sie im Abschnitt "Hinweise" der CBasePane::CreateEx-Methode .

dwControlBarStyle
[in] Zusätzliche Formatvorlagenattribute. Der Standardwert ist AFX_DEFAULT_DOCKING_PANE_STYLE. Weitere Informationen finden Sie im Abschnitt "Hinweise" der CBasePane::CreateEx-Methode .

Rückgabewert

TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE.

Hinweise

Beispiel

Im folgenden Beispiel wird die Verwendung der Create Methode in der CPaneDialog Klasse veranschaulicht. Dieses Beispiel ist Teil des Beispiels "Größe des Festlegenbereichs".

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

Behandelt die WM_INITDIALOG Nachricht.

afx_msg LRESULT HandleInitDialog(
    WPARAM wParam,
    LPARAM lParam);

Parameter

wParam
[in] Behandeln Sie das Steuerelement, das den Standardtastaturfokus erhält.

lParam
[in] Gibt zusätzliche Initialisierungsdaten an.

Rückgabewert

TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE. Außerdem legt TRUE den Tastaturfokus auf das vom wParam-Parameter angegebene Steuerelement fest. FALSE verhindert das Festlegen des Standard-Tastaturfokus.

Hinweise

Das Framework verwendet diese Methode, um Steuerelemente und die Darstellung eines Dialogfelds zu initialisieren. Das Framework ruft diese Methode auf, bevor das Dialogfeld angezeigt wird.

CPaneDialog::SetOccDialogInfo

Gibt die Vorlage für ein Dialogfeld an, bei dem es sich um einen OLE-Steuerelementcontainer handelt.

virtual BOOL SetOccDialogInfo(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Parameter

pOccDialogInfo
[in] Zeigen Sie auf eine Dialogfeldvorlage, die zum Erstellen des Dialogfeldobjekts verwendet wird. Der Wert dieses Parameters wird anschließend an die COccManager::CreateDlgControls-Methode übergeben.

Rückgabewert

Immer TRUE.

Hinweise

Diese Methode unterstützt die COccManager-Klasse , die OLE-Steuerelementwebsites und ActiveX-Steuerelemente verwaltet. Die _AFX_OCC_DIALOG_INFO Struktur wird in der Headerdatei afxocc.h definiert.

Siehe auch

Hierarchiediagramm
Klassen
CDockablePane-Klasse
Fensterstile