CBasePane-Klasse

Artikel
03/26/2013

Basisklasse für alle Bereiche in MFC.

class CBasePane : public CWnd

Mitglieder

Öffentliche Konstruktoren

Name	Description
CBasePane::CBasePane	Standardkonstruktor.
CBasePane::~CBasePane	Destruktor.

Öffentliche Methoden

Name	Description
CBasePane::accHitTest	Aufgerufen vom Framework, um das untergeordnete Element oder das untergeordnete Objekt an einem angegebenen Punkt auf dem Bildschirm abzurufen.(Überschreibungen CWnd::accHitTest.)
CBasePane::accLocation	Aufgerufen vom Framework, um die aktuelle Bildschirmposition für das angegebene Objekt abzurufen.(Überschreibungen CWnd::accLocation.)
CBasePane::AccNotifyObjectFocusEvent	CBasePane verwendet diese Methode nicht.
CBasePane::accSelect	Aufgerufen durch das Framework, um die Auswahl zu ändern oder den Tastaturfokus des angegebenen Objekts zu verschieben.(Überschreibungen CWnd::accSelect.)
CBasePane::AddPane	Fügt einen Bereich dem Andocken Manager hinzu.
CBasePane::AdjustDockingLayout	Leitet einen Aufruf zum Andocken Manager um, um das andockbare Layout anzupassen.
CBasePane::AdjustLayout	Aufgerufen vom Framework, wenn der Bereich seine interne Layout anpassen soll.
CBasePane::CalcFixedLayout	Berechnet die horizontale Größe einer Steuerleiste.
CBasePane::CanAcceptPane	Bestimmt, ob ein anderer Bereich in den Bereich angedockt werden kann.
CBasePane::CanAutoHide	Bestimmt, ob der Bereich Modus "Automatisches Ausblenden" unterstützt.
CBasePane::CanBeAttached	Bestimmt, ob der Bereich zu einem anderen Bereich angedockt werden kann.
CBasePane::CanBeClosed	Bestimmt, ob der Bereich geschlossen werden kann.
CBasePane::CanBeDocked	Bestimmt, ob der Bereich zu einem anderen Bereich angedockt werden kann.
CBasePane::CanBeResized	Bestimmt, ob der Bereich angepasst werden kann.
CBasePane::CanBeTabbedDocument	Gibt an, ob der Bereich zu einem MDI mit den versehenen Dokument konvertiert werden kann.
CBasePane::CanFloat	Bestimmt, ob der Bereich Float kann.
CBasePane::CanFocus	Gibt an, ob der Bereich den Fokus erhalten kann.
CBasePane::CopyState	Kopiert den Zustand eines angegebenen Bereichs.
CBasePane::CreateDefaultMiniframe	Wenn der Bereich Float kann, bietet ein Minirahmenfenster erstellt.
CBasePane::CreateEx	Erstellt das Pane-Steuerelement.
CBasePane::DockPane	Dockt einen Bereich zu einem anderen Bereich oder einem Rahmenfenster an.
CBasePane::DockPaneUsingRTTI	Dockt den Bereich mithilfe von Laufzeit-Typeninformation an.
CBasePane::DockToFrameWindow	Dockt ein andockbares Fenster zu Frame anzuzeigen.
CBasePane::DoesAllowDynInsertBefore	Bestimmt, ob ein anderer Bereich zwischen diesen Bereich und die übergeordneten Frames dynamisch eingefügt werden kann.
CBasePane::EnableDocking	Aktiviert Andocken des Bereichs zum Großrechner.
CBasePane::EnableGripper	Aktiviert oder deaktiviert den Ziehpunkt.Wenn der Ziehpunkt aktiviert ist, kann der Benutzer ziehen, um den Bereich neu anzuordnen.
CBasePane::FillWindowRect	Wird intern verwendet.
CBasePane::FloatPane	Schwimmt den Bereich.
CBasePane::get_accChild	Aufgerufen durch das Framework, um die Adresse einer IDispatch-Schnittstelle für das angegebene untergeordnete Element abzurufen.(Überschreibungen CWnd::get_accChild.)
CBasePane::get_accChildCount	Aufgerufen vom Framework, um die Anzahl untergeordneter Elemente ab, die diesem Objekt gehören.(Überschreibungen CWnd::get_accChildCount.)
CBasePane::get_accDefaultAction	Aufgerufen durch das Framework, um eine Zeichenfolge abzurufen, die die Standardaktion für das Objekt beschrieben wird.(Überschreibungen CWnd::get_accDefaultAction.)
CBasePane::get_accDescription	Aufgerufen durch Framework, um eine Zeichenfolge abzurufen, die die visuelle Darstellung des angegebenen Objekts beschreibt.(Überschreibungen CWnd::get_accDescription.)
CBasePane::get_accFocus	Aufgerufen durch das Framework, um das Objekt ab, das den Tastaturfokus hat.(Überschreibungen CWnd::get_accFocus.)
CBasePane::get_accHelp	Aufgerufen vom Framework, um eine Hilfeeigenschaftzeichenfolge für das Objekt abzurufen.(Überschreibungen CWnd::get_accHelp.)
CBasePane::get_accHelpTopic	Aufgerufen vom Framework, um den vollständigen Pfad des WinHelpfile abzurufen, das dem angegebenen Objekt und dem entsprechenden Bezeichner des Themas in dieser Datei zugeordnet ist.(Überschreibungen CWnd::get_accHelpTopic.)
CBasePane::get_accKeyboardShortcut	Aufgerufen durch das Framework, um die angegebene Tastenkombination für das Objekt abzurufen.(Überschreibungen CWnd::get_accKeyboardShortcut.)
CBasePane::get_accName	Aufgerufen vom Framework, um den Namen des angegebenen Objekts abzurufen.(Überschreibungen CWnd::get_accName.)
CBasePane::get_accParent	Aufgerufen vom Framework, um die IDispatch-Schnittstelle für das übergeordnete Element des Objekts abzurufen.(Überschreibungen CWnd::get_accParent.)
CBasePane::get_accRole	Aufgerufen vom Framework, um Informationen abzurufen, die die Rolle des angegebenen Objekts beschreibt.(Überschreibungen CWnd::get_accRole.)
CBasePane::get_accSelection	Aufgerufen vom Framework, um die ausgewählten untergeordneten Elemente aus diesem abzurufenden Objekts.(Überschreibungen CWnd::get_accSelection.)
CBasePane::get_accState	Aufgerufen vom Framework, um den aktuellen Zustand des angegebenen Objekts abzurufen.(Überschreibungen WaitForStatus-Methode.)
CBasePane::get_accValue	Aufgerufen vom Framework, um den Wert des angegebenen Objekts abzurufen.(Überschreibungen CWnd::get_accValue.)
CBasePane::GetCaptionHeight	Gibt die Beschriftungshöhe zurück.
CBasePane::GetControlBarStyle	Gibt das Steuerleistenformat zurück.
CBasePane::GetCurrentAlignment	Gibt die aktuelle Bereichsausrichtung zurück.
CBasePane::GetDockingMode	Gibt den aktuellen Andockmodus für den Bereich zurück.
CBasePane::GetDockSiteFrameWnd	Gibt einen Zeiger auf das Fenster zurück, das die Docksite für den Bereich ist.
CBasePane::GetEnabledAlignment	Gibt die CBRS_ALIGN_-Formate zurück, die dem Bereich angewendet werden.
CBasePane::GetMFCStyle	Gibt die Bereichsformate zurück, die MFC spezifisch sind.
CBasePane::GetPaneIcon	Gibt ein Handle für Bereichssymbol zurück.
CBasePane::GetPaneRect	Wird intern verwendet.
CBasePane::GetPaneRow	Gibt einen Zeiger auf CDockingPanesRow-Objekt zurück, in dem der Bereich angedockt ist.
CBasePane::GetPaneStyle	Gibt das Bereichsformat zurück.
CBasePane::GetParentDockSite	Gibt einen Zeiger auf die Elemente Docksite zurück.
CBasePane::GetParentMiniFrame	Gibt einen Zeiger auf Elementen Minirahmenfenster zurück.
CBasePane::GetParentTabbedPane	Gibt einen Zeiger auf die Elemente Seite im Registerformat zurück.
CBasePane::GetParentTabWnd	Gibt einen Zeiger auf das übergeordnete Fenster zurück, das in einer Registerkarte ist.
CBasePane::GetRecentVisibleState	Das Framework ruft diese Methode auf, wenn ein Bereich von einem Archiv wiederhergestellt wird.
CBasePane::HideInPrintPreviewMode	Gibt an, ob der Bereich in der Seitenansicht ausgeblendet ist.
CBasePane::InsertPane	Registriert den angegebenen Bereich mit dem Andocken Manager.
CBasePane::IsAccessibilityCompatible	Gibt an, ob der Bereich Active Accessibility unterstützt.
CBasePane::IsAutoHideMode	Bestimmt, ob ein Bereich im Modus "Automatisches Ausblenden" ist.
CBasePane::IsDialogControl	Gibt an, ob der Bereich ein Dialogfeld-Steuerelement ist.
CBasePane::IsDocked	Bestimmt, ob der Bereich angedockt ist.
CBasePane::IsFloating	Bestimmt, ob der Bereich unverankert ist.
CBasePane::IsHorizontal	Bestimmt, ob der Bereich horizontal angedockt wird.
CBasePane::IsInFloatingMultiPaneFrameWnd	Gibt an, ob der Bereich in einem Rahmenfenster mit mehreren Bereichen ist.
CBasePane::IsMDITabbed	Bestimmt, ob der Bereich zu einem untergeordneten MDI-Fenster als Dokument im Registerkartenformat hinzugefügt wurde.
CBasePane::IsPaneVisible	Gibt an, ob das WS_VISIBLE-Flag für den Bereich festgelegt wird.
CBasePane::IsPointNearDockSite	Bestimmt, ob ein bestimmter Punkt neben der Docksite ist.
CBasePane::IsResizable	Bestimmt, ob der Bereich angepasst werden kann.
CBasePane::IsRestoredFromRegistry	Bestimmt, ob der Bereich aus der Registrierung wiederhergestellt wird.
CBasePane::IsTabbed	Bestimmt, ob der Bereich in das Tab-Steuerelement eines Fensters im Registerkartenformat eingefügt wurde.
CBasePane::IsTooltipTopmost	Wird intern verwendet.
CBasePane::IsVisible	Bestimmt, ob der Bereich sichtbar ist.
CBasePane::LoadState	Lädt den Bereichszustand aus der Registrierung.
CBasePane::MoveWindow	Verschiebt den Bereich.
CBasePane::OnAfterChangeParent	Aufgerufen vom Framework, wenn das übergeordnete Element des Bereichs geändert wurde.
CBasePane::OnBeforeChangeParent	Aufgerufen vom Framework vor dem Bereich ändert das übergeordnete Fenster.
CBasePane::OnDrawCaption	Das Framework ruft diese Methode auf, wenn die Beschriftung gezeichnet wird.
CBasePane::OnMovePaneDivider	Diese Methode wird momentan nicht verwendet.
CBasePane::OnPaneContextMenu	Aufgerufen vom Framework, wenn ein Menü erstellt, das eine Liste von Bereichen umfasst.
CBasePane::OnRemoveFromMiniFrame	Aufgerufen vom Framework ausgelöst, wenn ein Bereich von übergeordneten Minirahmenfenster entfernt wird.
CBasePane::OnSetAccData	CBasePane verwendet diese Methode nicht.
CBasePane::OnUpdateCmdUI	Wird intern verwendet.
CBasePane::PaneFromPoint	Gibt den Bereich zurück, der den angegebenen Punkt enthält.
CBasePane::PreTranslateMessage	Wird von Klasse CWinApp, um Fenstermeldungen zu übersetzen, bevor sie an den TranslateMessage und DispatchMessage Windows-Funktionen weitergeleitet werden.(Überschreibungen CWnd::PreTranslateMessage.)
CBasePane::RecalcLayout	CBasePane verwendet diese Methode nicht.
CBasePane::RemovePaneFromDockManager	Hebt einen Bereich Registrierung auf und entfernt sie aus der Liste im Andocken Manager.
CBasePane::SaveState	Rettet den Zustand des Bereichs in die Registrierung.
CBasePane::SelectDefaultFont	Wählt die Standardschriftart für einen angegebenen Gerätekontext aus.
CBasePane::Serialize	Liest oder Schreiben dieses Objekt von oder einem Archiv.(Überschreibungen CObject::Serialize.)
CBasePane::SetControlBarStyle	Legt das Steuerleistenformat fest.
CBasePane::SetDockingMode	Legt den Andockmodus für den Bereich fest.
CBasePane::SetMDITabbed	Wird intern verwendet.
CBasePane::SetPaneAlignment	Legt die Ausrichtung für den Bereich fest.
CBasePane::SetPaneRect	Wird intern verwendet.
CBasePane::SetPaneStyle	Legt das Format des Bereichs fest.
CBasePane::SetRestoredFromRegistry	Wird intern verwendet.
CBasePane::SetWindowPos	Ändert die Größe, Position und die Z-Reihenfolge eines Bereichs.
CBasePane::ShowPane	In oder aus der Bereich.
CBasePane::StretchPane	Streckt einen Bereich vertikal oder horizontal.
CBasePane::UndockPane	Entfernt den Bereich von der Docksite, vom Standardwert Schieberegler oder vom Minirahmenfenster, in dem er gerade angedockt ist.

Geschützte Methoden

Name	Description
CBasePane::DoPaint	Füllt den Hintergrund des Bereichs aus.

Hinweise

Wenn Sie eine Bereichsklasse erstellen möchten, die die erweiterten Andocken Funktionen unterstützt, die in MFC verfügbar sind, müssen Sie es aus CBasePane oder von CPane-Klasse berechnen.

Anpassungs-Tipps

Die folgenden Anpassungstipps betreffen CBasePane-Klasse und alle Klassen, die davon erben:

Wenn Sie einen Bereich erstellen, können Sie mehrere neue Formate anwenden:
- AFX_CBRS_FLOAT stellt den Bereich wird nun erstellt.
- AFX_CBRS_AUTOHIDE aktiviert Modus "Automatisches Ausblenden".
- AFX_CBRS_CLOSE aktiviert den geschlossen werden, (Bereich ausgeblendet wurde).
Diese sind Flags, die Sie mit einer bitweisen OR-Operation kombiniert werden können.

CBasePane implementiert die folgenden booleschen virtuellen Methoden, um diese Flags wiederzugeben: CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat.Sie können sie in abgeleiteten Klassen überschreiben, um deren Verhalten anzupassen.
Sie können Dockverhalten anpassen, indem Sie CBasePane::CanAcceptPane überschreiben.Haben Sie die Bereichsrückgabe FALSE dieser Methode, um einen anderen Bereichs am Andocken zu verhindern.
Wenn Sie einen statischen Bereich erstellen möchten, der nicht Fenstern können und der einen anderen Bereich am Andocken davor verhindert (ähnlich der Outlook-Leiste im OutlookDemo-Beispiel), erstellen Sie es als nicht-unverankertes und überschreiben Sie CBasePane::DoesAllowDynInsertBefore, um FALSE zurückzugeben.Die Standardimplementierung gibt FALSE zurück, wenn der Bereich ohne das AFX_CBRS_FLOAT Format erstellt wird.
Stellen Sie alle Bereiche mit IDs auf -1 erstellt.
Um Bereichssichtbarkeit zu bestimmen, verwenden Sie CBasePane::IsVisible.Sie verarbeitet ordnungsgemäß den Sichtbarkeitszustand in im Registerkartenformat und in den Modi "Automatisches Ausblenden".
Wenn Sie einen nicht-unverankerten in der Größe veränderbaren Bereich erstellen möchten, erstellen Sie ihn ohne das AFX_CBRS_FLOAT Format erstellt und rufen Sie CFrameWnd::DockControlBar auf.
Um einen Bereich von einem Andocken Layout auszuschließen oder eine Symbolleiste aus der Dockleiste zu entfernen, rufen Sie CBasePane::UndockPane auf.Rufen Sie diese Methode nicht für Bereiche im Modus "Automatisches Ausblenden" oder für Bereiche aufgeführt, die in den Registerkarten von Fenstern im Registerkartenformat befinden.
Wenn Sie einen Bereich Float oder abdocken möchten, der im Modus "Automatisches Ausblenden" ist, müssen Sie CDockablePane::SetAutoHideMode mit FALSE aufrufen während das erste Argument, bevor Sie CBasePane::FloatPane oder CBasePane::UndockPane aufrufen.

Beispiel

Das folgende Beispiel zeigt, wie verschiedene Methoden in der Klasse CBasePane verwendet.Das Beispiel zeigt, wie ein Bereich von der CFrameWndEx-Klasse abgerufen und wie den Andockmodus, die Bereichsausrichtung und das Bereichsformat festgelegt wird.Der Code ist von Word-Auflagenbeispiel.

            // This CMainFrame class extends the CFrameWndEx class.
            // GetPane is a method in the CFrameWndEx class which 
            // Returns a pointer to the pane that has the specified ID.
            CBasePane* pBar = GetPane(ID_VIEW_FORMATBAR);
            if (pBar != NULL)
            {
                // Set the docking mode, the pane alignment, and the pane style.
                pBar->SetDockingMode(DT_STANDARD);
                pBar->SetPaneAlignment(CBRS_ALIGN_LEFT);
                pBar->SetPaneStyle(pBar->GetCurrentAlignment() | CBRS_TOOLTIPS);
                pBar->ShowPane(TRUE, FALSE, FALSE);
            }