Dela via

CBasePane-klass

Basklass för alla fönster i MFC.

Syntax

class CBasePane : public CWnd

Medlemmar

Offentliga konstruktorer

Namn Beskrivning
CBasePane::CBasePane Standardkonstruktor.
CBasePane::~CBasePane Destructor.

Offentliga metoder

Namn Beskrivning
CBasePane::accHitTest Anropas av ramverket för att hämta det underordnade elementet eller det underordnade objektet vid en viss punkt på skärmen. (Åsidosätter CWnd::accHitTest.)
CBasePane::accLocation Anropas av ramverket för att hämta den aktuella skärmplatsen för det angivna objektet. (Åsidosätter CWnd::accLocation.)
CBasePane::AccNotifyObjectFocusEvent CBasePane använder inte den här metoden.
CBasePane::accSelect Anropas av ramverket för att ändra markeringen eller flytta tangentbordsfokus för det angivna objektet. (Åsidosätter CWnd::accSelect.)
CBasePane::AddPane Lägger till ett fönster i dockningshanteraren.
CBasePane::AdjustDockingLayout Omdirigerar ett anrop till dockningshanteraren för att justera dockningslayouten.
CBasePane::AdjustLayout Anropas av ramverket när fönstret ska justera sin interna layout.
CBasePane::CalcFixedLayout Beräknar den vågräta storleken på ett kontrollfält.
CBasePane::CanAcceptPane Avgör om ett annat fönster kan dockas till fönstret.
CBasePane::CanAutoHide Avgör om fönstret har stöd för automatiskt döljningsläge.
CBasePane::CanBeAttached Avgör om fönstret kan dockas till ett annat fönster.
CBasePane::CanBeClosed Avgör om fönstret kan stängas.
CBasePane::CanBeDocked Avgör om fönstret kan dockas till ett annat fönster.
CBasePane::CanBeResized Avgör om fönstret kan ändras.
CBasePane::CanBeTabbedDocument Anger om fönstret kan konverteras till ett MDI-flikarat dokument.
CBasePane::CanFloat Avgör om fönstret kan flyta.
CBasePane::CanFocus Anger om fönstret kan få fokus.
CBasePane::CopyState Kopierar tillståndet för ett visst fönster.
CBasePane::CreateDefaultMiniframe Om fönstret kan flyta skapar du ett miniramfönster.
CBasePane::CreateEx Skapar fönsterkontrollen.
CBasePane::D ockPane Dockar ett fönster till ett annat fönster eller till ett ramfönster.
CBasePane::D ockPaneUsingRTTI Dockar fönstret med hjälp av information om körningstyp.
CBasePane::D ockToFrameWindow Dockar ett dockbart fönster till en ram.
CBasePane::D oesAllowDynInsertBefore Avgör om ett annat fönster kan infogas dynamiskt mellan det här fönstret och den överordnade ramen.
CBasePane::EnableDocking Aktiverar dockning av fönstret till huvudramen.
CBasePane::EnableGripper Aktiverar eller inaktiverar griparen. Om griparen är aktiverad kan användaren dra den för att flytta fönstret.
CBasePane::FillWindowRect Används internt.
CBasePane::FloatPane Flyter fönstret.
CBasePane::get_accChild Anropas av ramverket för att hämta adressen till ett IDispatch-gränssnitt för det angivna underordnade objektet. (Åsidosätter CWnd::get_accChild.)
CBasePane::get_accChildCount Anropas av ramverket för att hämta antalet underordnade objekt som tillhör det här objektet. (Åsidosätter CWnd::get_accChildCount.)
CBasePane::get_accDefaultAction Anropas av ramverket för att hämta en sträng som beskriver standardåtgärden för objektet. (Åsidosätter CWnd::get_accDefaultAction.)
CBasePane::get_accDescription Anropas av framework för att hämta en sträng som beskriver det visuella utseendet på det angivna objektet. (Åsidosätter CWnd::get_accDescription.)
CBasePane::get_accFocus Anropas av ramverket för att hämta objektet som har tangentbordsfokus. (Åsidosätter CWnd::get_accFocus.)
CBasePane::get_accHelp Anropas av ramverket för att hämta en hjälpegenskapssträng för objektet. (Åsidosätter CWnd::get_accHelp.)
CBasePane::get_accHelpTopic Anropas av ramverket för att hämta den fullständiga sökvägen till WinHelp-filen som är associerad med det angivna objektet och identifieraren för lämpligt ämne i filen. (Åsidosätter CWnd::get_accHelpTopic.)
CBasePane::get_accKeyboardShortcut Anropas av ramverket för att hämta den angivna genvägsnyckeln för objektet. (Åsidosätter CWnd::get_accKeyboardShortcut.)
CBasePane::get_accName Anropas av ramverket för att hämta namnet på det angivna objektet. (Åsidosätter CWnd::get_accName.)
CBasePane::get_accParent Anropas av ramverket för att hämta IDispatch gränssnittet för objektets överordnade objekt. (Åsidosätter CWnd::get_accParent.)
CBasePane::get_accRole Anropas av ramverket för att hämta information som beskriver det angivna objektets roll. (Åsidosätter CWnd::get_accRole.)
CBasePane::get_accSelection Anropas av ramverket för att hämta de markerade underordnade objekten i det här objektet. (Åsidosätter CWnd::get_accSelection.)
CBasePane::get_accState Anropas av ramverket för att hämta det aktuella tillståndet för det angivna objektet. (Åsidosätter CWnd::get_accState.)
CBasePane::get_accValue Anropas av ramverket för att hämta värdet för det angivna objektet. (Åsidosätter CWnd::get_accValue.)
CBasePane::GetCaptionHeight Returnerar bildtextens höjd.
CBasePane::GetControlBarStyle Returnerar kontrollfältets formatmall.
CBasePane::GetCurrentAlignment Returnerar den aktuella fönsterjusteringen.
CBasePane::GetDockingMode Returnerar det aktuella dockningsläget för fönstret.
CBasePane::GetDockSiteFrameWnd Returnerar en pekare till fönstret som är dockningsplatsen för fönstret.
CBasePane::GetEnabledAlignment Returnerar de CBRS_ALIGN_ formatmallar som används i fönstret.
CBasePane::GetMFCStyle Returnerar de fönsterformat som är specifika för MFC.
CBasePane::GetPaneIcon Returnerar ett handtag till fönsterikonen.
CBasePane::GetPaneRect Används internt.
CBasePane::GetPaneRow Returnerar en pekare till CDockingPanesRow-objektet där fönstret är dockat.
CBasePane::GetPaneStyle Returnerar fönsterformatet.
CBasePane::GetParentDockSite Returnerar en pekare till den överordnade dockningsplatsen.
CBasePane::GetParentMiniFrame Returnerar en pekare till det överordnade miniramsfönstret.
CBasePane::GetParentTabbedPane Returnerar en pekare till det överordnade fönstret med flikar.
CBasePane::GetParentTabWnd Returnerar en pekare till det överordnade fönstret som finns inuti en flik.
CBasePane::GetRecentVisibleState Ramverket anropar den här metoden när ett fönster återställs från ett arkiv.
CBasePane::HideInPrintPreviewMode Anger om fönstret är dolt i förhandsgranskningen.
CBasePane::InsertPane Registrerar det angivna fönstret med dockningshanteraren.
CBasePane::IsAccessibilityCompatible Anger om fönstret stöder aktiv tillgänglighet.
CBasePane::IsAutoHideMode Avgör om ett fönster är i automatiskt döljläge.
CBasePane::IsDialogControl Anger om fönstret är en dialogkontroll.
CBasePane::IsDocked Avgör om fönstret är dockat.
CBasePane::IsFloating Avgör om fönstret är flytande.
CBasePane::IsHorizontal Avgör om fönstret är dockat vågrätt.
CBasePane::IsInFloatingMultiPaneFrameWnd Anger om fönstret finns i ett ramfönster med flera fönster.
CBasePane::IsMDITabbed Avgör om fönstret har lagts till i ett underordnat MDI-fönster som ett tabbdokument.
CBasePane::IsPaneVisible Anger om flaggan WS_VISIBLE har angetts för fönstret.
CBasePane::IsPointNearDockSite Avgör om en angiven punkt ligger nära dockningsplatsen.
CBasePane::IsResizable Avgör om fönstret kan ändras.
CBasePane::IsRestoredFromRegistry Avgör om fönstret återställs från registret.
CBasePane::IsTabbed Avgör om fönstret har infogats i tabbkontrollen i ett fönster med flikar.
CBasePane::IsTooltipTopmost Används internt.
CBasePane::IsVisible Avgör om fönstret är synligt.
CBasePane::LoadState Läser in fönstertillståndet från registret.
CBasePane::MoveWindow Flyttar fönstret.
CBasePane::OnAfterChangeParent Anropas av ramverket när fönstrets överordnade har ändrats.
CBasePane::OnBeforeChangeParent Anropas av ramverket precis innan fönstret ändrar sitt överordnade fönster.
CBasePane::OnDrawCaption Ramverket anropar den här metoden när bildtexten ritas.
CBasePane::OnMovePaneDivider Den här metoden används för närvarande inte.
CBasePane::OnPaneContextMenu Anropas av ramverket när det skapar en meny som har en lista över fönster.
CBasePane::OnRemoveFromMiniFrame Anropas av ramverket när ett fönster tas bort från dess överordnade miniramfönster.
CBasePane::OnSetAccData CBasePane använder inte den här metoden.
CBasePane::OnUpdateCmdUI Används internt.
CBasePane::P aneFromPoint Returnerar fönstret som innehåller den angivna punkten.
CBasePane::PreTranslateMessage Används av klassen CWinApp för att översätta fönstermeddelanden innan de skickas till funktionerna TranslateMessage och DispatchMessage Windows. (Åsidosätter CWnd::P reTranslateMessage.)
CBasePane::RecalcLayout CBasePane använder inte den här metoden.
CBasePane::RemovePaneFromDockManager Avregistrerar ett fönster och tar bort det från listan i dockningshanteraren.
CBasePane::SaveState Sparar fönstrets tillstånd i registret.
CBasePane::SelectDefaultFont Väljer standardteckensnittet för en viss enhetskontext.
CBasePane::Serialize Läser eller skriver det här objektet från eller till ett arkiv. (Åsidosätter CObject::Serialize.)
CBasePane::SetControlBarStyle Anger kontrollfältets formatmall.
CBasePane::SetDockingMode Anger dockningsläget för fönstret.
CBasePane::SetMDITabbed Används internt.
CBasePane::SetPaneAlignment Anger justeringen för fönstret.
CBasePane::SetPaneRect Används internt.
CBasePane::SetPaneStyle Anger formatet för fönstret.
CBasePane::SetRestoredFromRegistry Används internt.
CBasePane::SetWindowPos Ändrar storlek, position och Z-ordning för ett fönster.
CBasePane::ShowPane Visar eller döljer fönstret.
CBasePane::StretchPane Sträcker ut en ruta lodrätt eller vågrätt.
CBasePane::UndockPane Tar bort fönstret från dockningsplatsen, standardreglaget eller miniramsfönstret där det för närvarande är dockat.

Skyddade metoder

Namn Beskrivning
CBasePane::D oPaint Fyller bakgrunden i fönstret.

Anmärkningar

Om du vill skapa en fönsterklass som stöder de utökade dockningsfunktionerna som är tillgängliga i MFC måste du härleda den från CBasePane eller från CPane-klassen.

Anpassningstips

Följande anpassningstips gäller för alla CBasePane Class klasser och som ärver från den:

  • När du skapar ett fönster kan du använda flera nya format:

    • AFX_CBRS_FLOAT får fönstret att flyta.

    • AFX_CBRS_AUTOHIDE aktiverar automatiskt döljläge.

    • AFX_CBRS_CLOSE gör att fönstret kan stängas (dolt).

    Det här är flaggor som du kan kombinera med en bitvis-OR-åtgärd.

CBasePane implementerar följande virtuella booleska metoder för att återspegla dessa flaggor: CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat. Du kan åsidosätta dem i härledda klasser för att anpassa deras beteende.

  • Du kan anpassa dockningsbeteendet genom att åsidosätta CBasePane::CanAcceptPane. Låt fönstret returnera FALSE från den här metoden för att förhindra att en annan ruta dockar till den.

  • Om du vill skapa ett statiskt fönster som inte kan flyta och som hindrar andra fönster från att docka före det (liknar Outlook-fältet i OutlookDemo-exemplet) skapar du det som icke-flytande och åsidosätter CBasePane::D oesAllowDynInsertBefore för att returnera FALSE. Standardimplementeringen returnerar FALSE om fönstret skapas utan AFX_CBRS_FLOAT formatmall.

  • Skapa alla fönster med andra ID:er än -1.

  • Om du vill fastställa fönstrets synlighet använder du CBasePane::IsVisible. Den hanterar synlighetstillståndet korrekt i lägena tabb och dölj automatiskt.

  • Om du vill skapa ett icke-flytande storleksbart fönster skapar du det utan formatmallen AFX_CBRS_FLOAT och anropar CFrameWnd::D ockControlBar.

  • Om du vill undanta ett fönster från en dockningslayout eller ta bort ett verktygsfält från dockningsfältet anropar du CBasePane::UndockPane. Anropa inte den här metoden för fönster i automatiskt dolt läge eller för fönster som finns i flikar i flikar i fönster med flikar.

  • Om du vill flytta eller ta bort ett fönster som är i automatiskt döljläge måste du anropa CDockablePane::SetAutoHideMode med FALSE som det första argumentet innan du anropar CBasePane::FloatPane eller CBasePane::UndockPane.

Exempel

I följande exempel visas hur du använder olika metoder i klassen CBasePane. Exemplet visar hur du hämtar ett fönster från CFrameWndEx klassen och hur du ställer in dockningsläget, fönsterjusteringen och fönsterformatet. Koden kommer från Word Pad-exemplet.

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

Arvshierarki

CObject

CCmdTarget

CWnd

CBasePane

Kravspecifikation

Rubrik: afxbasepane.h

CBasePane::AccNotifyObjectFocusEvent

CBasePane använder inte den här metoden.

virtual void AccNotifyObjectFocusEvent(int);

Parameterar

Int
[i] Används inte.

CBasePane::AddPane

Lägger till ett fönster i dockningshanteraren.

void AddPane(CBasePane* pBar);

Parameterar

pBar
[i] En pekare till ett fönster att lägga till.

Anmärkningar

Det här är en bekvämlighetsmetod som lägger till ett fönster i en dockningshanterare. Med den här metoden behöver du inte skriva kod som analyserar den överordnade ramens typ.

Mer information finns i CDockingManager Class och CMDIFrameWndEx::AddPane.

CBasePane::AdjustDockingLayout

Omdirigerar ett anrop till dockningshanteraren för att justera dockningslayouten.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parameterar

hdwp
[ut] Ett handtag till en struktur som innehåller flera fönsterpositioner.

Anmärkningar

Det här är en bekvämlighetsmetod som justerar dockningslayouten. Med den här metoden behöver du inte skriva kod som analyserar den överordnade ramens typ.

Mer information finns i CDockingManager::AdjustDockingLayout

CBasePane::AdjustLayout

Anropas av ramverket för att justera den interna layouten för ett fönster.

virtual void AdjustLayout();

Anmärkningar

Ramverket anropar den här metoden när ett fönster måste justera sin interna layout. Grundimplementeringen gör ingenting.

CBasePane::CalcFixedLayout

Beräknar den vågräta storleken på ett kontrollfält.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parameterar

bStretch
[i] Anger om stapeln ska sträckas till ramens storlek. Parametern bStretch är intezero när fältet inte är ett dockningsfält (inte tillgängligt för dockning) och är 0 när det är dockat eller flytande (tillgängligt för dockning).

bHorz
[i] Anger att stapeln är vågrätt eller lodrätt orienterad. Parametern bHorz är intezero om stapeln är vågrätt orienterad och är 0 om den är vertikalt orienterad.

Returvärde

Kontrollfältets storlek, i bildpunkter, för ett CSize objekt.

Anmärkningar

Se avsnittet kommentarer i CControlBar::CalcFixedLayout

CBasePane::CanAcceptPane

Avgör om ett annat fönster kan dockas till fönstret.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Parameterar

pBar
[i] En pekare till fönstret som ska dockas.

Returvärde

SANT om ett annat fönster kan accepteras; annars FALSKT.

Anmärkningar

Ramverket anropar den här metoden innan den dockar fönstret som anges av pBar till det aktuella fönstret.

Använd den här metoden och metoden CBasePane::CanBeDocked för att styra hur fönster dockas till andra fönster i programmet.

Standardimplementeringen returnerar FALSE.

CBasePane::CanAutoHide

Avgör om fönstret har stöd för automatiskt döljningsläge.

virtual BOOL CanAutoHide() const;

Returvärde

SANT om det här fönstret stöder läget dölj automatiskt. annars FALSKT.

Anmärkningar

Ramverket anropar den här funktionen för att avgöra om fönstret stöder automatiskt döljläge.

Under konstruktionen kan du ange den här möjligheten genom att skicka flaggan AFX_CBRS_AUTOHIDE till CBasePane::CreateEx.

Standardimplementeringen söker efter flaggan AFX_CBRS_AUTOHIDE. Åsidosätt den här metoden i en härledd klass för att anpassa det här beteendet.

CBasePane::CanBeAttached

Avgör om fönstret kan dockas till ett annat fönster eller ramfönster.

virtual BOOL CanBeAttached() const;

Returvärde

SANT om fönstret kan dockas till ett annat fönster eller ramfönster. annars FALSKT.

Anmärkningar

Standardimplementeringen returnerar FALSE. Åsidosätt den här metoden i en härledd klass för att aktivera eller inaktivera möjligheten att docka utan att anropa CBasePane::EnableDocking.

CBasePane::CanBeClosed

Avgör om fönstret kan stängas.

virtual BOOL CanBeClosed() const;

Returvärde

SANT om fönstret kan stängas. annars FALSKT.

Anmärkningar

Ramverket anropar den här metoden för att avgöra om fönstret kan stängas. Om metoden returnerar TRUE läggs knappen Stäng till i fönstrets namnlist eller, om fönstret svävar, i namnlisten i fönstrets miniramfönster.

Under konstruktionen kan du ange den här möjligheten genom att skicka flaggan AFX_CBRS_CLOSE till CBasePane::CreateEx.

Standardimplementeringen söker efter flaggan AFX_CBRS_CLOSE.

CBasePane::CanBeDocked

Avgör om fönstret kan dockas till ett annat fönster.

virtual BOOL CanBeDocked(CBasePane* pDockBar) const;

Parameterar

pDockBar
[i] En pekare till ett annat fönster.

Returvärde

SANT om det här fönstret kan dockas till ett annat fönster; annars FALSKT.

Anmärkningar

Ramverket anropar den här metoden innan den dockar fönstret som anges av pDockBar till det aktuella fönstret.

Använd den här metoden och metoden CBasePane::CanAcceptPane för att styra hur fönster dockar till andra fönster i ditt program.

Standardimplementeringen returnerar FALSE.

CBasePane::CanBeResized

Avgör om fönstret kan ändras.

virtual BOOL CanBeResized() const;

Returvärde

SANT om fönstret kan ändras; annars FALSKT.

Anmärkningar

Den här metoden söker efter flaggan AFX_CBRS_RESIZE, som anges som standard i CBasePane::OnCreate. Om den här flaggan inte har angetts flaggar dockningshanteraren fönstret internt som fast i stället för att docka den.

CBasePane::CanBeTabbedDocument

Anger om fönstret kan konverteras till ett MDI-flikarat dokument.

virtual BOOL CanBeTabbedDocument() const;

Returvärde

SANT om fönstret kan konverteras till ett tabbdokument. annars FALSKT. CBasePane::CanBeTabbedDocument returnerar alltid FALSE.

Anmärkningar

Endast objekt av vissa CBasePane-härledda typer, till exempel CDockablePane-klassen, kan konverteras till flikar.

CBasePane::CanFloat

Avgör om fönstret kan flyta.

virtual BOOL CanFloat() const;

Returvärde

SANT om fönstret kan flyta; annars FALSKT.

Anmärkningar

Ramverket anropar den här metoden för att avgöra om fönstret kan flyta.

Under konstruktionen kan du ange den här möjligheten genom att skicka flaggan AFX_CBRS_FLOAT till CBasePane::CreateEx.

Anmärkning

Ramverket förutsätter att icke-flytande fönsterrutor är statiska och att deras dockningstillstånd inte kan ändras. Därför sparar ramverket inte dockningstillståndet för icke-flytande fönster.

Standardimplementeringen söker efter formatmallen AFX_CBRS_FLOAT.

CBasePane::CanFocus

Anger om fönstret kan få fokus.

virtual BOOL CanFocus() const;

Returvärde

SANT om fönstret kan få fokus; annars FALSKT.

Anmärkningar

Åsidosätt den här metoden i en härledd klass för att styra fokus. Eftersom verktygsfält till exempel inte kan ta emot fokus returnerar den här metoden FALSE när den anropas för verktygsfältsobjekt.

Ramverket försöker ange indatafokus när ett fönster dockas eller flyttas.

CBasePane::CopyState

Kopierar tillståndet för ett visst fönster.

virtual void CopyState(CBasePane* pOrgBar);

Parameterar

pOrgBar
[i] En pekare till ett annat fönster.

Anmärkningar

Den här metoden kopierar tillståndet från pOrgBar till det här fönstret.

CBasePane::CreateDefaultMiniframe

Om fönstret kan flyta skapar den här metoden ett miniramfönster för det.

virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);

Parameterar

rectInitial
[i] Anger de första koordinaterna för miniramsfönstret.

Returvärde

En pekare till det nya miniramsfönstret eller NULL om skapandet misslyckades.

Anmärkningar

Ramverket anropar den här metoden när ett fönster växlar till ett flytande tillstånd. Metoden skapar ett miniramfönster och kopplar fönstret till det här fönstret.

Standardimplementeringen returnerar NULL.

CBasePane::CreateEx

Skapar fönsterkontrollen.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    DWORD dwControlBarStyle=0,
    CCreateContext* pContext=NULL);

Parameterar

dwStyleEx
[i] De utökade formaten (se CWnd::CreateEx för mer information).

lpszClassName
[i] Fönstrets klassnamn.

lpszWindowName
[i] Fönstrets namn.

dwStyle
[i] Fönsterformatet (se CWnd::CreateEx).

rekt
[i] Den första rektangeln.

pParentWnd
[i] En pekare till det överordnade fönstret.

Nid
[i] Anger fönstrets ID. Måste vara unikt.

dwControlBarStyle
[i] Formatflaggor för fönster.

pContext
[i] En pekare till CcreateContext

Returvärde

SANT om fönstret har skapats. annars FALSKT.

Anmärkningar

Skapar ett fönster med klassen lpszClassName. Om du anger WS_CAPTION rensar den här metoden den WS_CAPTION formatbiten och anger CBasePane::m_bHasCaption true eftersom biblioteket inte stöder fönster med bildtexter.

Du kan använda valfri kombination av underordnade fönsterformat och MFC-kontrollfältformat (CBRS_).

Biblioteket lägger till flera nya formatmallar för fönster. I följande tabell beskrivs de nya formaten:

Stil Beskrivning
AFX_CBRS_FLOAT Fönstret kan flyta.
AFX_CBRS_AUTOHIDE Fönstret stöder automatiskt döljläge
AFX_CBRS_RESIZE Fönstret kan ändras. Viktig: Det här formatet har inte implementerats.
AFX_CBRS_CLOSE Fönstret kan stängas.
AFX_CBRS_AUTO_ROLLUP Fönstret kan rullas upp när det flyter.
AFX_CBRS_REGULAR_TABS När en ruta dockar till ett annat fönster med det här formatet skapas ett vanligt fönster med flikar. Mer information finns i CTabbedPane-klass.
AFX_CBRS_OUTLOOK_TABS När en ruta dockar till ett annat fönster med det här formatet skapas ett fönster med flikar i Outlook-format. Mer information finns i KLASSEN CMFCOutlookBar.

Om du vill använda de nya formaten anger du dem i dwControlBarStyle.

CBasePane::D ockPane

Dockar ett fönster till ett annat fönster eller till ett ramfönster.

virtual BOOL DockPane(
    CBasePane* pDockBar,
    LPCRECT lpRect,
    AFX_DOCK_METHOD dockMethod);

Parameterar

pDockBar
[i] En pekare till ett annat fönster.

lpRect
[i] Anger målrektangeln.

dockMethod
[i] Anger dockningsmetoden.

Returvärde

SANT om kontrollfältet har dockats. annars FALSKT.

Anmärkningar

Anropa den här funktionen för att docka ett fönster till ett annat fönster eller ett dockningsfält (CDockSite-klass) som anges av pDockBar eller till en huvudram om pDockBar är NULL.

dockMethod anger hur fönstret dockas. En lista över möjliga värden finns i CPane::D ockPane .

CBasePane::D ockPaneUsingRTTI

Dockar fönstret med hjälp av information om körningstyp.

void DockPaneUsingRTTI(BOOL bUseDockSite);

Parameterar

bUseDockSite
[i] Om det är SANT dockar du till dockningsplatsen. Om det är FALSKT dockar du till den överordnade ramen.

CBasePane::D ockToFrameWindow

Dockar ett dockbart fönster till en ram.

virtual BOOL DockToFrameWindow(
    DWORD dwAlignment,
    LPCRECT lpRect = NULL,
    DWORD dwDockFlags = DT_DOCK_LAST,
    CBasePane* pRelativeBar = NULL,
    int nRelativeIndex = -1,
    BOOL bOuterEdge = FALSE);

Parameterar

dwAlignment
[i] Den sida av den överordnade ramen som du vill docka fönstret till.

lpRect
[i] Önskad storlek.

dwDockFlags
[i] Ignoreras.

pRelativeBar
[i] Ignoreras.

nRelativeIndex
[i] Ignoreras.

bOuterEdge
[i] Om TRUE och det finns andra dockbara fönster på sidan som anges av dwAlignment, dockas fönstret utanför de andra fönstren, närmare kanten på den överordnade ramen. Om det är FALSKT dockas fönstret närmare mitten av klientområdet.

Returvärde

TRUE om metoden lyckades. annars FALSKT.

Anmärkningar

Den här metoden misslyckas om det inte går att skapa en fönsteravdelare ( CPaneDivider-klass). Annars returnerar den alltid TRUE.

CBasePane::D oesAllowDynInsertBefore

Avgör om ett annat fönster kan infogas dynamiskt mellan det här fönstret och den överordnade ramen.

virtual BOOL DoesAllowDynInsertBefore() const;

Returvärde

SANT om en användare kan infoga ett annat fönster. annars FALSKT.

Anmärkningar

Ramverket anropar den här metoden för att avgöra om en användare dynamiskt kan infoga ett fönster före det här fönstret.

Anta till exempel att ditt program skapar ett fönster som dockas till vänster i ramen (till exempel Outlook-fältet). Om du vill förhindra att användaren dockar ett annat fönster till vänster om det första fönstret, åsidosätter du den här metoden och returnerar FALSE.

Vi rekommenderar att du åsidosätter den här metoden och returnerar FALSE för icke-flytande fönster som härletts från CDockablePane-klassen.

Standardimplementeringen returnerar TRUE.

CBasePane::D oPaint

Fyller bakgrunden i fönstret.

virtual void DoPaint(CDC* pDC);

Parameterar

pDC-
[i] En pekare till en enhetskontext.

Anmärkningar

Standardimplementeringen anropar den aktuella visualiseringshanteraren för att fylla bakgrunden ( CMFCVisualManager::OnFillBarBackground).

CBasePane::EnableDocking

Aktiverar dockning av fönstret till huvudramen.

virtual void EnableDocking(DWORD dwAlignment);

Parameterar

dwAlignment
[i] Anger den dockningsjustering som ska aktiveras.

Anmärkningar

Anropa den här metoden för att aktivera dockningsjustering till huvudramen. Du kan skicka en kombination av CBRS_ALIGN_ flaggor (mer information finns i CControlBar::EnableDocking).

EnableDocking anger den interna flaggan CBasePane::m_dwEnabledAlignment och ramverket kontrollerar den här flaggan när ett fönster är dockat.

Anropa CBasePane::GetEnabledAlignment för att fastställa dockningsjusteringen för ett fönster.

CBasePane::EnableGripper

Aktiverar eller inaktiverar griparen. Om griparen är aktiverad kan användaren dra den för att flytta fönstret.

virtual void EnableGripper(BOOL bEnable);

Parameterar

bEnable
[i] TRUE för att aktivera griparen; FALSE för att inaktivera den.

Anmärkningar

Ramverket använder den här metoden för att aktivera en gripare i stället för att använda WS_CAPTION formatmall.

CBasePane::FloatPane

Flyter fönstret.

virtual BOOL FloatPane(
    CRect rectFloat,
    AFX_DOCK_METHOD dockMethod=DM_UNKNOWN,
    bool bShow=true);

Parameterar

rectFloat
[i] Anger de skärmkoordinater där det flytande fönstret visas.

dockMethod
[i] Anger dockningsmetoden som ska användas för att flytta fönstret.

bShow
[i] Anger om det flytande fönstret är synligt (TRUE) eller dolt (FALSE).

Returvärde

SANT om fönstret har flytats; annars FALSKT.

Anmärkningar

Anropa den här metoden för att flytta ett fönster i den skärmposition som anges av rectFloat.

CBasePane::get_accHelpTopic

Ramverket anropar den här metoden för att hämta den fullständiga sökvägen till WinHelp-filen som är associerad med det angivna objektet och identifieraren för lämpligt ämne i filen.

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

Parameterar

pszHelpFile
[i] Adress för en BSTR som tar emot den fullständiga sökvägen till WinHelp-filen som är associerad med det angivna objektet, om någon.

varChild
[i] Anger om hjälpavsnittet som ska hämtas är objektets eller något av objektens underordnade element. Den här parametern kan vara antingen CHILDID_SELF (för att hämta ett hjälpavsnitt för objektet) eller ett underordnat ID (för att hämta ett hjälpavsnitt för ett av objektens underordnade element).

pidTopic
[i] Identifierar hjälpfilavsnittet som är associerat med det angivna objektet.

Returvärde

CBasePane implementerar inte den här metoden. Därför CBasePane::get_accHelpTopic returnerar alltid S_FALSE.

Anmärkningar

Den här funktionen är en del av stöd för aktiv tillgänglighet i MFC. Åsidosätt den här funktionen i en härledd klass för att ge hjälpinformation om ditt objekt.

CBasePane::get_accSelection

Ramverket anropar den här metoden för att hämta de markerade underordnade objekten.

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parameterar

pvarChildren
[i] Tar emot information som identifierar de markerade underordnade objekten.

Returvärde

CBasePane implementerar inte den här metoden. Om pvarChildren är NULL returnerar den här metoden E_INVALIDARG. Annars returnerar den här metoden DISP_E_MEMBERNOTFOUND.

Anmärkningar

Den här funktionen är en del av stöd för aktiv tillgänglighet i MFC. Åsidosätt den här funktionen i en härledd klass om du har andra användargränssnittselement än fönsterlösa ActiveX-kontroller.

CBasePane::GetCaptionHeight

Returnerar bildtextens höjd.

virtual int GetCaptionHeight() const;

Returvärde

Bildtextens höjd.

CBasePane::GetControlBarStyle

Returnerar kontrollfältets formatmall.

virtual DWORD GetControlBarStyle() const

Returvärde

En bitvis ELLER kombination av AFX_CBRS_ flaggor.

Anmärkningar

Returvärdet är en kombination av följande möjliga värden.

Stil Beskrivning
AFX_CBRS_FLOAT Gör att kontrollfältet flyter.
AFX_CBRS_AUTOHIDE Aktiverar läget dölj automatiskt.
AFX_CBRS_RESIZE Aktiverar storleksändring av kontrollfältet. När den här flaggan har angetts kan kontrollfältet placeras i ett dockbart fönster.
AFX_CBRS_CLOSE Aktiverar döljande av kontrollfältet.

CBasePane::GetCurrentAlignment

Returnerar den aktuella fönsterjusteringen.

virtual DWORD GetCurrentAlignment() const;

Returvärde

Den aktuella justeringen av kontrollfältet. Följande tabell visar möjliga värden:

Värde Justering
CBRS_ALIGN_LEFT Vänsterjustering.
CBRS_ALIGN_RIGHT Högerjustering.
CBRS_ALIGN_TOP Övre justering.
CBRS_ALIGN_BOTTOM Nederkantsjustering.

CBasePane::GetDockingMode

Returnerar det aktuella dockningsläget för fönstret.

virtual AFX_DOCK_TYPE GetDockingMode() const;

Returvärde

DT_STANDARD om dra fönstret visas på skärmen med en dra-rektangel. DT_IMMEDIATE om innehållet i fönstret dras.

Anmärkningar

Ramverket anropar den här metoden för att fastställa det aktuella dockningsläget i fönstret.

Om CBasePane::m_dockMode är odefinierat (DT_UNDEFINED) tas dockningsläget från det globala dockningsläget (AFX_GLOBAL_DATA::m_dockModeGlobal).

Genom att ange m_dockMode eller åsidosätta GetDockingMode kan du styra dockningsläget för varje fönster.

CBasePane::GetDockSiteFrameWnd

Returnerar en pekare till CDockingPanesRow-objektet där fönstret är dockat.

virtual CWnd* GetDockSiteFrameWnd() const;

Returvärde

En pekare till dockningsplatsen i fönstret.

Anmärkningar

Anropa den här metoden för att hämta en pekare till dockningsplatsen i fönstret. Dockningsplatsen kan antingen vara ett huvudramfönster om fönstret är dockat till huvudramen eller ett miniramfönster om fönstret svävar.

CBasePane::GetEnabledAlignment

Returnerar de CBRS_ALIGN_ formatmallar som används i fönstret.

virtual DWORD GetEnabledAlignment() const;

Returvärde

En kombination av CBRS_ALIGN_ formatmallar. Följande tabell visar möjliga format:

Flagga Aktiverad justering
CBRS_ALIGN_LEFT Vänster.
CBRS_ALIGN_RIGHT Höger.
CBRS_ALIGN_TOP Topp.
CBRS_ALIGN_BOTTOM Botten.
CBRS_ALIGN_ANY Kombination av alla flaggor.

Anmärkningar

Anropa den här metoden för att fastställa den aktiverade justeringen för fönstret. Aktiverad justering innebär att sidorna i huvudramfönstret som ett fönster kan dockas till.

Aktivera dockningsjustering med hjälp av CBasePane::EnableDocking.

CBasePane::GetMFCStyle

Returnerar de fönsterformat som är specifika för MFC.

virtual DWORD GetMFCStyle() const;

Returvärde

En kombination av biblioteksspecifika (AFX_CBRS_) fönsterformat.

CBasePane::GetPaneIcon

Returnerar ett handtag till fönsterikonen.

virtual HICON GetPaneIcon(BOOL bBigIcon);

Parameterar

bBigIcon
[i] Anger en ikon på 32 x 32 bildpunkter om TRUE. anger en ikon på 16 x 16 bildpunkter om FALSE.

Returvärde

Ett handtag till fönsterikonen. Om det inte lyckas returneras NULL.

Anmärkningar

Standardimplementeringen anropar CWnd::GetIcon.

CBasePane::GetPaneRow

Returnerar en pekare till CDockingPanesRow-objektet där fönstret är dockat.

CDockingPanesRow* GetPaneRow();

Returvärde

En pekare till CDockingPanesRow om fönstret är dockat eller NULL om det svävar.

Anmärkningar

Anropa den här metoden för att komma åt raden där ett fönster är dockat. Om du till exempel vill ordna fönsterrutorna på en viss rad anropar GetPaneRow du och anropar sedan CDockingPanesRow::ArrangePanes.

CBasePane::GetPaneStyle

Returnerar fönsterformatet.

virtual DWORD GetPaneStyle() const;

Returvärde

En kombination av kontrollstapelformat (inklusive CBRS_ formatmallar) som angavs av metoden CBasePane::SetPaneStyle när den skapades.

CBasePane::GetParentDockSite

Returnerar en pekare till den överordnade dockningsplatsen.

virtual CDockSite* GetParentDockSite() const;

Returvärde

Den överordnade dockningsplatsen.

CBasePane::GetParentMiniFrame

Returnerar en pekare till det överordnade miniramsfönstret.

virtual CPaneFrameWnd* GetParentMiniFrame(BOOL bNoAssert=FALSE) const;

Parameterar

bNoAssert
[i] Om SANT söker den här metoden inte efter ogiltiga pekare. Om du anropar den här metoden när programmet avslutas anger du den här parametern till TRUE.

Returvärde

En giltig pekare till det överordnade miniramfönstret om fönstret är flytande. annars NULL.

Anmärkningar

Anropa den här funktionen för att hämta en pekare till det överordnade miniramfönstret. Den här metoden itererar genom alla överordnade objekt och söker efter ett objekt som härletts från CPaneFrameWnd-klassen.

Använd GetParentMiniFrame för att avgöra om fönstret är flytande.

CBasePane::GetParentTabbedPane

Returnerar en pekare till det överordnade fönstret med flikar.

CBaseTabbedPane* GetParentTabbedPane() const;

Returvärde

En pekare till det överordnade fönstret med flikar om den finns. annars NULL.

CBasePane::GetParentTabWnd

Returnerar en pekare till det överordnade fönstret som finns inuti en flik.

CMFCBaseTabCtrl* GetParentTabWnd(HWND& hWndTab) const;

Parameterar

hWndTab
[ut] Om returvärdet inte är NULL innehåller den här parametern referensen till det överordnade fönstret med flikar.

Returvärde

En giltig pekare till det överordnade fönstret eller NULL.

Anmärkningar

Använd den här funktionen för att hämta en pekare till det överordnade fönstret med flikar. Ibland räcker det inte att anropa GetParent, eftersom en ruta kan finnas i en dockningsslutning ( CDockablePaneAdapter-klass) eller inuti en fönsteradapter ( CDockablePaneAdapter-klass). Genom att använda GetParentTabWnd kan du hämta en giltig pekare i dessa fall (förutsatt att den överordnade är ett fönster med flikar).

CBasePane::GetRecentVisibleState

Ramverket anropar den här metoden när ett fönster återställs från ett arkiv.

virtual BOOL GetRecentVisibleState() const;

Returvärde

En BOOL som anger det senaste synliga tillståndet. Om SANT var fönstret synligt när det serialiserades och bör vara synligt när det återställs. Om det är FALSKT var fönstret dolt när det serialiserades och bör döljas när det återställs.

CBasePane::HideInPrintPreviewMode

Anger om fönstret är dolt i förhandsgranskningen.

virtual BOOL HideInPrintPreviewMode() const;

Returvärde

SANT om fönstret inte visas i förhandsgranskningen. annars FALSKT.

Anmärkningar

Basfönster visas inte i förhandsgranskningen. Därför returnerar den här metoden alltid TRUE.

CBasePane::InsertPane

Registrerar det angivna fönstret med dockningshanteraren.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter = TRUE);

Parameterar

pControlBar
[i] En pekare till fönstret som ska infogas.

pTarget
[i] En pekare till det intilliggande fönstret.

bAfter
[i] Om true infogas pControlBar efter pTarget. Om false infogas pControlBar innan pTarget.

Returvärde

SANT om metoden lyckas, ANNARS FALSE.

CBasePane::IsAccessibilityCompatible

Anger om fönstret stöder aktiv tillgänglighet.

virtual BOOL IsAccessibilityCompatible();

Returvärde

SANT om fönstret har stöd för aktiv hjälpmedel; annars FALSKT.

CBasePane::IsAutoHideMode

Avgör om ett fönster är i automatiskt döljläge.

virtual BOOL IsAutoHideMode() const;

Returvärde

SANT om fönstret är i läget dölj automatiskt. annars FALSKT.

Anmärkningar

Basfönster kan inte döljas automatiskt. Den här metoden returnerar alltid FALSE.

CBasePane::IsDialogControl

Anger om fönstret är en dialogrutekontroll.

BOOL IsDialogControl() const;

Returvärde

SANT om fönstret är en dialogrutekontroll. annars FALSKT.

Anmärkningar

Ramverket använder den här metoden för att säkerställa layoutkonsekvens för alla fönster.

CBasePane::IsDocked

Avgör om fönstret är dockat.

virtual BOOL IsDocked() const;

Returvärde

SANT om det överordnade fönstret inte är en miniram eller om fönstret svävar i en miniram med en annan ruta. annars FALSKT.

CBasePane::IsFloating

Avgör om fönstret är flytande.

virtual BOOL IsFloating() const;

Returvärde

SANT om fönstret är flytande; annars FALSKT.

Anmärkningar

Den här metoden returnerar det motsatta värdet för CBasePane::IsDocked.

CBasePane::IsHorizontal

Avgör om fönstret är dockat vågrätt.

virtual BOOL IsHorizontal() const;

Returvärde

SANT om fönstret är dockat vågrätt. annars FALSKT.

Anmärkningar

Standardimplementeringen kontrollerar den aktuella dockningsjusteringen för CBRS_ORIENT_HORZ.

CBasePane::IsInFloatingMultiPaneFrameWnd

Anger om fönstret finns i ett ramfönster med flera fönster ( CMultiPaneFrameWnd-klass).

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Returvärde

SANT om fönstret finns i ett ramfönster med flera fönster. annars FALSKT.

Anmärkningar

Endast dockbara fönster kan flyta i ett ramfönster med flera fönster. Därför CBasePane::IsInFloatingMultiPaneFrameWnd returnerar alltid FALSE.

CBasePane::IsMDITabbed

Avgör om fönstret har lagts till i ett underordnat MDI-fönster som ett tabbdokument.

virtual BOOL IsMDITabbed() const;

Returvärde

SANT om fönstret har lagts till i ett underordnat MDI-fönster som ett tabbdokument. annars FALSKT.

CBasePane::IsPaneVisible

Anger om flaggan WS_VISIBLE har angetts för fönstret.

BOOL IsPaneVisible() const;

Returvärde

SANT om WS_VISIBLE har angetts. annars FALSKT.

Anmärkningar

Använd CBasePane::IsVisible för att fastställa fönstrets synlighet.

CBasePane::IsPointNearDockSite

Avgör om en angiven punkt ligger nära dockningsplatsen.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Parameterar

punkt
[i] Den angivna punkten.

dwBarAlignment
[ut] Anger vilken kant punkten är nära. Möjliga värden är CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP och CBRS_ALIGN_BOTTOM

bOuterEdge
[ut] SANT om punkten ligger nära den yttre kantlinjen för dockningsplatsen. ANNARS FALSKT.

Returvärde

SANT om punkten ligger nära dockningsplatsen. annars FALSKT.

Anmärkningar

Punkten ligger nära dockningsplatsen när den ligger inom känslighetsuppsättningen i dockningshanteraren. Standardkänsligheten är 15 bildpunkter.

CBasePane::IsResizable

Avgör om fönstret kan ändras.

virtual BOOL IsResizable() const;

Returvärde

SANT om fönstret kan ändras av användaren. annars FALSKT.

Anmärkningar

Fönster i CDockablePane-klassen kan ändras.

Det går inte att ändra storlek på statusfältet ( CMFCStatusBar-klassen) och dockningsfältet ( CDockSite-klass).

CBasePane::IsRestoredFromRegistry

Avgör om fönstret återställs från registret.

virtual BOOL IsRestoredFromRegistry() const;

Returvärde

SANT om fönstret återställs från registret. annars FALSKT.

CBasePane::IsTabbed

Avgör om fönstret har infogats i tabbkontrollen i ett fönster med flikar.

virtual BOOL IsTabbed() const;

Returvärde

SANT om kontrollfältet infogas på en flik i ett fönster med flikar. annars FALSKT.

Anmärkningar

Den här metoden hämtar en pekare till den omedelbara överordnade och avgör om den överordnade körningsklassen är CMFCBaseTabCtrl-klass.

CBasePane::IsVisible

Avgör om fönstret är synligt.

virtual BOOL IsVisible() const;

Returvärde

SANT om fönstret är synligt. annars FALSKT.

Anmärkningar

Använd den här metoden för att fastställa synligheten för ett fönster. Använd inte ::IsWindowVisible.

Om fönstret inte är flikar (se CBasePane::IsTabbed) söker den här metoden efter formatet WS_VISIBLE. Om fönstret är tabbat kontrollerar den här metoden synligheten för det överordnade fönstret med flikar. Om det överordnade fönstret är synligt kontrollerar funktionen synligheten för fliken i fönstret med hjälp av CMFCBaseTabCtrl::IsTabVisible.

CBasePane::LoadState

Läser in fönstrets tillstånd från registret.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parameterar

lpszProfileName
[i] Profilnamn.

nIndex
[i] Profilindex.

uiID
[i] Fönster-ID.

Returvärde

SANT om fönstrets tillstånd har lästs in. annars FALSKT.

Anmärkningar

Ramverket anropar den här metoden för att läsa in fönstrets tillstånd från registret. Åsidosätt den i en härledd klass för att läsa in ytterligare information som sparats av CBasePane::SaveState.

CBasePane::MoveWindow

Flyttar fönstret.

virtual HDWP MoveWindow(
    CRect& rect,
    BOOL bRepaint = TRUE,
    HDWP hdwp = NULL);

Parameterar

rekt
[i] En rektangel som anger den nya platsen och storleken på fönstret.

bRepaint
[i] Om TRUE är fönstret ommålat. Om det är FALSKT är fönstret inte ommålat.

hdwp
[i] Hantera till en uppskjuten fönsterpositionsstruktur.

Returvärde

Ett handtag till en uppskjuten fönsterpositionsstruktur eller NULL.

Anmärkningar

Om du skickar NULL som hdwp-parameter flyttar den här metoden fönstret normalt. Om du skickar ett handtag utför den här metoden en uppskjuten fönsterflytt. Du kan hämta en referens genom att anropa BeginDeferWindowPos eller genom att lagra returvärdet för ett tidigare anrop till den här metoden.

CBasePane::OnAfterChangeParent

Anropas av ramverket efter att fönstrets överordnade ändringar har ändrats.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

Parameterar

pWndOldParent
[i] En pekare till föregående överordnade.

Anmärkningar

Ramverket anropar den här metoden efter att fönstrets överordnade ändringar, vanligtvis på grund av en docknings- eller flytande åtgärd.

Standardimplementeringen gör ingenting.

CBasePane::OnBeforeChangeParent

Anropas av ramverket precis innan fönstret ändrar sitt överordnade fönster.

virtual void OnBeforeChangeParent(
    CWnd* pWndNewParent,
    BOOL bDelay=FALSE);

Parameterar

pWndNewParent
[i] En pekare till ett nytt överordnat fönster.

bDelay
[i] Anger om layoutjusteringar måste fördröjas.

Anmärkningar

Ramverket anropar den här metoden precis innan fönstrets överordnade ändringar, vanligtvis på grund av en docknings-, flytande- eller automatisk dölj-åtgärd.

Standardimplementeringen gör ingenting.

CBasePane::OnDrawCaption

Ramverket anropar den här metoden när bildtexten ritas.

virtual void OnDrawCaption();

Anmärkningar

Den här metoden har inga funktioner för CBasePane klassen.

CBasePane::OnMovePaneDivider

Den här metoden används för närvarande inte.

virtual void OnMovePaneDivider(CPaneDivider* /* unused */);

Parameterar

oanvänd
[i] Används inte.

CBasePane::OnPaneContextMenu

Anropas av ramverket när det skapar en meny som har en lista över fönster.

virtual void OnPaneContextMenu(
    CWnd* pParentFrame,
    CPoint point);

Parameterar

pParentFrame
[i] En pekare till den överordnade ramen.

punkt
[i] Anger platsen för snabbmenyn.

Anmärkningar

OnPaneContextMenu anropar dockningshanteraren, som underhåller listan över fönster som tillhör det aktuella ramfönstret. Den här metoden lägger till namnen på fönstren i en snabbmeny och visar den. Kommandona på menyn visar eller döljer enskilda fönster.

Åsidosätt den här metoden för att anpassa det här beteendet.

CBasePane::OnRemoveFromMiniFrame

Anropas av ramverket när ett fönster tas bort från dess överordnade miniramfönster.

virtual void OnRemoveFromMiniFrame(CPaneFrameWnd* pMiniFrame);

Parameterar

pMiniFrame
[i] En pekare till ett miniramfönster som fönstret tas bort från.

Anmärkningar

Ramverket anropar den här metoden när ett fönster tas bort från dess överordnade miniramfönster (till exempel som ett resultat av dockning).

Standardimplementeringen gör ingenting.

CBasePane::OnSetAccData

CBasePane använder inte den här metoden.

virtual BOOL OnSetAccData(long lVal);

Parameterar

lVal
[i] Används inte.

Returvärde

Den här metoden returnerar alltid TRUE.

Anmärkningar

CBasePane::P aneFromPoint

Returnerar fönstret som innehåller den angivna punkten.

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar = false,
    CRuntimeClass* pRTCBarType = NULL) const;

Parameterar

punkt
[i] Anger den punkt i skärmkoordinater som ska kontrolleras.

nKänslighet
[i] Öka sökområdet med den här mängden. Ett fönster uppfyller sökvillkoren om den angivna punkten faller i det ökade området.

bExactBar
[i] TRUE för att ignorera parametern nSensitivity; annars FALSKT.

pRTCBarType
[i] Om inte NULL söker metoden bara i fönster av den angivna typen.

Returvärde

- CBasePanederived-objektet som innehåller den angivna punkten eller NULL om inget fönster hittades.

CBasePane::RecalcLayout

CBasePane använder inte den här metoden.

virtual void RecalcLayout();

CBasePane::RemovePaneFromDockManager

Avregistrerar ett fönster och tar bort det från listan i dockningshanteraren.

void RemovePaneFromDockManager(
    CBasePane* pBar,
    BOOL bDestroy = TRUE,
    BOOL bAdjustLayout = FALSE,
    BOOL bAutoHide = FALSE,
    CBasePane* pBarReplacement = NULL);

Parameterar

pBar
[i] En pekare till ett fönster som ska tas bort.

bDestroy
[i] Om DET är SANT förstörs det borttagna fönstret.

bAdjustLayout
[i] Om det är SANT justerar du dockningslayouten omedelbart.

bAutoHide
[i] Om TRUE är dockningslayouten relaterad till listan över autohide-staplar. Om false är dockningslayouten relaterad till listan över vanliga fönster.

pBarReplacement
[i] En pekare till ett fönster som ersätter det borttagna fönstret.

CBasePane::SaveState

Sparar fönstrets tillstånd i registret.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parameterar

lpszProfileName
[i] Profilnamn.

nIndex
[i] Profilindex.

uiID
[i] Fönster-ID.

Returvärde

SANT om tillståndet har sparats. annars FALSKT.

Anmärkningar

Ramverket anropar den här metoden när den sparar fönstrets tillstånd i registret. Åsidosätt SaveState i en härledd klass för att lagra ytterligare information.

CBasePane::SelectDefaultFont

Väljer standardteckensnittet för en viss enhetskontext.

CFont* SelectDefaultFont(CDC* pDC);

Parameterar

pDC-
[i] En enhetskontext.

Returvärde

En pekare till CFont-standardklassobjektet .

CBasePane::SetControlBarStyle

Anger kontrollfältets formatmall.

virtual void SetControlBarStyle(DWORD dwNewStyle);

Parameterar

dwNewStyle
[i] En bitvis-OR-kombination av följande möjliga värden.

Stil Beskrivning
AFX_CBRS_FLOAT Gör att kontrollfältet flyter.
AFX_CBRS_AUTOHIDE Aktiverar läget dölj automatiskt.
AFX_CBRS_RESIZE Aktiverar storleksändring av kontrollfältet. När den här flaggan har angetts kan kontrollfältet placeras i ett dockbart fönster.
AFX_CBRS_CLOSE Aktiverar döljande av kontrollfältet.

CBasePane::SetDockingMode

Anger dockningsläget för fönstret.

void SetDockingMode(AFX_DOCK_TYPE dockModeNew);

Parameterar

dockModeNy
[i] Anger det nya dockningsläget för fönstret.

Anmärkningar

Ramverket stöder två dockningslägen: standard och omedelbart.

I standard dockningsläget flyttas fönster och miniramfönster runt med hjälp av en dra-rektangel. I omedelbart dockningsläge flyttas kontrollstaplar och miniramfönster omedelbart med sin kontext.

Till en början definieras dockningsläget globalt av CDockingManager::m_dockModeGlobal. Du kan ange dockningsläget för varje fönster individuellt med hjälp av SetDockingMode metoden .

CBasePane::SetPaneAlignment

Anger justeringen för fönstret.

virtual void SetPaneAlignment(DWORD dwAlignment);

Parameterar

dwAlignment
[i] Anger den nya justeringen.

Anmärkningar

Vanligtvis anropar ramverket den här metoden när ett fönster dockas från ena sidan av huvudramen till en annan.

I följande tabell visas möjliga värden för dwAlignment:

Värde Justering
CBRS_ALIGN_LEFT Vänsterjustering.
CBRS_ALIGN_RIGHT Högerjustering.
CBRS_ALIGN_TOP Övre justering.
CBRS_ALIGN_BOTTOM Nederkantsjustering.

CBasePane::SetPaneStyle

Anger formatet för fönstret.

virtual void SetPaneStyle(DWORD dwNewStyle);

Parameterar

dwNewStyle
[i] Anger det nya formatmall som ska anges.

Anmärkningar

Den här metoden kan användas för att ange någon av de CBRS_ formatmallar som definieras i afxres.h. Eftersom fönsterformat och fönsterjustering lagras tillsammans anger du det nya formatet genom att kombinera det med den aktuella justeringen enligt följande.

pPane->SetPaneStyle (pPane->GetCurrentAlignment() | CBRS_TOOLTIPS);

CBasePane::SetWindowPos

Ändrar storlek, position och Z-ordning för ett fönster.

virtual HDWP SetWindowPos(
    const CWnd* pWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT nFlags,
    HDWP hdwp = NULL);

Parameterar

pWndInsertAfter
[i] Identifierar det CWnd objekt som kommer före det här CWnd objektet i Z-ordningen. Mer information finns i CWnd::SetWindowPos.

x
[i] Anger positionen för den vänstra sidan av fönstret.

y
[i] Anger positionen överst i fönstret.

cx
[i] Anger fönstrets bredd.

Cy
[i] Anger fönstrets höjd.

nFlags
[i] Anger storleks- och positionsalternativ. Mer information finns i CWnd::SetWindowPos.

hdwp
[i] Hantera till en struktur som innehåller storleks- och positionsinformation för ett eller flera fönster.

Returvärde

Ett handtag till en uppdaterad uppskjuten fönsterpositionsstruktur eller NULL.

Anmärkningar

Om pWndInsertAfter är NULL anropar den här metoden CWnd::SetWindowPos. Om pWndInsertAfter inte är NULL anropar DeferWindowPosden här metoden .

CBasePane::ShowPane

Visar eller döljer fönstret.

virtual void ShowPane(
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parameterar

bShow
[i] Anger om du vill visa (TRUE) eller dölja (FALSE) ett fönster.

bDelay
[i] Om TRUE är omberäkning av dockningslayouten fördröjd.

bActivate
[i] Om SANT är fönstret aktivt när det visas.

Anmärkningar

Den här metoden visar eller döljer ett fönster. Använd den här metoden i stället för ShowWindow eftersom den här metoden meddelar relevanta dockningshanterare om ändringar i fönstrets synlighet.

Använd CBasePane::IsVisible för att fastställa den aktuella synligheten för ett fönster.

CBasePane::StretchPane

Sträcker ut en ruta lodrätt eller vågrätt.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parameterar

nLängd
[i] Längden som fönstret ska sträckas ut med.

bVert
[i] Om det är SANT sträcker du ut fönstret lodrätt. Om det är FALSKT sträcker du ut fönstret vågrätt.

Returvärde

Storleken på det utsträckta fönstret.

CBasePane::UndockPane

Tar bort fönstret från dockningsplatsen, standardreglaget eller miniramsfönstret där det för närvarande är dockat.

virtual void UndockPane(BOOL bDelay=FALSE);

Parameterar

bDelay
Om det är SANT beräknas inte dockningslayouten omedelbart.

Anmärkningar

Anropa den här metoden för att ändra fönstrets tillstånd eller exkludera fönstret från dockningslayouten.

Om du vill fortsätta att använda det här fönstret anropar du antingen CBasePane::D ockPane eller CBasePane::FloatPane innan du anropar den här metoden.

Se även

hierarkidiagram
klasser
CPane
CWnd-klass

  • Last updated on