CMFCTabCtrl Klasa

Klasa CMFCTabCtrl udostępnia funkcje kontrolki karty. Kontrolka karty wyświetla okno dokowalne z płaskimi lub trójwymiarowymi kartami u góry lub dołu. Karty mogą wyświetlać tekst i obraz oraz zmieniać kolor, gdy jest aktywny.

Składnia

class CMFCTabCtrl : public CMFCBaseTabCtrl

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CMFCTabCtrl::CMFCTabCtrl	Konstruktor domyślny.
CMFCTabCtrl::~CMFCTabCtrl	Destruktor.

Metody publiczne

Nazwa/nazwisko	opis
CMFCTabCtrl::ActivateMDITab	Wyświetla określoną kartę bieżącej kontrolki karty i ustawia fokus na tej karcie.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow	Określa, czy struktura ma zmienić rozmiar obszaru klienta wszystkich okien sterowania kartą, gdy zmienia się element interfejsu użytkownika kontrolki karty.
CMFCTabCtrl::CalcRectEdit	Deflates rozmiar określonego obszaru tabulacji. (Przesłonięcia CMFCBaseTabCtrl::CalcRectEdit).
CMFCTabCtrl::Create	Tworzy kontrolkę karty i dołącza ją do CMFCTabCtrl obiektu.
CMFCTabCtrl::CreateObject	Używana przez platformę do tworzenia wystąpienia dynamicznego tego typu klasy.
CMFCTabCtrl::EnableActiveTabCloseButton	Pokazuje lub ukrywa przycisk Zamknij ( X) na aktywnej karcie.
CMFCTabCtrl::EnableInPlaceEdit	Włącza lub wyłącza edytowalne etykiety kart. (Przesłania CMFCBaseTabCtrl::EnableInPlaceEdit).
CMFCTabCtrl::EnableTabDocumentsMenu	Zamienia dwa przyciski, które przewijają karty okien za pomocą przycisku, który otwiera menu okien z kartami.
CMFCTabCtrl::EnsureVisible	Gwarantuje, że karta jest widoczna.
CMFCTabCtrl::GetDocumentIcon	Pobiera symbol skojarzony z kartą w menu podręcznym okien z kartami.
CMFCTabCtrl::GetFirstVisibleTabNum	Pobiera indeks pierwszej karty widocznej w bieżącej kontrolce karty.
CMFCTabCtrl::GetResizeMode	Pobiera wartość określającą, jak można zmienić rozmiar bieżącej kontrolki karty.
CMFCTabCtrl::GetScrollBar	Pobiera wskaźnik do obiektu paska przewijania skojarzonego z kontrolką karty.
CMFCTabCtrl::GetTabArea	Pobiera prostokąt ograniczenia obszaru etykiety tabulatora w górnej lub dolnej części kontrolki karty. (Przesłania CMFCBaseTabCtrl::GetTabArea).
CMFCTabCtrl::GetTabFromPoint	Pobiera kartę zawierającą określony punkt. (Przesłania CMFCBaseTabCtrl::GetTabFromPoint).
CMFCTabCtrl::GetTabMaxWidth	Pobiera maksymalną szerokość karty.
CMFCTabCtrl::GetTabsHeight	Pobiera wysokość obszaru karty bieżącej kontrolki karty.
CMFCTabCtrl::GetTabsRect	Pobiera prostokąt, który jest powiązany z obszarem tabulacji bieżącej kontrolki karty. (Przesłania CMFCBaseTabCtrl::GetTabsRect).
CMFCTabCtrl::GetThisClass	Używany przez platformę do uzyskiwania wskaźnika do obiektu skojarzonego CRuntimeClass z tym typem klasy.
CMFCTabCtrl::GetWndArea	Pobiera granicę obszaru klienta bieżącej kontrolki karty.
CMFCTabCtrl::HideActiveWindowHorzScrollBar	Ukrywa poziomy pasek przewijania, jeśli istnieje, aktywnego okna.
CMFCTabCtrl::HideInactiveWindow	Określa, czy platforma ma wyświetlać nieaktywne okna sterowania kartą.
CMFCTabCtrl::HideNoTabs	Włącza lub wyłącza rysowanie obszaru karty, jeśli nie ma widocznych kart.
CMFCTabCtrl::HideSingleTab	Włącza lub wyłącza rysowanie karty, gdy istnieje jedno okno z kartami. (Przesłania CMFCBaseTabCtrl::HideSingleTab).
CMFCTabCtrl::IsActiveInMDITabGroup	Wskazuje, czy bieżąca karta kontrolki karty jest aktywną kartą w grupie kart interfejsu wielu dokumentów.
CMFCTabCtrl::IsActiveTabBoldFont	Wskazuje, czy tekst aktywnej karty jest wyświetlany przy użyciu czcionki pogrubionej.
CMFCTabCtrl::IsActiveTabCloseButton	Wskazuje, czy przycisk Zamknij ( X) jest wyświetlany na aktywnej karcie, czy w prawym górnym rogu obszaru karty.
CMFCTabCtrl::IsDrawFrame	Wskazuje, czy okno z kartami rysuje prostokąt ramki wokół osadzonych okienek.
CMFCTabCtrl::IsFlatFrame	Wskazuje, czy ramka wokół obszaru tabulacji jest płaska, czy 3D.
CMFCTabCtrl::IsFlatTab	Wskazuje, czy wygląd kart w bieżącej kontrolce karty jest płaski, czy nie.
CMFCTabCtrl::IsLeftRightRounded	Wskazuje, czy wygląd lewej i prawej strony karty w bieżącej kontrolce karty jest zaokrąglany.
CMFCTabCtrl::IsMDITabGroup	Wskazuje, czy bieżąca kontrolka karty znajduje się w obszarze klienta okna interfejsu wielu dokumentów.
CMFCTabCtrl::IsOneNoteStyle	Wskazuje, czy bieżąca kontrolka karty jest wyświetlana w stylu programu Microsoft OneNote.
CMFCTabCtrl::IsPtInTabArea	Określa, czy punkt znajduje się wewnątrz obszaru karty. (Przesłania CMFCBaseTabCtrl::IsPtInTabArea).
CMFCTabCtrl::IsSharedScroll	Wskazuje, czy bieżąca kontrolka karty ma pasek przewijania, który może przewijać karty jako grupę.
CMFCTabCtrl::IsTabDocumentsMenu	Wskazuje, czy kontrolka karty wyświetla przyciski przewijania, czy przycisk, który wyświetla menu okien z kartami.
CMFCTabCtrl::IsVS2005Style	Wskazuje, czy karty są wyświetlane w stylu programu Visual Studio .NET 2005.
CMFCTabCtrl::ModifyTabStyle	Określa wygląd kart w bieżącej kontrolce karty.
CMFCTabCtrl::MoveTab	Przenosi kartę do innej pozycji karty. (Przesłania CMFCBaseTabCtrl::MoveTab).
CMFCTabCtrl::OnDragEnter	Wywoływana przez platformę po pierwszym przeciągnięciu kursora do okna kontrolki karty.
CMFCTabCtrl::OnDragOver	Wywoływana przez platformę podczas operacji przeciągania po przeniesieniu myszy nad oknem docelowym upuszczania. (Przesłania CMFCBaseTabCtrl::OnDragOver).
CMFCTabCtrl::OnShowTabDocumentsMenu	Wyświetla menu podręczne okien z kartami, czeka na wybranie karty przez użytkownika i spowoduje, że wybrana karta zostanie wyświetlona na aktywnej karcie.
CMFCTabCtrl::PreTranslateMessage	Tłumaczy komunikaty okien przed ich wysłaniem do TranslateMessage funkcji systemu i DispatchMessage Windows. (Przesłania CMFCBaseTabCtrl::PreTranslateMessage).
CMFCTabCtrl::RecalcLayout	Oblicza ponownie układ wewnętrzny kontrolki tabulacji. (Przesłania CMFCBaseTabCtrl::RecalcLayout).
CMFCTabCtrl::SetActiveInMDITabGroup	Ustawia bieżącą kartę kontrolki karty jako aktywną kartę w grupie kart interfejsu wielu dokumentów.
CMFCTabCtrl::SetActiveTab	Aktywuje kartę. (Przesłonięcia CMFCBaseTabCtrl::SetActiveTab).
CMFCTabCtrl::SetActiveTabBoldFont	Włącza lub wyłącza używanie czcionki pogrubionej na aktywnych kartach.
CMFCTabCtrl::SetDrawFrame	Włącza lub wyłącza rysowanie prostokąta ramki wokół osadzonego paska.
CMFCTabCtrl::SetFlatFrame	Określa, czy ma być rysowana płaska, czy ramka 3D wokół obszaru tabulacji.
CMFCTabCtrl::SetImageList	Określa listę obrazów. (Przesłania CMFCBaseTabCtrl::SetImageList).
CMFCTabCtrl::SetResizeMode	Określa sposób zmiany rozmiaru bieżącej kontrolki karty, a następnie ponowne redysponowanie kontrolki.
CMFCTabCtrl::SetTabMaxWidth	Określa maksymalną szerokość karty w oknie z kartami.
CMFCTabCtrl::StopResize	Przerywa bieżącą operację zmiany rozmiaru w kontrolce karty.
CMFCTabCtrl::SwapTabs	Zamienia parę kart. (Przesłania CMFCBaseTabCtrl::SwapTabs).
CMFCTabCtrl::SynchronizeScrollBar	Rysuje poziomy pasek przewijania na kontrolce karty, która wyświetla płaskie karty.

Składowe danych

Nazwa/nazwisko	opis
CMFCTabCtrl::m_bEnableActivate	Uniemożliwia aktywnemu widokowi utratę fokusu po wstawieniu i włączeniu nowej karty.

Uwagi

Klasa CMFCTabCtrl obsługuje następujące elementy:

• Style kontrolek tabulacji, które obejmują 3D, płaskie i płaskie z udostępnionym poziomym paskiem przewijania.

• Karty znajdujące się w górnej lub dolnej części okna.

• Karty, które wyświetlają tekst, obrazy lub tekst i obrazy.

• Karty, które zmieniają kolor, gdy karta jest aktywna.

• Zmiany rozmiaru obramowania dla regulowanych kart.

• Odłączane okna z kartami.

Klasa CMFCTabCtrl może być używana w oknie dialogowym, ale jest przeznaczona dla aplikacji korzystających z pasków sterowania dokowania, takich jak Microsoft Excel i Visual Studio. Aby uzyskać więcej informacji, zobacz CDockablePane Klasa.

Wykonaj następujące kroki, aby dodać kontrolkę tabulatora z możliwością zmiany rozmiaru w aplikacji:

1. Utwórz wystąpienie CTabbedPane klasy.

2. Wywołaj polecenie CDockablePane::Create.

3. Użyj CBaseTabbedPane::AddTab polecenia lub CMFCBaseTabCtrl::InsertTab , aby dodać nowe karty.

4. Wywołaj metodę CBasePane::EnableDocking tak, aby bieżąca kontrolka karty dokowania mogła zadokować się w głównym oknie ramki.

5. Wywołaj polecenie CFrameWndEx::DockPane , aby zadokować okno z kartami w ramce głównej.

Aby zapoznać się z przykładem tworzenia okna z kartą jako paska sterowania dokowania, zobacz CTabbedPane Klasa. Aby użyć CMFCTabCtrl jako kontrolki niedokowania, utwórz obiekt, a następnie wywołaj metodę CMFCTabCtrl CMFCTabCtrl::Create.

Hierarchia dziedziczenia

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

Przykład

W poniższym przykładzie pokazano, jak używać różnych metod w CMFCTabCtrl klasie do konfigurowania CMFCTabCtrl obiektu. W tym przykładzie wyjaśniono, jak dodać kartę, wyświetlić przycisk Zamknij na aktywnej karcie, włączyć edytowalne etykiety kart i wyświetlić menu podręczne etykiet okien z kartami. Ten przykład jest częścią przykładu Kolekcji stanów.

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();

Wymagania

Nagłówek: afxtabctrl.h

CMFCTabCtrl::ActivateMDITab

Wyświetla określoną kartę bieżącej kontrolki karty i ustawia fokus na tej karcie.

void ActivateMDITab(int nTab = -1);

Parametry

nTab
[in] Indeks oparty na zerach karty do wyświetlenia lub -1 w celu określenia aktualnie aktywnej karty.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w mfc folderze instalacji programu Visual Studio. Na przykład %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Wartość zwracana

Zawsze wartość TRUE.

Uwagi

CMFCTabCtrl::AutoSizeWindow

Określa, czy struktura ma zmienić rozmiar obszaru klienta wszystkich okien sterowania kartą, gdy zmienia się element interfejsu użytkownika kontrolki karty.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Parametry

bAutoSize
[in] TRUE aby automatycznie zmieniać rozmiar okien sterowania kartą; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

Uwagi

CMFCTabCtrl::Create

Tworzy kontrolkę karty i dołącza ją do CMFCTabCtrl obiektu.

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

Parametry

style
[in] Styl kontrolki tabulacji. Aby uzyskać więcej informacji zobacz uwagi.

rect
[in] Prostokąt, który jest powiązany z kontrolką tabulacji.

pParentWnd
[in] Wskaźnik do okna nadrzędnego. Nie może być .NULL

nID
[in] Identyfikator kontrolki karty.

location
[in] Lokalizacja kart. Domyślna wartość to LOCATION_BOTTOM. Aby uzyskać więcej informacji, zobacz Uwagi.

bCloseBtn
[in] TRUE aby wyświetlić przycisk zamknięcia na karcie; w przeciwnym razie, FALSE. Domyślna wartość to FALSE.

Wartość zwracana

Wartość TRUE w przypadku powodzenia; w przeciwnym razie wartość FALSE.

Uwagi

W poniższej tabeli opisano wartości, które można określić dla parametru style .

Styl	opis
STYLE_3D	Tworzy kontrolkę karty z trójwymiarowym wyglądem.
STYLE_FLAT	Tworzy kontrolkę tabulacji z płaskimi kartami.
STYLE_FLAT_SHARED_HORZ_SCROLL	Tworzy kontrolkę tabulacji z płaskimi kartami i paskiem przewijania, który może przewijać karty, jeśli zostaną obcięte przez okno nadrzędne.
STYLE_3D_ONENOTE	Tworzy kontrolkę karty w stylu programu Microsoft OneNote.
STYLE_3D_VS2005	Tworzy kontrolkę tabulacji w stylu programu Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED	Tworzy kontrolkę karty z zaokrąglonymi kartami w stylu programu Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED_SCROLL	Tworzy kontrolkę tabulacji z zaokrąglonymi kartami i przyciskami przewijania w stylu programu Microsoft Visual Studio 2005.

W poniższej tabeli wymieniono wartości, które można określić dla parametru location .

Lokalizacja	opis
LOCATION_BOTTOM	Karty znajdują się w dolnej części kontrolki karty.
LOCATION_TOP	Karty znajdują się w górnej części kontrolki karty.

Przykład

W poniższym przykładzie pokazano, jak używać Create metody w CMFCTabCtrl klasie . Ten przykład jest częścią przykładu Kolekcji stanów.

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

Deflates rozmiar określonego obszaru tabulacji.

virtual void CalcRectEdit(CRect& rectEdit);

Parametry

rectEdit
[in] Prostokąt określający obszar karty.

Uwagi

Ta metoda jest wywoływana podczas zmiany etykiety karty. Ta metoda deflatuje lewe i prawe boki określonego prostokąta o połowę wysokości bieżącej karty, a następnie deflatuje górną i dolną część po jednej jednostce.

CMFCTabCtrl::EnableActiveTabCloseButton

Pokazuje lub ukrywa przycisk Zamknij ( X) na aktywnej karcie.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Parametry

bEnable
[in] TRUE aby wyświetlić przycisk Zamknij na aktywnej karcie; FALSE aby wyświetlić przycisk Zamknij w prawym górnym rogu obszaru karty. Domyślna wartość to TRUE.

CMFCTabCtrl::EnableInPlaceEdit

Włącza lub wyłącza edytowalne etykiety kart.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parametry

bEnable
[in] TRUE aby włączyć edytowalne etykiety kart; FALSE aby wyłączyć edytowalne etykiety kart.

Uwagi

CMFCTabCtrl::EnableTabDocumentsMenu

Przełącza się między interfejsem użytkownika, który używa dwóch przycisków do przewijania kart okna i interfejsu, który wyświetla menu podręczne okien z kartami.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Parametry

bEnable
[in] TRUE aby wyświetlić menu podręczne etykiet okien z kartami; FALSE aby wyświetlić przyciski przewijania do przodu i do tyłu. Domyślna wartość to TRUE.

Uwagi

Gdy użytkownik kliknie etykietę karty, platforma wyświetli odpowiednie okno z kartami. Jeśli etykieta karty jest widoczna, okno z kartą zostanie otwarte bez zmiany jego położenia. Jeśli użytkownik wybierze dokument z menu podręcznego, a odpowiednie okno z kartami jest wyłączone, okno z kartami stanie się pierwszą kartą.

CMFCTabCtrl::EnsureVisible

Gwarantuje, że karta jest widoczna.

virtual BOOL EnsureVisible(int iTab);

Parametry

iTab
[in] Indeks oparty na zerach karty.

Wartość zwracana

TRUE jeśli to się powiedzie; FALSE jeśli indeks parametrów iTab jest nieprawidłowy.

Uwagi

Użyj tej metody, aby zagwarantować, że określona karta jest widoczna. Kontrolka karty będzie przewijać, jeśli jest to wymagane.

CMFCTabCtrl::GetDocumentIcon

Pobiera obraz skojarzony z kartą w podręcznym menu okien z kartami.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Parametry

nCmdID
[in] Identyfikator polecenia karty w menu podręcznym okien z kartami.

Wartość zwracana

Uchwyt obrazu mapy bitowej.

CMFCTabCtrl::GetFirstVisibleTabNum

Pobiera indeks pierwszej karty widocznej w bieżącej kontrolce karty.

virtual int GetFirstVisibleTabNum() const;

Wartość zwracana

Zerowy indeks karty w kontrolce karty.

Uwagi

Użyj tej metody tylko wtedy, gdy kontrolka karty jest wyświetlana w stylu programu Microsoft OneNote. CMFCTabCtrl::IsOneNoteStyle Użyj metody , aby określić styl.

CMFCTabCtrl::GetResizeMode

Pobiera wartość określającą, jak można zmienić rozmiar bieżącej kontrolki karty.

ResizeMode GetResizeMode() const;

Wartość zwracana

CMFCTabCtrl::ResizeMode Jedna z wartości wyliczenia, która określa, jak można zmienić rozmiar kontrolki karty. Aby uzyskać listę możliwych wartości, zobacz sekcję CMFCTabCtrl::SetResizeMode Uwagi metody.

CMFCTabCtrl::GetScrollBar

Pobiera wskaźnik do obiektu paska przewijania skojarzonego z kontrolką karty.

CScrollBar* GetScrollBar();

Wartość zwracana

Wskaźnik do obiektu paska przewijania lub NULL jeśli kontrolka karty nie została utworzona przy użyciu STYLE_FLAT_SHARED_HORZ_SCROLL stylu.

Uwagi

Użyj tej metody, aby uzyskać dostęp do osadzonego paska przewijania kontrolki karty. Obiekt paska przewijania jest tworzony tylko wtedy, gdy kontrolka STYLE_FLAT_SHARED_HORZ_SCROLL karty ma styl.

CMFCTabCtrl::GetTabArea

Pobiera prostokąt ograniczenia obszaru etykiety tabulatora w górnej lub dolnej części kontrolki karty.

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

Parametry

rectTabAreaTop
[out] Gdy ta metoda zwróci tę metodę, odwołanie zawiera prostokąt, który jest powiązany z obszarem etykiety górnej karty. Prostokąt znajduje się we współrzędnych klienta. To odwołanie jest puste, jeśli w górnej części kontrolki karty nie istnieje żaden obszar etykiety tabulacji.

rectTabAreaBottom
[out] Gdy ta metoda zwróci tę metodę, odwołanie zawiera prostokąt, który graniczy z dolnym obszarem etykiety tabulacji. Prostokąt znajduje się we współrzędnych klienta. To odwołanie jest puste, jeśli w dolnej części kontrolki karty nie istnieje żaden obszar etykiety tabulacji.

Uwagi

Użyj tej metody, aby określić rozmiar i położenie obszaru tabulatora w oknie z kartami.

CMFCTabCtrl::GetTabMaxWidth

Pobiera maksymalną szerokość karty.

int GetTabMaxWidth() const;

Wartość zwracana

Maksymalna szerokość karty w pikselach. Jeśli zwracana wartość to 0, szerokość karty jest nieograniczona.

Uwagi

Użyj metody CMFCTabCtrl::SetTabMaxWidth, aby ustawić maksymalną szerokość tabulacji.

CMFCTabCtrl::GetTabsHeight

Pobiera wysokość obszaru karty bieżącej kontrolki karty.

virtual int GetTabsHeight() const;

Wartość zwracana

Wysokość obszaru karty, jeśli jakakolwiek karta jest widoczna, lub zero, jeśli żadna karta nie jest widoczna.

CMFCTabCtrl::GetTabsRect

Pobiera prostokąt, który jest powiązany z obszarem tabulacji bieżącej kontrolki karty.

virtual void GetTabsRect(CRect& rect) const;

Parametry

rect
[out] Gdy ta metoda zwróci wartość , rect parametr zawiera prostokąt, który jest powiązany z obszarem tabulacji.

CMFCTabCtrl::GetWndArea

Pobiera granicę obszaru klienta bieżącej kontrolki karty.

void GetWndArea(CRect& rect) const;

Parametry

rect
[in, out] Gdy ta metoda zwraca, ten parametr zawiera prostokąt, który jest powiązany z bieżącą kontrolką karty.

Uwagi

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Ukrywa poziomy pasek przewijania, jeśli istnieje, w aktywnym oknie.

void HideActiveWindowHorzScrollBar();

Uwagi

Użyj tej metody, aby uniemożliwić kontrolki karty, gdy użytkownik przełącza się między stronami kontrolki karty.

CMFCTabCtrl::HideInactiveWindow

Określa, czy platforma wyświetla nieaktywne okna sterowania kartą.

void HideInactiveWindow(BOOL bHide = TRUE);

Parametry

bHide
[in] TRUE nie wyświetlać nieaktywnego okna; FALSE aby wyświetlić nieaktywne okno. Domyślna wartość to TRUE.

Uwagi

CMFCTabCtrl::HideNoTabs

Włącza lub wyłącza rysowanie obszaru tabulacji, jeśli nie ma widocznych kart.

void HideNoTabs(BOOL bHide=TRUE);

Parametry

bHide
[in] TRUE aby włączyć rysowanie obszaru karty; FALSE aby wyłączyć rysunek. Domyślna wartość to TRUE.

Uwagi

CMFCTabCtrl::HideSingleTab

Włącza lub wyłącza rysowanie kart, jeśli istnieje jedno okno z kartami.

virtual void HideSingleTab(BOOL bHide=TRUE);

Parametry

bHide
[in] TRUE aby nie rysować karty dla pojedynczego okna z kartami; FALSE aby narysować pojedynczą kartę. Wartość domyślna to TRUE.

Uwagi

CMFCTabCtrl::IsActiveInMDITabGroup

Wskazuje, czy bieżąca karta kontrolki karty jest aktywną kartą w grupie kart interfejsu wielu dokumentów.

BOOL IsActiveInMDITabGroup() const;

Wartość zwracana

TRUE jeśli bieżąca karta kontrolki karty jest aktywną kartą w grupie kart MDI; w przeciwnym razie, FALSE.

Uwagi

Istnieje możliwość organizowania wielu okien dokumentów w pionowych lub poziomych grupach kart i łatwego mieszania dokumentów z jednej grupy kart do innej.

CMFCTabCtrl::IsActiveTabBoldFont

Wskazuje, czy tekst aktywnej karty jest wyświetlany przy użyciu czcionki pogrubionej.

BOOL IsActiveTabBoldFont() const;

Wartość zwracana

TRUE jeśli aktywna karta jest wyświetlana przy użyciu czcionki pogrubionej; w przeciwnym razie, FALSE.

Uwagi

CMFCTabCtrl::SetActiveTabBoldFont Użyj metody , aby zmienić czcionkę aktywnej karty.

CMFCTabCtrl::IsActiveTabCloseButton

Wskazuje, czy przycisk Zamknij ( X) jest wyświetlany na aktywnej karcie lub w prawym górnym rogu obszaru karty.

virtual BOOL IsActiveTabCloseButton() const;

Wartość zwracana

TRUEjeśli przycisk Zamknij jest wyświetlany na aktywnej karcie; FALSE jeśli przycisk Zamknij jest wyświetlany w prawym górnym rogu obszaru karty.

Uwagi

CMFCTabCtrl::IsDrawFrame

Wskazuje, czy okno z kartami rysuje prostokąt ramki wokół osadzonych okienek.

BOOL IsDrawFrame() const;

Wartość zwracana

TRUE jeśli prostokąt ramki jest rysowany; w przeciwnym razie, FALSE.

Uwagi

CMFCTabCtrl::SetDrawFrame Użyj metody , aby włączyć lub wyłączyć rysowanie prostokąta ramki.

CMFCTabCtrl::IsFlatFrame

Wskazuje, czy ramka wokół obszaru tabulacji jest płaska, czy 3D.

BOOL IsFlatFrame() const;

Wartość zwracana

TRUE jeśli ramka wokół obszaru tabulacji jest płaska; FALSE jeśli ramka jest trójwymiarowa.

Uwagi

CMFCTabCtrl::SetFlatFrame Użyj metody , aby zmienić sposób rysowania ramki.

CMFCTabCtrl::IsFlatTab

Wskazuje, czy wygląd kart w bieżącej kontrolce karty jest płaski, czy nie.

virtual BOOL IsFlatTab() const;

Wartość zwracana

TRUE jeśli wygląd kart w bieżącej kontrolce karty jest płaski; w przeciwnym razie, FALSE.

CMFCTabCtrl::IsLeftRightRounded

Wskazuje, czy wygląd lewej i prawej strony karty w bieżącej kontrolce karty jest zaokrąglany.

virtual BOOL IsLeftRightRounded() const;

Wartość zwracana

TRUE jeśli boki każdej karty są zaokrąglone; w przeciwnym razie, FALSE.

CMFCTabCtrl::IsMDITabGroup

Wskazuje, czy bieżąca kontrolka karty znajduje się w obszarze klienta okna interfejsu wielu dokumentów.

virtual BOOL IsMDITabGroup() const;

Wartość zwracana

TRUE jeśli bieżąca kontrolka karty znajduje się w oknie obszaru klienta MDI; w przeciwnym razie, FALSE.

CMFCTabCtrl::IsOneNoteStyle

Wskazuje, czy bieżąca kontrolka karty jest wyświetlana w stylu programu Microsoft OneNote.

virtual BOOL IsOneNoteStyle() const;

Wartość zwracana

TRUE jeśli kontrolka karty jest wyświetlana w stylu programu Microsoft OneNote; w przeciwnym razie, FALSE.

CMFCTabCtrl::IsSharedScroll

Wskazuje, czy bieżąca kontrolka karty ma pasek przewijania, który może przewijać karty jako grupę.

BOOL IsSharedScroll() const;

Wartość zwracana

TRUE jeśli kontrolka karty ma udostępniony pasek przewijania; w przeciwnym razie, FALSE.

Uwagi

Ta metoda zwraca TRUE wartość , jeśli style parametr CMFCTabCtrl::Create metody to STYLE_FLAT_SHARED_HORZ_SCROLL.

CMFCTabCtrl::IsTabDocumentsMenu

Wskazuje, czy kontrolka karty wyświetla przyciski przewijania, czy przycisk, który wyświetla menu okien z kartami.

BOOL IsTabDocumentsMenu() const;

Wartość zwracana

TRUE jeśli okna z kartami są przewijane przy użyciu menu podręcznego etykiet okien z kartami; FALSE Jeśli okna z kartami są przewijane przy użyciu przycisków przewijania do przodu i do tyłu.

Uwagi

CMFCTabCtrl::EnableTabDocumentsMenu Użyj metody , aby określić metodę przewijania okien z kartami.

CMFCTabCtrl::IsVS2005Style

Wskazuje, czy karty są rysowane przy użyciu stylu programu Visual Studio 2005.

virtual BOOL IsVS2005Style() const;

Wartość zwracana

TRUE jeśli karty są rysowane przy użyciu stylu programu Visual Studio 2005; w przeciwnym razie, FALSE.

Uwagi

style Użyj parametru CMFCTabCtrl::Create metody , aby określić sposób rysowania kart.

CMFCTabCtrl::m_bEnableActivate

Uniemożliwia aktywnemu widokowi utratę fokusu po wstawieniu i włączeniu nowej karty.

static BOOL m_bEnableActivate;

Uwagi

Fokus jest zwykle wykonywany przez nowe okno z kartami, gdy karta zostanie wstawiona i aktywna. Ustaw zmienną składową CMFCTabCtrl::m_bEnableActivate , aby FALSE zachować oryginalną fokus. Domyślna wartość to TRUE.

CMFCTabCtrl::ModifyTabStyle

Określa wygląd kart w bieżącej kontrolce karty.

BOOL ModifyTabStyle(Style style);

Parametry

style
[in] Jedna z wartości wyliczenia, która określa wygląd kontrolki tabulacji. Aby uzyskać więcej informacji, zobacz tabelę w uwagach.

Wartość zwracana

Zawsze wartość TRUE.

Uwagi

Wartość parametru style może być jedną z następujących CMFCTabCtrl::Style wyliczenia.

Nazwa/nazwisko	opis
STYLE_3D	Wyświetla trójwymiarowe, prostokątne tabulatory z okrągłymi rogami.
STYLE_3D_ONENOTE	Wyświetla trójwymiarowe karty, które mają jedną pionową stronę i jedną skośną stronę oraz zaokrąglone rogi.
STYLE_3D_ROUNDED	Wyświetla trójwymiarowe karty, które mają skośne boki i zaokrąglone rogi.
STYLE_3D_ROUNDED_SCROLL	Wyświetla trójwymiarowe karty, które mają skośne boki i zaokrąglone rogi. Jeśli w tym samym czasie jest wyświetlanych więcej kart, platforma wyświetla strzałkę listy rozwijanej i menu kart, które mają być aktywne.
STYLE_3D_SCROLLED	Wyświetla trójwymiarowe, prostokątne tabulatory. Jeśli w tym samym czasie jest wyświetlanych więcej kart, platforma wyświetla strzałkę listy rozwijanej i menu kart, które mają być aktywne.
STYLE_3D_VS2005	Wyświetla trójwymiarowe, zaokrąglone karty, które mają jedną skośną stronę i jedną pionową stronę.
STYLE_FLAT	Wyświetla dwuwymiarowe karty, które mają skośne lewe i prawe boki.
STYLE_FLAT_SHARED_HORZ_SCROLL	Wyświetla karty dwuwymiarowe. Jeśli w tym samym czasie jest więcej kart niż można wyświetlić, platforma wyświetla strzałki przewijania na końcach obszaru karty.

CMFCTabCtrl::OnDragEnter

Wywoływana przez platformę podczas operacji przeciągania i upuszczania po pierwszym wejściu kursora w okno bieżącej kontrolki karty.

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

Parametry

pDataObject
[in] Wskazuje obiekt danych zawierający dane, które użytkownik przeciąga.

dwKeyState
[in] Zawiera stan kluczy modyfikatora. Ten parametr jest bitową kombinacją "lub" (|) następujących wartości: MK_CONTROL, , MK_SHIFT, MK_ALTMK_LBUTTON, MK_MBUTTON, i MK_RBUTTON. Aby uzyskać więcej informacji, zobacz sekcję Parametry komunikatu w temacie About Mouse Input (Informacje o danych wejściowych myszy).

point
[in] Zawiera bieżącą lokalizację kursora we współrzędnych klienta.

Wartość zwracana

Zawsze DROPEFFECT_NONE, co oznacza, że obiekt docelowy upuszczania nie może zaakceptować danych.

Uwagi

Ta metoda umożliwia obsługę operacji przeciągania i upuszczania. Zastąpi tę metodę, aby zaimplementować własne zachowanie niestandardowe.

Domyślnie ta metoda wywołuje CMFCTabCtrl::OnDragOvertylko metodę , która zawsze zwraca wartość DROPEFFECT_NONE.

CMFCTabCtrl::OnDragOver

Wywoływana przez platformę podczas operacji przeciągania po przeniesieniu myszy nad oknem docelowym upuszczania.

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

Parametry

pDataObject
[in] Wskaźnik do COleDataObject obiektu, który jest przeciągany przez obiekt docelowy upuszczania.

dwKeyState
[in] Stan kluczy modyfikujących, który jest kombinacją bitową "or" () z MK_CONTROL, , MK_SHIFT, MK_LBUTTONMK_ALT, MK_MBUTTON, i MK_RBUTTON.| Aby uzyskać więcej informacji, zobacz "Parametry komunikatu" w temacie About Mouse Input (Informacje o danych wejściowych myszy).

point
[in] Bieżąca pozycja myszy.

Wartość zwracana

Zawsze wartość DROPEFFECT_NONE.

Uwagi

Zastąpi tę metodę niestandardową implementacją. Aby uzyskać więcej informacji, zobacz metodę CView::OnDragOver .

CMFCTabCtrl::OnShowTabDocumentsMenu

Wyświetla wyskakujące menu okien z kartami, czeka na wybranie karty przez użytkownika i spowoduje, że wybrana karta zostanie wyświetlona na aktywnej karcie.

virtual void OnShowTabDocumentsMenu(CPoint point);

Parametry

point
[in] Współrzędne miejsca wyświetlania menu podręcznego.

Uwagi

CMFCTabCtrl::SetActiveInMDITabGroup

Ustawia bieżącą kartę kontrolki karty jako aktywną kartę w grupie kart interfejsu wielu dokumentów.

void SetActiveInMDITabGroup(BOOL bActive);

Parametry

bActive
[in] TRUE aby ustawić bieżącą kartę na aktywnej karcie; FALSE aby ustawić bieżącą kartę jako nieaktywną.

Uwagi

Istnieje możliwość organizowania wielu okien dokumentów w pionowych lub poziomych grupach kart i łatwego mieszania dokumentów z jednej grupy kart do innej.

CMFCTabCtrl::SetActiveTab

Aktywuje kartę.

virtual BOOL SetActiveTab(int iTab);

Parametry

iTab
[in] Określa indeks zerowy karty do aktywowania.

Wartość zwracana

TRUE jeśli określona karta została aktywna; FALSE jeśli określona iTab wartość parametru jest nieprawidłowa.

Uwagi

Spowoduje to wysłanie AFX_WM_CHANGE_ACTIVE_TAB powiadomienia do okna nadrzędnego i ramki nadrzędnej kontrolki karty.

Metoda SetActiveTab automatycznie wywołuje metodę CMFCTabCtrl::HideActiveWindowHorzScrollBar , aby uniemożliwić ekranu.

CMFCTabCtrl::SetActiveTabBoldFont

Włącza lub wyłącza używanie czcionki pogrubionej na aktywnych kartach.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Parametry

bIsBold
[in] TRUE aby użyć czcionki pogrubionej, aby wyświetlić etykietę aktywnej karty; FALSE aby wyświetlić etykietę przy użyciu czcionki standardowej. Domyślna wartość to TRUE.

Uwagi

CMFCTabCtrl::SetDrawFrame

Określa, czy prostokąt ramki jest rysowany wokół osadzonego paska.

void SetDrawFrame(BOOL bDraw=TRUE);

Parametry

bDraw
[in] TRUE aby wyświetlić prostokąt ramki wokół osadzonego paska; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

Uwagi

CMFCTabCtrl::SetFlatFrame

Określa, czy ma być rysowana płaska, czy ramka 3D wokół obszaru tabulacji.

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

Parametry

bFlat
[in] TRUE aby narysować płaską ramkę (2D) wokół obszaru tabulacji; FALSE aby narysować ramkę trójwymiarową (3D). Domyślna wartość to TRUE.

bRepaint
[in] TRUE aby od razu ponownie narysować okno; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

Uwagi

CMFCTabCtrl::SetImageList

Określa listę obrazów.

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

virtual BOOL SetImageList(HIMAGELIST hImageList);

Parametry

uiID
[in] Identyfikator zasobu mapy bitowej, który zawiera listę obrazów.

cx
[in] Szerokość każdego obrazu w pikselach. Wartość domyślna to 15.

clrTransp
[in] Przezroczysty kolor obrazu. Części obrazu, które są tym kolorem, będą przezroczyste. Wartość domyślna to kolor magenta, RGB(255,0,255).

hImageList
[in] Dojście do wstępnie załadowanej listy obrazów.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie. FALSE jeśli kontrolka karty jest tworzona przy użyciu stylu płaskiego lub jeśli pierwsze przeciążenie metody nie może załadować mapy bitowej określonej przez uiID parametr .

Uwagi

Użyj tej metody, aby ustawić listę obrazów dla kontrolki karty. Obrazy z listy obrazów są wyświetlane obok etykiety karty. Ta metoda ponownie oblicza wysokość karty, tak aby rozmiar karty zawierał zarówno obraz, jak i tekst.

CMFCBaseTabCtrl::AddTab Użyj metody dziedziczonej przez kontrolkę tabulacji, aby określić indeks obrazu do wyświetlenia.

CMFCTabCtrl::SetResizeMode

Określa sposób zmiany rozmiaru bieżącej kontrolki karty, a następnie ponowne redysponowanie kontrolki.

void SetResizeMode(ResizeMode resizeMode);

Parametry

resizeMode
[in] CMFCTabCtrl::ResizeMode Jedna z wartości wyliczenia, która określa, jak można zmienić rozmiar kontrolki karty. Aby uzyskać listę możliwych wartości, zobacz tabelę w uwagach.

Uwagi

Parametr resizeMode może być jedną z następujących ResizeMode wartości wyliczenia.

Nazwa/nazwisko	opis
RESIZE_NO	Nie można zmienić rozmiaru kontrolki karty.
RESIZE_VERT	Rozmiar kontrolki tabulatora można zmienić w pionie, ale nie poziomo.
RESIZE_HORIZ	Rozmiar kontrolki karty można zmienić w poziomie, ale nie w pionie.

CMFCTabCtrl::SetTabMaxWidth

Określa maksymalną szerokość karty w oknie z kartami.

void SetTabMaxWidth(int nTabMaxWidth);

Parametry

nTabMaxWidth
[in] Maksymalna szerokość karty w pikselach.

Uwagi

Użyj tej metody, aby ograniczyć szerokość każdej karty w oknie z kartami. Ta metoda jest przydatna, jeśli karty mają bardzo długie etykiety. CMFCTabCtrl Konstruktor klasy inicjuje maksymalną szerokość karty do 0, co oznacza, że szerokość nie jest ograniczona.

CMFCTabCtrl::StopResize

Przerywa bieżącą operację zmiany rozmiaru w kontrolce karty.

void StopResize(BOOL bCancel);

Parametry

bCancel
[in] TRUE aby porzucić bieżącą operację zmiany rozmiaru; FALSE aby ukończyć bieżącą operację zmiany rozmiaru. W obu przypadkach struktura zatrzymuje rysowanie prostokąta zmiany rozmiaru.

CMFCTabCtrl::SynchronizeScrollBar

Rysuje poziomy pasek przewijania na kontrolce karty, która wyświetla płaskie karty.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Parametry

pScrollInfo
[out] Wskaźnik do SCROLLINFO struktury lub NULL. Gdy ta metoda zwróci wartość , a jeśli ten parametr nie NULLjest , struktura zawiera wszystkie parametry paska przewijania. Domyślna wartość to NULL.

Wartość zwracana

TRUE jeśli ta metoda powiedzie się; w przeciwnym razie, FALSE.

Uwagi

Ta metoda ma wpływ tylko na kontrolkę tabulacji, która wyświetla płaskie karty. Pasek przewijania wpływa na wszystkie karty w tym samym czasie.

Zobacz też

Wykres hierarchii
Klasy
CDockablePane Klasa
CMFCBaseTabCtrl Klasa