CPaneDialog-Klasse
Die CPaneDialog
Klasse unterstützt ein modusloses, andockbares Dialogfeld.
class CPaneDialog : public CDockablePane
Name | Beschreibung |
---|---|
CPaneDialog::CPaneDialog |
Der Standardkonstruktor. |
CPaneDialog::~CPaneDialog |
Destruktor. |
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. |
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".
Kopfzeile: afxpanedialog.h
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);
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 .
TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE.
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
}
Behandelt die WM_INITDIALOG Nachricht.
afx_msg LRESULT HandleInitDialog(
WPARAM wParam,
LPARAM lParam);
wParam
[in] Behandeln Sie das Steuerelement, das den Standardtastaturfokus erhält.
lParam
[in] Gibt zusätzliche Initialisierungsdaten an.
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.
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.
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);
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.
Immer TRUE.
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.
Hierarchiediagramm
Klassen
CDockablePane-Klasse
Fensterstile