Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
Implementeert de functionaliteit van een deelvenster met losgekoppelde tabbladen.
of meer informatie over de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie.
Syntaxis
class CTabbedPane : public CBaseTabbedPane
Leden
Openbare constructors
| Naam | Description |
|---|---|
CTabbedPane::CTabbedPane |
Standaardconstructor. |
Openbare methoden
| Naam | Description |
|---|---|
| CTabbedPane::D etachPane | (Overschrijft CBaseTabbedPane::D etachPane.) |
| CTabbedPane::EnableTabAutoColor | Hiermee schakelt u automatische kleuring van tabbladen in of uit. |
| CTabbedPane::FloatTab | Hiermee wordt een deelvenster zwevend, maar alleen als het deelvenster zich momenteel op een loskoppelbaar tabblad bevindt. (Overschrijft CBaseTabbedPane::FloatTab.) |
| CTabbedPane::GetTabArea | Retourneert de grootte en positie van het tabbladgebied in het venster met tabbladen. |
| CTabbedPane::GetTabWnd | |
| CTabbedPane::HasAutoHideMode | Bepaalt of het deelvenster met tabbladen kan worden overgeschakeld naar de modus Automatisch zichtbaar maken. (Overschrijft CBaseTabbedPane::HasAutoHideMode.) |
| CTabbedPane::IsTabLocationBottom | Bepaalt of de tabbladen zich onder aan het venster bevinden. |
| CTabbedPane::ResetTabs | Hiermee stelt u alle deelvensters met tabbladen opnieuw in op de standaardstatus. |
| CTabbedPane::SetTabAutoColors | Hiermee stelt u een lijst met aangepaste kleuren in die kunnen worden gebruikt wanneer de functie voor automatische kleuren is ingeschakeld. |
Gegevensleden
| Naam | Description |
|---|---|
| CTabbedPane::m_bTabsAlwaysTop | De standaardlocatie voor tabbladen in de toepassing. |
| CTabbedPane::m_pTabWndRTC | Runtimeklasse-informatie voor een aangepast CMFCTabCtrl-afgeleide object. |
Opmerkingen
In het framework wordt automatisch een exemplaar van deze klasse gemaakt wanneer een gebruiker een deelvenster aan een ander deelvenster koppelt door het bijschrift van het tweede deelvenster aan te wijzen. Alle deelvensters met tabbladen die door het framework worden gemaakt, hebben een id van -1.
Als u gewone tabbladen wilt opgeven in plaats van tabbladen in Outlook-stijl, geeft u de AFX_CBRS_REGULAR_TABS stijl door aan de methode CDockablePane::CreateEx .
Als u een deelvenster met tabbladen met loskoppelbare tabbladen maakt, wordt het deelvenster mogelijk automatisch vernietigd door het framework, zodat u de aanwijzer niet hoeft op te slaan. Als u een aanwijzer naar het deelvenster met tabbladen wilt krijgen, roept u de CBasePane::GetParentTabbedPane methode aan.
Voorbeelden
In dit voorbeeld maken we een CTabbedPane object. Vervolgens gebruiken we CBaseTabbedPane::AddTab om extra tabbladen toe te voegen.
CTabbedPane* pTabbededBar = new CTabbedPane (TRUE);
if (!pTabbededBar->Create (_T(""),
this,
CRect (0,
0,
200,
200),
TRUE,
(UINT) -1,
WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS |
WS_CLIPCHILDREN | CBRS_LEFT |
CBRS_FLOAT_MULTI))
{
TRACE0("Failed to create Solution Explorer bar\n");
return FALSE; // fail to create
}
pTabbededBar->AddTab (&m_wndClassView);
pTabbededBar->AddTab (&m_wndResourceView);
pTabbededBar->AddTab (&m_wndFileView);
pTabbededBar->EnableDocking(CBRS_ALIGN_ANY);
DockPane(pTabbededBar);
Een andere manier om een besturingselementbalkobject met tabbladen te maken, is door CDockablePane::AttachToTabWnd te gebruiken. Met de AttachToTabWnd methode wordt dynamisch een deelvensterobject met tabbladen gemaakt met behulp van runtimeklassegegevens die zijn ingesteld door CDockablePane::SetTabbedPaneRTC.
In dit voorbeeld maken we dynamisch een deelvenster met tabbladen, voegen we twee tabbladen toe en maken we het tweede tabblad niet loskoppelbaar.
DockPane(&m_wndClassView);
CTabbedPane* pTabbedBar = NULL;
m_wndResourceView.AttachToTabWnd (&m_wndClassView,
DM_SHOW,
TRUE,
(CDockablePane**) &pTabbedBar);
m_wndFileView.AttachToTabWnd (pTabbedBar,
DM_SHOW,
TRUE,
(CDockablePane**) &pTabbedBar);
pTabbedBar->GetUnderlyingWindow ()->EnableTabDetach (1,
FALSE);
Overnamehiërarchie
Requirements
Koptekst: afxTabbedPane.h
CTabbedPane::D etachPane
virtual BOOL DetachPane(
CWnd* pBar,
BOOL bHide = FALSE);
Parameterwaarden
[in] pBar
[in] bHide
Retourwaarde
Opmerkingen
CTabbedPane::EnableTabAutoColor
Hiermee schakelt u automatische kleuring van tabbladen in of uit.
static void EnableTabAutoColor(BOOL bEnable = TRUE);
Parameterwaarden
bEnable
[in] TRUE om automatische kleuring van tabbladen in te schakelen; anders, ONWAAR.
Opmerkingen
Gebruik deze statische methode om automatische kleuring van tabbladen in alle deelvensters met tabbladen in de toepassing in of uit te schakelen. Wanneer deze functie is ingeschakeld, wordt elk tabblad gevuld met een eigen kleur. U vindt de lijst met kleuren die worden gebruikt om de tabbladen te kleuren door de methode CMFCBaseTabCtrl::GetAutoColors aan te roepen.
U kunt de lijst met kleuren opgeven die worden gebruikt voor tabbladen door CTabbedPane::SetTabAutoColors aan te roepen.
Deze optie is standaard uitgeschakeld.
CTabbedPane::FloatTab
virtual BOOL FloatTab(
CWnd* pBar,
int nTabID,
AFX_DOCK_METHOD dockMethod,
BOOL bHide = FALSE);
Parameterwaarden
[in] pBar
[in] nTabID
[in] dockMethod
[in] bHide
Retourwaarde
Opmerkingen
CTabbedPane::GetTabArea
Retourneert de grootte en positie van het tabbladgebied in het venster met tabbladen.
virtual void GetTabArea(
CRect& rectTabAreaTop,
CRect& rectTabAreaBottom) const;
Parameterwaarden
rectTabAreaTop
[uit] Bevat de grootte en positie, in schermcoördinaten, van het bovenste tabbladgebied.
rectTabAreaBottom
[uit] Bevat de grootte en positie, in schermcoördinaten, van het onderste tabbladgebied.
Opmerkingen
In het framework wordt deze methode aangeroepen om te bepalen hoe een deelvenster dat een gebruiker sleept vast te leggen. Wanneer de gebruiker een deelvenster over het tabbladgebied van het doelvenster sleept, probeert het framework het toe te voegen als een nieuw tabblad van het doelvenster. Anders wordt geprobeerd het deelvenster aan de zijkant van het doelvenster te koppelen, waarbij een nieuwe deelvenstercontainer wordt gemaakt met een deelvensterscheidingsteken dat de twee deelvensters scheidt.
Overschrijf deze methode in een CTabbedPane-afgeleide klasse om dit gedrag te wijzigen.
CTabbedPane::GetTabWnd
CMFCTabCtrl* GetTabWnd() const;
Retourwaarde
Opmerkingen
CTabbedPane::HasAutoHideMode
virtual BOOL HasAutoHideMode() const;
Retourwaarde
Opmerkingen
CTabbedPane::IsTabLocationBottom
Bepaalt of de tabbladen zich onder aan het venster bevinden.
virtual BOOL IsTabLocationBottom() const;
Retourwaarde
WAAR als het tabbladgebied zich onder aan het venster met tabbladen bevindt; anders, ONWAAR.
Opmerkingen
CTabbedPane::m_bTabsAlwaysTop
De standaardlocatie voor tabbladen in de toepassing.
AFX_IMPORT_DATA static BOOL m_bTabsAlwaysTop;
Opmerkingen
Stel dit statische lid in op TRUE om af te dwingen dat alle tabbladen in de toepassing boven aan het deelvenster met tabbladen worden weergegeven.
U moet deze waarde instellen voordat een deelvenster met tabbladen is gemaakt.
De standaardwaarde is FALSE.
CTabbedPane::m_pTabWndRTC
Runtimeklasse-informatie voor een aangepast CMFCTabCtrl-afgeleide object.
AFX_IMPORT_DATA static CRuntimeClass* m_pTabWndRTC;
Opmerkingen
Stel deze statische lidvariabele in op een aanwijzer naar de runtimeklassegegevens van een CMFCTabCtrl-afgeleide object als u een aangepast venster met tabbladen in een deelvenster met tabbladen gebruikt.
CTabbedPane::ResetTabs
Hiermee stelt u alle deelvensters met tabbladen opnieuw in op de standaardstatus.
static void ResetTabs();
Opmerkingen
Roep deze methode aan om alle deelvensters met tabbladen terug te zetten naar de standaardstatus. Wanneer deze methode wordt aangeroepen, worden de randgrootten en de automatische kleurstatus van alle deelvensters met tabbladen opnieuw ingesteld.
CTabbedPane::SetTabAutoColors
Hiermee stelt u een lijst met aangepaste kleuren in die worden gebruikt wanneer de functie voor automatische kleuren is ingeschakeld.
static void SetTabAutoColors(const CArray<COLORREF, COLORREF>& arColors);
Parameterwaarden
arColors
[in] Bevat de matrix met kleuren die u wilt instellen.
Opmerkingen
Gebruik deze methode om de lijst met kleuren aan te passen die worden gebruikt wanneer de functie voor automatische kleuren is ingeschakeld. Dit is een statische functie en is van invloed op alle deelvensters met tabbladen in uw toepassing.
Gebruik CTabbedPane::EnableTabAutoColor om de functie voor automatische kleuren in of uit te schakelen.
Zie ook
Hiërarchiegrafiek
Klassen
CDockablePane-klasse
Klasse CBaseTabbedPane
KLASSE CMFCOutlookBar