Share via

CMFCTabCtrl-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De CMFCTabCtrl klasse biedt functionaliteit voor een tabbladbesturing. In het tabbladbesturingselement wordt een bekeerbaar venster met platte of driedimensionale tabbladen boven of onder weergegeven. De tabbladen kunnen tekst en een afbeelding weergeven en de kleur wijzigen wanneer deze actief is.

Syntaxis

class CMFCTabCtrl : public CMFCBaseTabCtrl

Leden

Openbare constructors

Naam Description
CMFCTabCtrl::CMFCTabCtrl Standaardconstructor.
CMFCTabCtrl::~CMFCTabCtrl Destructor.

Openbare methoden

Naam Description
CMFCTabCtrl::ActivateMDITab Hiermee wordt het opgegeven tabblad van het huidige tabblad besturingselement weergegeven en wordt de focus op dat tabblad ingesteld.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow Hiermee geeft u op of het framework het formaat van het clientgebied van alle tabbladbesturingsvensters moet wijzigen wanneer een element van de gebruikersinterface van het tabblad besturingselement wordt gewijzigd.
CMFCTabCtrl::CalcRectEdit Hiermee wordt de grootte van het opgegeven tabbladgebied verkleind. (Onderdrukkingen CMFCBaseTabCtrl::CalcRectEdit).
CMFCTabCtrl::Create Hiermee maakt u het tabblad besturingselement en koppelt u het aan het CMFCTabCtrl object.
CMFCTabCtrl::CreateObject Wordt door het framework gebruikt om een dynamisch exemplaar van dit klassetype te maken.
CMFCTabCtrl::EnableActiveTabCloseButton Hiermee wordt een knop Sluiten ( X) op het actieve tabblad weergegeven of verborgen.
CMFCTabCtrl::EnableInPlaceEdit Hiermee schakelt u bewerkbare tablabels in of uit. (Onderdrukkingen CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenu Hiermee worden twee knoppen vervangen die door de venstertabbladen schuiven door een knop waarmee een menu met vensters met tabbladen wordt geopend.
CMFCTabCtrl::EnsureVisible Zorgt ervoor dat een tabblad zichtbaar is.
CMFCTabCtrl::GetDocumentIcon Hiermee wordt het symbool opgehaald dat is gekoppeld aan een tabblad in een pop-upmenu van vensters met tabbladen.
CMFCTabCtrl::GetFirstVisibleTabNum Haalt de index op van het eerste tabblad dat zichtbaar is in het huidige tabblad.
CMFCTabCtrl::GetResizeMode Hiermee wordt een waarde opgehaald die aangeeft hoe het huidige tabblad besturingselement kan worden gewijzigd.
CMFCTabCtrl::GetScrollBar Hiermee wordt een aanwijzer opgehaald naar het schuifbalkobject dat is gekoppeld aan het tab-besturingselement.
CMFCTabCtrl::GetTabArea Hiermee haalt u de begrenzingsrechthoek van het tabbladlabelgebied boven of onder aan het tab-besturingselement op. (Onderdrukkingen CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPoint Hiermee wordt het tabblad opgehaald dat een opgegeven punt bevat. (Onderdrukkingen CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidth Hiermee wordt de maximale breedte van een tabblad opgehaald.
CMFCTabCtrl::GetTabsHeight Hiermee wordt de hoogte van het tabbladgebied van het huidige tabblad besturingselement opgehaald.
CMFCTabCtrl::GetTabsRect Hiermee wordt een rechthoek opgehaald die het tabbladgebied van het huidige tabblad besturingselement begrenst. (Onderdrukkingen CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClass Wordt door het framework gebruikt om een aanwijzer te verkrijgen naar het CRuntimeClass object dat aan dit klassetype is gekoppeld.
CMFCTabCtrl::GetWndArea Hiermee wordt de grens van het clientgebied van het huidige tabblad besturingselement opgehaald.
CMFCTabCtrl::HideActiveWindowHorzScrollBar Hiermee verbergt u de horizontale schuifbalk, indien aanwezig, van het actieve venster.
CMFCTabCtrl::HideInactiveWindow Hiermee geeft u op of het framework inactieve tabbladvensters moet weergeven.
CMFCTabCtrl::HideNoTabs Hiermee schakelt u het tekenen van het tabbladgebied in of uit als er geen zichtbare tabbladen zijn.
CMFCTabCtrl::HideSingleTab Hiermee schakelt u het tekenen van een tabblad in of uit wanneer er één venster met tabbladen is. (Onderdrukkingen CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroup Geeft aan of het huidige tabblad van een tabblad besturingselement het actieve tabblad is in een groep met tabbladen met meerdere documentinterfaces.
CMFCTabCtrl::IsActiveTabBoldFont Geeft aan of de tekst van het actieve tabblad wordt weergegeven met een vet lettertype.
CMFCTabCtrl::IsActiveTabCloseButton Geeft aan of de knop Sluiten ( X) wordt weergegeven op een actief tabblad of in de rechterbovenhoek van het tabbladgebied.
CMFCTabCtrl::IsDrawFrame Geeft aan of het venster met tabbladen een kaderrechthoek rond ingesloten deelvensters tekent.
CMFCTabCtrl::IsFlatFrame Hiermee wordt aangegeven of het frame rond het tabblad vlak of 3D is.
CMFCTabCtrl::IsFlatTab Hiermee wordt aangegeven of het uiterlijk van de tabbladen in het huidige tabblad besturingselement plat is of niet.
CMFCTabCtrl::IsLeftRightRounded Hiermee wordt aangegeven of het uiterlijk van de linker- en rechterkant van een tabblad in het huidige tab-besturingselement wordt afgerond.
CMFCTabCtrl::IsMDITabGroup Hiermee wordt aangegeven of het huidige tabbladbesturingselement zich in het clientgebied van een venster met een interface met meerdere documenten bevindt.
CMFCTabCtrl::IsOneNoteStyle Geeft aan of het huidige tabblad besturingselement wordt weergegeven in de stijl van Microsoft OneNote.
CMFCTabCtrl::IsPtInTabArea Bepaalt of een punt zich in het tabbladgebied bevindt. (Onderdrukkingen CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScroll Hiermee wordt aangegeven of het huidige tabblad besturingselement een schuifbalk heeft waarmee de tabbladen als groep kunnen worden geschoven.
CMFCTabCtrl::IsTabDocumentsMenu Hiermee wordt aangegeven of in het tabbladbesturingselement schuifknoppen of een knop worden weergegeven waarin een menu met vensters met tabbladen wordt weergegeven.
CMFCTabCtrl::IsVS2005Style Geeft aan of tabbladen worden weergegeven in de stijl van Visual Studio .NET 2005.
CMFCTabCtrl::ModifyTabStyle Hiermee geeft u het uiterlijk van tabbladen in het huidige tabblad besturingselement.
CMFCTabCtrl::MoveTab Hiermee verplaatst u een tabblad naar een andere tabpositie. (Onderdrukkingen CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnter Aangeroepen door het framework wanneer de cursor voor het eerst naar het tab-besturingselementvenster wordt gesleept.
CMFCTabCtrl::OnDragOver Aangeroepen door het framework tijdens een sleepbewerking wanneer de muis wordt verplaatst over het doelvenster voor neerzetten. (Onderdrukkingen CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenu Geeft een pop-upmenu weer van vensters met tabbladen, wacht totdat de gebruiker een tabblad selecteert en maakt het geselecteerde tabblad het actieve tabblad.
CMFCTabCtrl::PreTranslateMessage Hiermee worden vensterberichten vertaald voordat ze naar de TranslateMessage functies en DispatchMessage Windows worden verzonden. (Onderdrukkingen CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayout Berekent de interne indeling van het tabbladbesturingselement opnieuw. (Onderdrukkingen CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroup Hiermee stelt u het huidige tabblad van een tabblad in als het actieve tabblad in een groep tabbladen met meerdere documentinterfaces.
CMFCTabCtrl::SetActiveTab Hiermee wordt een tabblad geactiveerd. (Onderdrukkingen CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont Hiermee kunt u het gebruik van een vet lettertype op actieve tabbladen in- of uitschakelen.
CMFCTabCtrl::SetDrawFrame Hiermee schakelt u het tekenen van een kaderrechthoek rond een ingesloten balk in of uit.
CMFCTabCtrl::SetFlatFrame Hiermee geeft u op of een vlak of een 3D-frame rond het tabbladgebied moet worden getekend.
CMFCTabCtrl::SetImageList Hiermee geeft u een lijst met afbeeldingen op. (Onderdrukkingen CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeMode Hiermee geeft u op hoe het huidige tabblad besturingselement kan worden gewijzigd en het besturingselement vervolgens opnieuw kan worden weergegeven.
CMFCTabCtrl::SetTabMaxWidth Hiermee geeft u de maximale tabbreedte in een venster met tabbladen.
CMFCTabCtrl::StopResize Hiermee wordt de huidige bewerking voor het wijzigen van het formaat op het tabblad besturingselement beëindigd.
CMFCTabCtrl::SwapTabs Hiermee wisselt u een paar tabbladen. (Onderdrukkingen CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBar Hiermee tekent u een horizontale schuifbalk op een tabblad besturingselement waarin platte tabbladen worden weergegeven.

Gegevensleden

Naam Description
CMFCTabCtrl::m_bEnableActivate Hiermee voorkomt u dat de actieve weergave de focus verliest wanneer een nieuw tabblad wordt ingevoegd en ingeschakeld.

Opmerkingen

De CMFCTabCtrl klasse ondersteunt:

  • Tab-besturingselementstijlen met 3D, plat en plat met een gedeelde horizontale schuifbalk.

  • Tabbladen die zich boven of onder aan het venster bevinden.

  • Tabbladen met tekst, afbeeldingen of tekst en afbeeldingen.

  • Tabbladen die de kleur wijzigen wanneer het tabblad actief is.

  • Wijzigingen in de randgrootte voor aanpasbare tabbladen.

  • Losgekoppelde vensters met tabbladen.

De CMFCTabCtrl klasse kan worden gebruikt met een dialoogvenster, maar is bedoeld voor toepassingen die gebruikmaken van dockingbesturingsbalken zoals Microsoft Excel en Visual Studio. Zie CDockablePane Class voor meer informatie.

Volg deze stappen om een besturingselement voor het dockingtabblad toe te voegen aan uw toepassing:

  1. Maak een exemplaar van CTabbedPane klasse.

  2. Roep CDockablePane::Create aan.

  3. Gebruik CBaseTabbedPane::AddTab of CMFCBaseTabCtrl::InsertTab voeg nieuwe tabbladen toe.

  4. Roep CBasePane::EnableDocking aan zodat het huidige doktab-besturingselement kan worden vastgeslagen in het hoofdframevenster.

  5. Oproep CFrameWndEx::DockPane om het venster met tabbladen aan het hoofdframe vast te leggen.

Zie Klasse voor een voorbeeld van het maken van een venster met tabbladen als dockingbesturingselementbalkCTabbedPane. Als u een niet-dockingbesturingselement wilt gebruiken CMFCTabCtrl , maakt u een CMFCTabCtrl object en roept u CMFCTabCtrl::Createhet aan.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

Example

In het volgende voorbeeld ziet u hoe u verschillende methoden in de CMFCTabCtrl klasse gebruikt om een CMFCTabCtrl object te configureren. In het voorbeeld wordt uitgelegd hoe u een tabblad toevoegt, de knop Sluiten op het actieve tabblad weergeeft, bewerkbare tabbladlabels inschakelt en een pop-upmenu met vensterlabels met tabbladen weergeeft. Dit voorbeeld maakt deel uit van het voorbeeld van de statusverzameling.

CMFCTabCtrl m_wndTabs;

// Attach list windows to tab:
// CListCtrl m_wndList1
// CListCtrl m_wndList2
// CListCtrl m_wndList3
m_wndTabs.AddTab(&m_wndList1, _T("Output 1"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList2, _T("Output 2"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList3, _T("Output 3"), (UINT)-1);

m_wndTabs.EnableActiveTabCloseButton();
m_wndTabs.EnableInPlaceEdit(true);
m_wndTabs.EnableTabDocumentsMenu();
m_wndTabs.SetActiveTab(1);
m_wndTabs.SetDrawFrame();
m_wndTabs.SetFlatFrame();

Requirements

Rubriek:afxtabctrl.h

CMFCTabCtrl::ActivateMDITab

Hiermee wordt het opgegeven tabblad van het huidige tabblad besturingselement weergegeven en wordt de focus op dat tabblad ingesteld.

void ActivateMDITab(int nTab = -1);

Parameterwaarden

nTab
[in] De op nul gebaseerde index van een tabblad dat moet worden weergegeven of -1 om het huidige actieve tabblad op te geven.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

Zie de broncode in de mfc map van uw Visual Studio-installatie voor meer informatie. Bijvoorbeeld: %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Retourwaarde

Altijd TRUE.

Opmerkingen

CMFCTabCtrl::AutoSizeWindow

Hiermee geeft u op of het framework het formaat van het clientgebied van alle tabbladbesturingsvensters moet wijzigen wanneer een element van de gebruikersinterface van het tabblad besturingselement wordt gewijzigd.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Parameterwaarden

bAutoSize
[in] TRUE om het formaat van tabbesturingsvensters automatisch te wijzigen; anders, FALSE. De standaardwaarde is TRUE.

Opmerkingen

CMFCTabCtrl::Create

Hiermee maakt u het tabblad besturingselement en koppelt u het aan het CMFCTabCtrl object.

BOOL Create(
    Style style,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    Location location=LOCATION_BOTTOM,
    BOOL bCloseBtn=FALSE);

Parameterwaarden

style
[in] De stijl van het tabblad besturingselement. Zie Opmerkingen voor meer informatie.

rect
[in] Een rechthoek die het tab-besturingselement begrenzet.

pParentWnd
[in] Een aanwijzer naar een bovenliggend venster. Mag niet zijn NULL.

nID
[in] De id van het tabblad besturingselement.

location
[in] De locatie van tabbladen. De standaardwaarde is LOCATION_BOTTOM. Zie Opmerkingenvoor meer informatie.

bCloseBtn
[in] TRUE om een knop Sluiten weer te geven op het tabblad; anders, FALSE. De standaardwaarde is FALSE.

Retourwaarde

TRUE indien geslaagd; anders, FALSE.

Opmerkingen

In de volgende tabel worden de waarden beschreven die u voor de style parameter kunt opgeven.

Stijl Description
STYLE_3D Hiermee maakt u een tabbesturingselement met een driedimensionaal uiterlijk.
STYLE_FLAT Hiermee maakt u een besturingselement voor tabbladen met platte tabbladen.
STYLE_FLAT_SHARED_HORZ_SCROLL Hiermee maakt u een besturingselement voor tabbladen met platte tabbladen en een schuifbalk waarmee de tabbladen kunnen worden geschoven als ze door een bovenliggend venster worden geknipt.
STYLE_3D_ONENOTE Hiermee maakt u een tabblad besturingselement in de stijl van Microsoft OneNote.
STYLE_3D_VS2005 Hiermee maakt u een tabblad besturingselement in de stijl van Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED Hiermee maakt u een besturingselement voor tabbladen met afgeronde tabbladen in de stijl van Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED_SCROLL Hiermee maakt u een besturingselement voor tabbladen met afgeronde tabbladen en schuifknoppen in de stijl van Microsoft Visual Studio 2005.

De volgende tabel bevat de waarden die u voor de location parameter kunt opgeven.

Locatie Description
LOCATION_BOTTOM Tabbladen bevinden zich onder aan het tab-besturingselement.
LOCATION_TOP Tabbladen bevinden zich boven aan het tab-besturingselement.

Example

In het volgende voorbeeld ziet u hoe u de Create methode in de CMFCTabCtrl klasse gebruikt. Dit voorbeeld maakt deel uit van het voorbeeld van de statusverzameling.

CMFCTabCtrl m_wndTabs;

// Create tabs window:
// CRect rectDummy
// this is a pointer to a parent window
// fourth parameter is the id of the tab control
if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
{
    TRACE0("Failed to create output tab window\n");
    return -1;      // fail to create
}

CMFCTabCtrl::CalcRectEdit

Hiermee wordt de grootte van het opgegeven tabbladgebied verkleind.

virtual void CalcRectEdit(CRect& rectEdit);

Parameterwaarden

rectEdit
[in] Een rechthoek die het gebied van een tabblad aangeeft.

Opmerkingen

Deze methode wordt aangeroepen wanneer u het label van een tabblad wijzigt. Met deze methode worden de linker- en rechterkant van de opgegeven rechthoek met één helft van de huidige tabhoogte gedeflateerd en wordt de boven- en onderkant met één eenheid gedeflateerd.

CMFCTabCtrl::EnableActiveTabCloseButton

Hiermee wordt een knop Sluiten ( X) weergegeven of verborgen op het actieve tabblad.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Parameterwaarden

bEnable
[in] TRUE om de knop Sluiten weer te geven op het actieve tabblad; FALSE om de knop Sluiten weer te geven in de rechterbovenhoek van het tabbladgebied. De standaardwaarde is TRUE.

CMFCTabCtrl::EnableInPlaceEdit

Hiermee schakelt u bewerkbare tablabels in of uit.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parameterwaarden

bEnable
[in] TRUE om bewerkbare tablabels in te schakelen; FALSE om bewerkbare tablabels uit te schakelen.

Opmerkingen

CMFCTabCtrl::EnableTabDocumentsMenu

Schakelen tussen een gebruikersinterface die twee knoppen gebruikt om de venstertabbladen te schuiven en een interface die een pop-upmenu van vensters met tabbladen weergeeft.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Parameterwaarden

bEnable
[in] TRUE om een pop-upmenu van vensterlabels met tabbladen weer te geven; FALSE om vooruit- en achteruit scrollknoppen weer te geven. De standaardwaarde is TRUE.

Opmerkingen

Wanneer de gebruiker op een tabbladlabel klikt, wordt het bijbehorende venster met tabbladen weergegeven. Als het tabbladlabel zichtbaar is, wordt het venster met tabbladen geopend zonder de positie ervan te wijzigen. Als de gebruiker een document selecteert in het snelmenu en het bijbehorende venster met tabbladen buiten het scherm staat, wordt het venster met tabbladen het eerste tabblad.

CMFCTabCtrl::EnsureVisible

Zorgt ervoor dat een tabblad zichtbaar is.

virtual BOOL EnsureVisible(int iTab);

Parameterwaarden

iTab
[in] De op nul gebaseerde index van een tabblad.

Retourwaarde

TRUE als het lukt; FALSE als de iTab parameterindex ongeldig is.

Opmerkingen

Gebruik deze methode om te garanderen dat het opgegeven tabblad zichtbaar is. Het tabblad besturingselement schuift als dit vereist is.

CMFCTabCtrl::GetDocumentIcon

Hiermee haalt u de afbeelding op die is gekoppeld aan een tabblad in een snelmenu met vensters met tabbladen.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Parameterwaarden

nCmdID
[in] De opdracht-id van een tabblad in een snelmenu van vensters met tabbladen.

Retourwaarde

De greep van een bitmapafbeelding.

CMFCTabCtrl::GetFirstVisibleTabNum

Haalt de index op van het eerste tabblad dat zichtbaar is in het huidige tabblad.

virtual int GetFirstVisibleTabNum() const;

Retourwaarde

De op nul gebaseerde index van een tabblad in het tabbladbesturingselement.

Opmerkingen

Gebruik deze methode alleen als het tabblad besturingselement wordt weergegeven in de stijl van Microsoft OneNote. Gebruik de CMFCTabCtrl::IsOneNoteStyle methode om de stijl te bepalen.

CMFCTabCtrl::GetResizeMode

Hiermee wordt een waarde opgehaald die aangeeft hoe het huidige tabblad besturingselement kan worden gewijzigd.

ResizeMode GetResizeMode() const;

Retourwaarde

Een van de CMFCTabCtrl::ResizeMode opsommingswaarden die aangeeft hoe het tabbladbesturingselement kan worden gewijzigd. Zie de sectie Opmerkingen van de CMFCTabCtrl::SetResizeMode methode voor een lijst met mogelijke waarden.

CMFCTabCtrl::GetScrollBar

Hiermee wordt een aanwijzer opgehaald naar het schuifbalkobject dat is gekoppeld aan het tab-besturingselement.

CScrollBar* GetScrollBar();

Retourwaarde

Een aanwijzer naar een schuifbalkobject of een NULL als het tab-besturingselement niet is gemaakt met behulp van de STYLE_FLAT_SHARED_HORZ_SCROLL stijl.

Opmerkingen

Gebruik deze methode voor toegang tot de ingesloten schuifbalk van het tabbladbesturingselement. Er wordt alleen een schuifbalkobject gemaakt wanneer het tab-besturingselement de STYLE_FLAT_SHARED_HORZ_SCROLL stijl heeft.

CMFCTabCtrl::GetTabArea

Hiermee haalt u de begrenzingsrechthoek van het tabbladlabelgebied boven of onder aan het tab-besturingselement op.

void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

Parameterwaarden

rectTabAreaTop
[uit] Wanneer deze methode wordt geretourneerd, bevat deze verwijzing een rechthoek die het labelgebied van het bovenste tabblad begrenst. De rechthoek bevindt zich in clientcoördinaten. Deze verwijzing is leeg als er geen tabbladlabelgebied boven aan het tabblad besturingselement bestaat.

rectTabAreaBottom
[uit] Wanneer deze methode wordt geretourneerd, bevat deze verwijzing een rechthoek die het labelgebied van het onderste tabblad begrenst. De rechthoek bevindt zich in clientcoördinaten. Deze verwijzing is leeg als er geen tabbladlabelgebied onder aan het tabblad besturingselement bestaat.

Opmerkingen

Gebruik deze methode om de grootte en positie van het tabbladgebied in het venster met tabbladen te bepalen.

CMFCTabCtrl::GetTabMaxWidth

Hiermee wordt de maximale breedte van een tabblad opgehaald.

int GetTabMaxWidth() const;

Retourwaarde

Maximale breedte van een tabblad, in pixels. Als de retourwaarde 0 is, is de tabbreedte onbeperkt.

Opmerkingen

Gebruik de methode CMFCTabCtrl::SetTabMaxWidth om de maximale tabbreedte in te stellen.

CMFCTabCtrl::GetTabsHeight

Hiermee wordt de hoogte van het tabbladgebied van het huidige tabblad besturingselement opgehaald.

virtual int GetTabsHeight() const;

Retourwaarde

De hoogte van het tabbladgebied als een tabblad zichtbaar is of nul als er geen tabblad zichtbaar is.

CMFCTabCtrl::GetTabsRect

Hiermee wordt een rechthoek opgehaald die het tabbladgebied van het huidige tabblad besturingselement begrenst.

virtual void GetTabsRect(CRect& rect) const;

Parameterwaarden

rect
[uit] Wanneer deze methode wordt geretourneerd, bevat de rect parameter een rechthoek die het tabbladgebied begrenst.

CMFCTabCtrl::GetWndArea

Hiermee wordt de grens van het clientgebied van het huidige tabblad besturingselement opgehaald.

void GetWndArea(CRect& rect) const;

Parameterwaarden

rect
[in, uit] Wanneer deze methode wordt geretourneerd, bevat deze parameter een rechthoek die het huidige tabblad besturingselement begrenst.

Opmerkingen

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Verbergt de horizontale schuifbalk, indien aanwezig, in het actieve venster.

void HideActiveWindowHorzScrollBar();

Opmerkingen

Gebruik deze methode om te voorkomen dat het tab-besturingselement knippert wanneer de gebruiker schakelt tussen tabbesturingspagina's.

CMFCTabCtrl::HideInactiveWindow

Hiermee geeft u op of het framework inactieve tabbesturingsvensters weergeeft.

void HideInactiveWindow(BOOL bHide = TRUE);

Parameterwaarden

bHide
[in] TRUE geen inactief venster weergeven; FALSE om een inactief venster weer te geven. De standaardwaarde is TRUE.

Opmerkingen

CMFCTabCtrl::HideNoTabs

Hiermee schakelt u het tekenen van het tabbladgebied in of uit als er geen zichtbare tabbladen zijn.

void HideNoTabs(BOOL bHide=TRUE);

Parameterwaarden

bHide
[in] TRUE om het tabbladgebied te tekenen in te schakelen; FALSE om tekenen uit te schakelen. De standaardwaarde is TRUE.

Opmerkingen

CMFCTabCtrl::HideSingleTab

Hiermee schakelt u tabtekening in of uit als er één venster met tabbladen is.

virtual void HideSingleTab(BOOL bHide=TRUE);

Parameterwaarden

bHide
[in] TRUE om geen tab te tekenen voor één venster met tabbladen; FALSE om één tabblad te tekenen. De standaardwaarde is TRUE.

Opmerkingen

CMFCTabCtrl::IsActiveInMDITabGroup

Geeft aan of het huidige tabblad van een tabblad besturingselement het actieve tabblad is in een groep met tabbladen met meerdere documentinterfaces.

BOOL IsActiveInMDITabGroup() const;

Retourwaarde

TRUE als het huidige tabblad van een tabblad besturingselement het actieve tabblad in een MDI-tabbladgroep is; anders, FALSE.

Opmerkingen

U kunt meerdere documentvensters ordenen in verticale of horizontale tabbladgroepen en documenten eenvoudig van de ene tabbladgroep naar de andere verplaatsen.

CMFCTabCtrl::IsActiveTabBoldFont

Geeft aan of de tekst van het actieve tabblad wordt weergegeven met een vet lettertype.

BOOL IsActiveTabBoldFont() const;

Retourwaarde

TRUE als het actieve tabblad wordt weergegeven met het vetgedrukte lettertype; anders, FALSE.

Opmerkingen

Gebruik de CMFCTabCtrl::SetActiveTabBoldFont methode om het actieve tabbladlettertype te wijzigen.

CMFCTabCtrl::IsActiveTabCloseButton

Geeft aan of de knop Sluiten ( X) wordt weergegeven op een actief tabblad of in de rechterbovenhoek van het tabbladgebied.

virtual BOOL IsActiveTabCloseButton() const;

Retourwaarde

TRUE als de knop Sluiten wordt weergegeven op het actieve tabblad; FALSE als de knop Sluiten wordt weergegeven in de rechterbovenhoek van het tabbladgebied.

Opmerkingen

CMFCTabCtrl::IsDrawFrame

Geeft aan of het venster met tabbladen een kaderrechthoek rond ingesloten deelvensters tekent.

BOOL IsDrawFrame() const;

Retourwaarde

TRUE als een kaderrechthoek wordt getekend; anders, FALSE.

Opmerkingen

Gebruik de CMFCTabCtrl::SetDrawFrame methode om het tekenen van een framerechthoek in of uit te schakelen.

CMFCTabCtrl::IsFlatFrame

Hiermee wordt aangegeven of het frame rond het tabblad vlak of 3D is.

BOOL IsFlatFrame() const;

Retourwaarde

TRUE als het frame rond het tabblad vlak is; FALSE als het frame driedimensionaal is.

Opmerkingen

Gebruik de CMFCTabCtrl::SetFlatFrame methode om te wijzigen hoe het frame wordt getekend.

CMFCTabCtrl::IsFlatTab

Hiermee wordt aangegeven of het uiterlijk van de tabbladen in het huidige tabblad besturingselement plat is of niet.

virtual BOOL IsFlatTab() const;

Retourwaarde

TRUE als het uiterlijk van de tabbladen in het huidige tab-besturingselement plat is; anders, FALSE.

CMFCTabCtrl::IsLeftRightRounded

Hiermee wordt aangegeven of het uiterlijk van de linker- en rechterkant van een tabblad in het huidige tab-besturingselement wordt afgerond.

virtual BOOL IsLeftRightRounded() const;

Retourwaarde

TRUE als de zijkanten van elk tabblad worden afgerond; anders, FALSE.

CMFCTabCtrl::IsMDITabGroup

Hiermee wordt aangegeven of het huidige tabbladbesturingselement zich in het clientgebied van een venster met een interface met meerdere documenten bevindt.

virtual BOOL IsMDITabGroup() const;

Retourwaarde

TRUE als het huidige tabblad besturingselement zich in een venster van het MDI-clientgebied bevindt; anders, FALSE.

CMFCTabCtrl::IsOneNoteStyle

Geeft aan of het huidige tabblad besturingselement wordt weergegeven in de stijl van Microsoft OneNote.

virtual BOOL IsOneNoteStyle() const;

Retourwaarde

TRUE als het tabblad besturingselement wordt weergegeven in de stijl van Microsoft OneNote; anders, FALSE.

CMFCTabCtrl::IsSharedScroll

Hiermee wordt aangegeven of het huidige tabblad besturingselement een schuifbalk heeft waarmee de tabbladen als groep kunnen worden geschoven.

BOOL IsSharedScroll() const;

Retourwaarde

TRUE als het tabblad besturingselement een gedeelde schuifbalk heeft; anders, FALSE.

Opmerkingen

Deze methode retourneert TRUE als de style parameter van de CMFCTabCtrl::Create methode is STYLE_FLAT_SHARED_HORZ_SCROLL.

CMFCTabCtrl::IsTabDocumentsMenu

Hiermee wordt aangegeven of in het tabbladbesturingselement schuifknoppen of een knop worden weergegeven waarin een menu met vensters met tabbladen wordt weergegeven.

BOOL IsTabDocumentsMenu() const;

Retourwaarde

TRUE als vensters met tabbladen worden gescrold met behulp van een pop-upmenu van vensterlabels met tabbladen; FALSE als vensters met tabbladen worden gescrold met behulp van knoppen voor vooruit en achteruit schuiven.

Opmerkingen

Gebruik de CMFCTabCtrl::EnableTabDocumentsMenu methode om de methode op te geven voor het schuiven van vensters met tabbladen.

CMFCTabCtrl::IsVS2005Style

Hiermee wordt aangegeven of tabbladen worden getekend met de stijl van Visual Studio 2005.

virtual BOOL IsVS2005Style() const;

Retourwaarde

TRUE als tabbladen worden getekend met de stijl van Visual Studio 2005; anders, FALSE.

Opmerkingen

Gebruik de style parameter van de CMFCTabCtrl::Create methode om op te geven hoe tabbladen worden getekend.

CMFCTabCtrl::m_bEnableActivate

Hiermee voorkomt u dat de actieve weergave de focus verliest wanneer een nieuw tabblad wordt ingevoegd en ingeschakeld.

static BOOL m_bEnableActivate;

Opmerkingen

De focus wordt meestal genomen door een nieuw venster met tabbladen wanneer het tabblad wordt ingevoegd en actief wordt gemaakt. Stel de CMFCTabCtrl::m_bEnableActivate lidvariabele in om FALSE de oorspronkelijke focus te behouden. De standaardwaarde is TRUE.

CMFCTabCtrl::ModifyTabStyle

Hiermee geeft u het uiterlijk van tabbladen in het huidige tabblad besturingselement.

BOOL ModifyTabStyle(Style style);

Parameterwaarden

style
[in] Een van de opsommingswaarden waarmee het uiterlijk van het tabbladbesturingselement wordt opgegeven. Zie de tabel in Opmerkingen voor meer informatie.

Retourwaarde

Altijd TRUE.

Opmerkingen

De waarde van de style parameter kan een van de volgende CMFCTabCtrl::Style opsommingen zijn.

Naam Description
STYLE_3D Geeft driedimensionale, rechthoekige tabs weer met ronde hoeken.
STYLE_3D_ONENOTE Geeft driedimensionale tabbladen weer met één verticale zijde en één schuine zijde en met afgeronde hoeken.
STYLE_3D_ROUNDED Geeft driedimensionale tabbladen weer met schuine zijden en afgeronde hoeken.
STYLE_3D_ROUNDED_SCROLL Geeft driedimensionale tabbladen weer met schuine zijden en afgeronde hoeken. Als er meer tabbladen zijn dan tegelijkertijd kan worden weergegeven, wordt in het framework een vervolgkeuzepijl en een menu met tabbladen weergegeven om actief te maken.
STYLE_3D_SCROLLED Geeft driedimensionale, rechthoekige tabs weer. Als er meer tabbladen zijn dan tegelijkertijd kan worden weergegeven, wordt in het framework een vervolgkeuzepijl en een menu met tabbladen weergegeven om actief te maken.
STYLE_3D_VS2005 Geeft driedimensionale afgeronde tabbladen weer met één schuine zijde en één verticale zijde.
STYLE_FLAT Hiermee worden tweedimensionale tabbladen weergegeven met schuine linker- en rechterzijden.
STYLE_FLAT_SHARED_HORZ_SCROLL Hiermee worden tweedimensionale tabbladen weergegeven. Als er meer tabbladen zijn dan tegelijkertijd kan worden weergegeven, worden in het framework schuifpijlen weergegeven aan de uiteinden van het tabbladgebied.

CMFCTabCtrl::OnDragEnter

Aangeroepen door het framework tijdens een slepen-en-neerzetten-bewerking wanneer de cursor voor het eerst het venster van het huidige tabbladbesturingselement binnenkomt.

virtual DROPEFFECT OnDragEnter(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parameterwaarden

pDataObject
[in] Verwijst naar een gegevensobject dat gegevens bevat die de gebruiker sleept.

dwKeyState
[in] Bevat de status van de wijzigingssleutels. Deze parameter is een bitwise combinatie "or" (|) van de volgende waarden: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, , , MK_MBUTTONen .MK_RBUTTON Zie de sectie Berichtparameters van Info over muisinvoer voor meer informatie.

point
[in] Bevat de huidige locatie van de cursor in clientcoördinaten.

Retourwaarde

Dit DROPEFFECT_NONEbetekent altijd dat het doel voor neerzetten de gegevens niet kan accepteren.

Opmerkingen

Gebruik deze methode om een slepen-en-neerzetten-bewerking te ondersteunen. Overschrijf deze methode om uw eigen aangepaste gedrag te implementeren.

Deze methode roept standaard alleen aan, CMFCTabCtrl::OnDragOverwat altijd wordt geretourneerd DROPEFFECT_NONE.

CMFCTabCtrl::OnDragOver

Aangeroepen door het framework tijdens een sleepbewerking wanneer de muis wordt verplaatst over het doelvenster voor neerzetten.

virtual DROPEFFECT OnDragOver(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parameterwaarden

pDataObject
[in] Wijs een COleDataObject object aan dat over het doel wordt gesleept.

dwKeyState
[in] De status van de wijzigingstoetsen, een bitsgewijze combinatie "of" (|) van MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTONen MK_MBUTTON.MK_RBUTTON Zie 'Berichtparameters' in Info over muisinvoer voor meer informatie.

point
[in] De huidige muispositie.

Retourwaarde

Altijd DROPEFFECT_NONE.

Opmerkingen

Overschrijf deze methode met uw aangepaste implementatie. Zie de CView::OnDragOver methode voor meer informatie.

CMFCTabCtrl::OnShowTabDocumentsMenu

Geeft een pop-upmenu weer van vensters met tabbladen, wacht totdat de gebruiker een tabblad selecteert en maakt het geselecteerde tabblad het actieve tabblad.

virtual void OnShowTabDocumentsMenu(CPoint point);

Parameterwaarden

point
[in] De coördinaten van waar het snelmenu moet worden weergegeven.

Opmerkingen

CMFCTabCtrl::SetActiveInMDITabGroup

Hiermee stelt u het huidige tabblad van een tabblad in als het actieve tabblad in een groep tabbladen met meerdere documentinterfaces.

void SetActiveInMDITabGroup(BOOL bActive);

Parameterwaarden

bActive
[in] TRUE om het huidige tabblad het actieve tabblad te maken; FALSE om het huidige tabblad inactief te maken.

Opmerkingen

U kunt meerdere documentvensters ordenen in verticale of horizontale tabbladgroepen en documenten eenvoudig van de ene tabbladgroep naar de andere verplaatsen.

CMFCTabCtrl::SetActiveTab

Hiermee activeert u een tabblad.

virtual BOOL SetActiveTab(int iTab);

Parameterwaarden

iTab
[in] Hiermee geeft u de op nul gebaseerde index van het tabblad op die moet worden geactiveerd.

Retourwaarde

TRUE als het opgegeven tabblad actief is gemaakt; FALSE als de opgegeven iTab parameterwaarde ongeldig is.

Opmerkingen

Hiermee wordt de AFX_WM_CHANGE_ACTIVE_TAB melding verzonden naar het bovenliggende venster en het frame van het bovenliggende besturingselement van het tabblad.

De SetActiveTab methode roept automatisch de CMFCTabCtrl::HideActiveWindowHorzScrollBar methode aan om te voorkomen dat het scherm knippert.

CMFCTabCtrl::SetActiveTabBoldFont

Hiermee kunt u het gebruik van een vet lettertype op actieve tabbladen in- of uitschakelen.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Parameterwaarden

bIsBold
[in] TRUE om een vet lettertype te gebruiken om het label van het actieve tabblad weer te geven; FALSE om het standaardlettertype te gebruiken om het label weer te geven. De standaardwaarde is TRUE.

Opmerkingen

CMFCTabCtrl::SetDrawFrame

Hiermee geeft u op of een framerechthoek rond een ingesloten staaf wordt getekend.

void SetDrawFrame(BOOL bDraw=TRUE);

Parameterwaarden

bDraw
[in] TRUE om een kaderrechthoek rond een ingesloten balk weer te geven; anders, FALSE. De standaardwaarde is TRUE.

Opmerkingen

CMFCTabCtrl::SetFlatFrame

Hiermee geeft u op of een vlak of een 3D-frame rond het tabbladgebied moet worden getekend.

void SetFlatFrame(
    BOOL bFlat=TRUE,
    BOOL bRepaint=TRUE);

Parameterwaarden

bFlat
[in] TRUE om een vlak kader (2D) rond het tabbladgebied te tekenen; FALSE om een driedimensionaal (3D) frame te tekenen. De standaardwaarde is TRUE.

bRepaint
[in] TRUE om het venster onmiddellijk opnieuw te tekenen; anders, FALSE. De standaardwaarde is TRUE.

Opmerkingen

CMFCTabCtrl::SetImageList

Hiermee geeft u een lijst met afbeeldingen op.

virtual BOOL SetImageList(
    UINT uiID,
    int cx=15,
    COLORREF clrTransp=RGB(255, 0, 255));

virtual BOOL SetImageList(HIMAGELIST hImageList);

Parameterwaarden

uiID
[in] De id van een bitmapresource die de lijst met afbeeldingen bevat.

cx
[in] De breedte van elke afbeelding, in pixels. De standaardwaarde is 15.

clrTransp
[in] De transparante afbeeldingskleur. De delen van de afbeelding die deze kleur zijn, zijn transparant. De standaardwaarde is de kleur magenta, RGB(255,0,255).

hImageList
[in] Een ingang naar een vooraf geladen lijst met installatiekopieën.

Retourwaarde

TRUE als deze methode is geslaagd. FALSE als het tabbesturingselement wordt gemaakt met behulp van een platte stijl of als de eerste overbelasting van de methode de bitmap die is opgegeven door de uiID parameter niet kan worden geladen.

Opmerkingen

Gebruik deze methode om een lijst met afbeeldingen in te stellen voor het tab-besturingselement. De afbeeldingen uit de lijst met afbeeldingen worden naast het tabbladlabel weergegeven. Met deze methode wordt de hoogte van de tab opnieuw berekend, zodat de grootte van het tabblad zowel de afbeelding als de tekst bevat.

Gebruik de CMFCBaseTabCtrl::AddTab methode die wordt overgenomen door het tab-besturingselement om de index van de afbeelding op te geven die moet worden weergegeven.

CMFCTabCtrl::SetResizeMode

Hiermee geeft u op hoe het huidige tabblad besturingselement kan worden gewijzigd en het besturingselement vervolgens opnieuw kan worden weergegeven.

void SetResizeMode(ResizeMode resizeMode);

Parameterwaarden

resizeMode
[in] Een van de CMFCTabCtrl::ResizeMode opsommingswaarden die aangeeft hoe het tabbladbesturingselement kan worden gewijzigd. Zie de tabel in Opmerkingen voor een lijst met mogelijke waarden.

Opmerkingen

De parameter resizeMode kan een van de volgende ResizeMode opsommingswaarden zijn.

Naam Description
RESIZE_NO Het formaat van het tabblad besturingselement kan niet worden gewijzigd.
RESIZE_VERT Het tabblad besturingselement kan verticaal, maar niet horizontaal worden aangepast.
RESIZE_HORIZ Het tabblad besturingselement kan horizontaal, maar niet verticaal worden aangepast.

CMFCTabCtrl::SetTabMaxWidth

Hiermee geeft u de maximale tabbreedte in een venster met tabbladen.

void SetTabMaxWidth(int nTabMaxWidth);

Parameterwaarden

nTabMaxWidth
[in] De maximale tabbreedte, in pixels.

Opmerkingen

Gebruik deze methode om de breedte van elk tabblad in een venster met tabbladen te beperken. Deze methode is handig als tabbladen zeer lange labels hebben. De CMFCTabCtrl klasseconstructor initialiseert de maximale tabbreedte tot 0, wat betekent dat de breedte niet beperkt is.

CMFCTabCtrl::StopResize

Hiermee wordt de huidige bewerking voor het wijzigen van het formaat op het tabblad besturingselement beëindigd.

void StopResize(BOOL bCancel);

Parameterwaarden

bCancel
[in] TRUE om de huidige grootte van de bewerking af te schaffen; FALSE om de huidige groottebewerking te voltooien. In beide gevallen stopt het framework met het tekenen van het formaat van de rechthoek.

CMFCTabCtrl::SynchronizeScrollBar

Hiermee tekent u een horizontale schuifbalk op een tabblad besturingselement waarin platte tabbladen worden weergegeven.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Parameterwaarden

pScrollInfo
[uit] Aanwijzer naar een SCROLLINFO structuur of NULL. Wanneer deze methode wordt geretourneerd en als deze parameter niet NULLis, bevat de structuur alle parameters van de schuifbalk. De standaardwaarde is NULL.

Retourwaarde

TRUE als deze methode slaagt; anders, FALSE.

Opmerkingen

Deze methode is alleen van invloed op een tabblad besturingselement waarin platte tabbladen worden weergegeven. De schuifbalk heeft invloed op alle tabbladen tegelijk.

Zie ook

Hiërarchiegrafiek
Klassen
CDockablePane klasse
CMFCBaseTabCtrl klasse

  • Last updated on