Klasa CMFCBaseTabCtrl

Artykuł
10/12/2023

Implementuje podstawowe funkcje okien z kartami. Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

Składnia

class CMFCBaseTabCtrl : public CWnd

Elementy członkowskie

Metody publiczne

Nazwa/nazwisko	opis
CMFCBaseTabCtrl::AddIcon
CMFCBaseTabCtrl::AddTab	Dodaje nową kartę do okna z kartami.
CMFCBaseTabCtrl::ApplyRestoredTabInfo
CMFCBaseTabCtrl::AutoDestroyWindow
CMFCBaseTabCtrl::CalcRectEdit
CMFCBaseTabCtrl::CleanUp
CMFCBaseTabCtrl::ClearImageList
CMFCBaseTabCtrl::D etachTab	Odłącza kartę od okna z kartą.
CMFCBaseTabCtrl::EnableActivateLastActive
CMFCBaseTabCtrl::EnableAutoColor	Włącza lub wyłącza automatyczne kolorowanie kart.
CMFCBaseTabCtrl::EnableCustomToolTips	Włącza lub wyłącza niestandardowe etykietki narzędzi dla kart.
CMFCBaseTabCtrl::EnableInPlaceEdit	Włącza lub wyłącza bezpośrednie edytowanie etykiet kart.
CMFCBaseTabCtrl::EnableTabDetach	Włącza karty odłączane.
CMFCBaseTabCtrl::EnableTabSwap	Włącza lub wyłącza, czy użytkownik może zmienić kolejność tabulacji przy użyciu myszy.
CMFCBaseTabCtrl::EnsureVisible	Przewija karty, dopóki określona karta nie będzie widoczna. Ta metoda nie ma wpływu, jeśli określona karta jest już widoczna.
CMFCBaseTabCtrl::EnterDragMode
CMFCBaseTabCtrl::FindTargetWnd	Zwraca okienko zawierające określony punkt.
CMFCBaseTabCtrl::FireChangeActiveTab
CMFCBaseTabCtrl::FireChangingActiveTab
CMFCBaseTabCtrl::GetActiveTab	Zwraca indeks aktywnej karty.
CMFCBaseTabCtrl::GetActiveTabColor	Zwraca kolor tła aktywnej karty.
CMFCBaseTabCtrl::GetActiveTabTextColor	Zwraca kolor tekstu aktywnej karty.
CMFCBaseTabCtrl::GetActiveWnd	Zwraca wskaźnik aktywnej strony kontrolki karty.
CMFCBaseTabCtrl::GetAutoColors	Zwraca odwołanie do tablicy kolorów używanych do automatycznego kolorowania.
CMFCBaseTabCtrl::GetFirstVisibleTab	Zwraca wskaźnik do pierwszej widocznej karty.
CMFCBaseTabCtrl::GetFirstVisibleTabNum
CMFCBaseTabCtrl::GetHighlightedTab	Zwraca indeks aktualnie wyróżnionej karty.
CMFCBaseTabCtrl::GetImageList
CMFCBaseTabCtrl::GetImageSize
CMFCBaseTabCtrl::GetLastVisibleTab
CMFCBaseTabCtrl::GetLocation	Zwraca zmienną typu danych LOCATION, która wskazuje, gdzie obszar karty jest umieszczony względem kontrolki tabulacji. Na przykład na górze lub u dołu.
CMFCBaseTabCtrl::GetMaxWindowSize
CMFCBaseTabCtrl::GetTabArea	Zwraca rozmiar i położenie obszaru karty w oknie z kartami. Położenie obszaru tabulatora jest definiowane przy użyciu współrzędnych.
CMFCBaseTabCtrl::GetTabBkColor	Zwraca kolor tła określonej karty.
CMFCBaseTabCtrl::GetTabBorderSize	Zwraca rozmiar obramowania karty w kontrolce karty.
CMFCBaseTabCtrl::GetTabByID	Zwraca indeks karty identyfikowanej przez określony identyfikator.
CMFCBaseTabCtrl::GetTabCloseButton
CMFCBaseTabCtrl::GetTabFromHwnd	Zwraca indeks karty zawierającej określony obiekt HWND.
CMFCBaseTabCtrl::GetTabFromPoint	Zwraca kartę zawierającą określony punkt.
CMFCBaseTabCtrl::GetTabFullWidth
CMFCBaseTabCtrl::GetTabHicon	Zwraca ikonę skojarzona z określoną kartą.
CMFCBaseTabCtrl::GetTabID	Zwraca identyfikator karty przy użyciu indeksu karty.
CMFCBaseTabCtrl::GetTabIcon	Zwraca identyfikator ikony dla określonej karty.
CMFCBaseTabCtrl::GetTabLabel	Zwraca tekst określonej karty.
CMFCBaseTabCtrl::GetTabRect	Pobiera rozmiar i położenie określonej karty.
CMFCBaseTabCtrl::GetTabsHeight
CMFCBaseTabCtrl::GetTabsRect
CMFCBaseTabCtrl::GetTabTextColor	Zwraca kolor tekstu określonej karty.
CMFCBaseTabCtrl::GetTabWnd	Zwraca wskaźnik do okienka znajdującego się na określonej stronie karty.
CMFCBaseTabCtrl::GetTabWndNoWrapper	Zwraca wskaźnik bezpośredni do kontrolki znajdującej się na określonej stronie karty, nawet jeśli kontrolka ma otokę.
CMFCBaseTabCtrl::GetTabsNum	Zwraca liczbę kart zawartych w kontrolce tabulacji.
CMFCBaseTabCtrl::GetToolTipCtrl	Zwraca odwołanie do kontrolki etykietki narzędzia skojarzonej z obiektem `CMFCBaseTabCtrl` .
CMFCBaseTabCtrl::GetVisibleTabsNum	Zwraca liczbę widocznych kart.
CMFCBaseTabCtrl::HasImage
CMFCBaseTabCtrl::HideSingleTab	Ustawia opcję, która ukrywa kartę okna, ale tylko wtedy, gdy w oknie z kartami jest wyświetlana tylko jedna widoczna karta.
CMFCBaseTabCtrl::InsertTab	Wstawia nową kartę.
CMFCBaseTabCtrl::InvalidateTab
CMFCBaseTabCtrl::IsActiveTabCloseButton
CMFCBaseTabCtrl::IsAutoColor	Zwraca wartość wskazującą, czy okno z kartami jest w trybie automatycznego koloru.
CMFCBaseTabCtrl::IsAutoDestroyWindow
CMFCBaseTabCtrl::IsColored
CMFCBaseTabCtrl::IsDialogControl
CMFCBaseTabCtrl::IsDrawNoPrefix
CMFCBaseTabCtrl::IsFlatFrame	Zwraca wartość wskazującą, czy ramka obszaru tabulacji jest płaska, czy 3D.
CMFCBaseTabCtrl::IsFlatTab
CMFCBaseTabCtrl::IsHideSingleTab	Zwraca wartość wskazującą, czy kontrolka karty jest skonfigurowana do ukrywania karty, ale tylko wtedy, gdy okno z kartą ma tylko jedną widoczną kartę.
CMFCBaseTabCtrl::IsIconAdded
CMFCBaseTabCtrl::IsInPlaceEdit	Wskazuje, czy użytkownicy mogą modyfikować etykietę na karcie.
CMFCBaseTabCtrl::IsLeftRightRounded
CMFCBaseTabCtrl::IsMDITab
CMFCBaseTabCtrl::IsOneNoteStyle	Wskazuje, czy w oknie z kartami są wyświetlane karty w stylu programu Microsoft OneNote.
CMFCBaseTabCtrl::IsPtInTabArea	Sprawdza, czy w obszarze karty istnieje określony punkt.
CMFCBaseTabCtrl::IsTabCloseButtonHighlighted
CMFCBaseTabCtrl::IsTabCloseButtonPressed
CMFCBaseTabCtrl::IsTabDetachable	Wskazuje, czy karta jest odłączana.
CMFCBaseTabCtrl::IsTabiconOnly	Wskazuje, czy karty wyświetlają ikony, ale nie etykiety.
CMFCBaseTabCtrl::IsTabSwapEnabled	Wskazuje, czy użytkownik może zmieniać pozycje kart, przeciągając karty.
CMFCBaseTabCtrl::IsTabVisible	Wskazuje, czy określona karta jest widoczna.
CMFCBaseTabCtrl::IsVS2005Style
CMFCBaseTabCtrl::MoveTab
CMFCBaseTabCtrl::OnChangeTabs	Wywoływana przez platformę, gdy zmienia się liczba kart.
CMFCBaseTabCtrl::OnDragEnter
CMFCBaseTabCtrl::OnDragLeave
CMFCBaseTabCtrl::OnDragOver
CMFCBaseTabCtrl::OnDrop
CMFCBaseTabCtrl::OnRenameTab
CMFCBaseTabCtrl::P reTranslateMessage	Używany przez klasę CWinApp do tłumaczenia komunikatów okien przed ich wysłaniem do funkcji TranslateMessage i DispatchMessage systemu Windows. (Przesłonięcia) CWnd::P reTranslateMessage).
CMFCBaseTabCtrl::RecalcLayout	Oblicza ponownie układ wewnętrzny okna z kartami.
CMFCBaseTabCtrl::RemoveAllTabs	Usuwa wszystkie karty z okna z kartami.
CMFCBaseTabCtrl::RemoveTab	Usuwa kartę z okna z kartą.
CMFCBaseTabCtrl::RenameTab
CMFCBaseTabCtrl::ResetImageList	Resetuje listę obrazów dołączoną do okna z kartami.
CMFCBaseTabCtrl::Serialize	Odczytuje lub zapisuje ten obiekt z lub do archiwum. (Przesłonięcia) CObject::Serialize.)
CMFCBaseTabCtrl::SetActiveTab	Aktywuje kartę.
CMFCBaseTabCtrl::SetActiveTabColor	Ustawia kolor tła dla aktualnie aktywnej karty.
CMFCBaseTabCtrl::SetActiveTabTextColor	Ustawia kolor tekstu dla aktywnych kart.
CMFCBaseTabCtrl::SetAutoColors	Ustawia kolory kontrolek karty, które są stosowane w trybie automatycznego koloru.
CMFCBaseTabCtrl::SetDockingBarWrapperRTC	Ustawia klasę otoki używaną dla wszystkich obiektów, które nie pochodzą z klasy CDockablePane.
CMFCBaseTabCtrl::SetDrawNoPrefix	Włącza i wyłącza przetwarzanie znaków prefiksów podczas rysowania etykiet tabulacji.
CMFCBaseTabCtrl::SetImageList	Ustawia listę obrazów ikon.
CMFCBaseTabCtrl::SetLocation
CMFCBaseTabCtrl::SetTabBkColor	Ustawia kolor tła dla określonej karty.
CMFCBaseTabCtrl::SetTabBorderSize	Ustawia nowy rozmiar obramowania karty.
CMFCBaseTabCtrl::SetTabHicon	Ustawia ikonę karty.
CMFCBaseTabCtrl::SetTabIcon	Ustawia identyfikator ikony karty.
CMFCBaseTabCtrl::SetTabIconOnly	Włącza i wyłącza tryb "tylko ikona" dla określonej karty.
CMFCBaseTabCtrl::SetTabLabel	Ustawia etykietę karty równą określonej wartości ciągu.
CMFCBaseTabCtrl::SetTabsHeight
CMFCBaseTabCtrl::SetTabTextColor	Ustawia kolor tekstu dla określonej karty.
CMFCBaseTabCtrl::SetTabsOrder	Rozmieszcza karty w określonej kolejności.
CMFCBaseTabCtrl::ShowTab	Pokazuje lub ukrywa określoną kartę.
CMFCBaseTabCtrl::StartRenameTab
CMFCBaseTabCtrl::SwapTabs

Metody chronione

Nazwa/nazwisko	opis
CMFCBaseTabCtrl::CreateWrapper	Tworzy otokę dla obiektu pochodzącego z CWnd , który nie pochodzi z `CDockablePane`. Aby zadokować obiekt, każda `CMFCBaseTabCtrl` osadzona kontrolka musi mieć otokę dokowania lub pochodzić z `CDockablePane`elementu . Klasę otoki należy ustawić przy użyciu polecenia `SetDockingBayWrapperRTC`.

Składowe danych

Nazwa/nazwisko	opis
CMFCBaseTabCtrl::m_bActivateTabOnRightClick	Określa, czy karty są zaznaczone za pomocą kliknięcia lewym przyciskiem myszy, czy prawym kliknięciem myszy.
CMFCBaseTabCtrl::m_bAutoDestroyWindow	Określa, czy okienka znajdujące się na kartach są niszczone automatycznie.

Uwagi

Klasa CMFCBaseTabCtrl jest abstrakcyjną klasą. W związku z tym nie można utworzyć wystąpienia. Aby utworzyć okno z kartami, musisz utworzyć klasę z CMFCBaseTabCtrlklasy . Biblioteka MFC zawiera kilka przykładów klas pochodnych, z których dwie to klasa CMFCTabCtrl i klasa CMFCOutlookBarTabCtrl.

Począwszy od programu Visual Studio 2015, ta klasa obsługuje ułatwienia dostępu Microsoft Active.

Porady dotyczące dostosowywania

Następujące porady dotyczą CMFCBaseTabCtrl Class klas i, które dziedziczą z niej:

Jeśli włączysz odłączane karty, nie zachowaj wskaźników w oknach z kartami. Te odłączane karty można tworzyć i niszczyć dynamicznie. W związku z tym wskaźniki mogą stać się nieprawidłowe.
Kontrolkę tabulacji można skonfigurować tak, aby użytkownicy mogli dynamicznie przenosić karty na kontrolce tabulacji przy użyciu myszy. Ta funkcja jest wbudowana w klasę CMFCBaseTabCtrl . Aby ją włączyć, wywołaj metodę CMFCBaseTabCtrl::EnableTabSwap.
Domyślnie karty są odłączane po dodaniu ich do kontrolki tabulacji. Możesz również dodać karty niepodłączalne przy użyciu polecenia CMFCBaseTabCtrl::AddTab. Jeśli ustawisz parametr bDetachable na FALSEwartość , karta nie będzie odłączana. Można również zmienić, czy karty są odłączane, wywołując metodę CMFCBaseTabCtrl::EnableTabDetach.
Obiekty pochodzące z klasy CWnd można umieścić na pasku sterowania z możliwością dokowania lub karcie z możliwością dokowania. Aby cała kontrolka została zadokowana, należy ustawić CWnd obiekt zadokowany. W tym celu MFC używa klasy otoki. Ta klasa otoki jest klasą CDockablePaneAdapter. Wszystkie CWnd obiekty dodane do zadokowalnego paska sterowania lub karty z możliwością zadokowania zostaną opakowane wewnątrz CDockablePaneAdapter obiektu. Automatyczne opakowywanie można wyłączyć, ustawiając parametr m_bEnableWrapping CMFCBaseTablCtrl obiektu na FALSE. Możesz również zmienić klasę, której aplikacja będzie używać jako otoki, używając metody CMFCBaseTabCtrl::SetDockingBarWrapperRTC.

Hierarchia dziedziczenia

Wymagania

Nagłówek: afxbasetabctrl.h

CMFCBaseTabCtrl::AddIcon

Dodaje ikonę do listy ikon w chronionym CMap m_mapAddedIcons elemencie członkowskim.

void AddIcon(
    HICON hIcon,
    int iIcon);

Parametry

hIcon
[in] Uchwyt do ikony do dodania.

iIcon
[in] Indeks na podstawie zera ikony w chronionym CImageList m_Images elemencie członkowskim.

Uwagi

CMFCBaseTabCtrl::AddTab

Dodaje nową kartę do kontrolki karty.

virtual void AddTab(
    CWnd* pTabWnd,
    LPCTSTR lpszTabLabel,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

virtual void AddTab(
    CWnd* pTabWnd,
    UINT uiResTabLabel,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

Parametry

pTabWnd
[in] Wskaźnik do okna, który ta metoda reprezentuje jako nową kartę.

lpszTabLabel
[in] Ciąg zawierający etykietę nowej karty.

uiImageId
[in] Identyfikator obrazu z listy obrazów. Kontrolka karty używa tego obrazu jako ikony nowej karty.

uiResTabLabel
[in] Identyfikator zasobu etykiety.

Element bDetachable
[in] Parametr logiczny określający, czy nowa karta jest odłączana.

Uwagi

Jeśli pTabWnd wskazuje obiekt, który nie pochodzi z klasy CDockablePane, a jeśli element bDetachable ma wartość TRUE, platforma automatycznie tworzy otokę dla obiektu pTabWnd . Otoka sprawia, że obiekt pTabWnd jest odłączany. Domyślnie otoka jest wystąpieniem klasy CDockablePaneAdapter. Jeśli funkcjonalność oferowana przez domyślną otokę jest niedopuszczalna, użyj metody CMFCBaseTabCtrl::SetDockingBarWrapperRTC , aby określić inną otokę.

CMFCBaseTabCtrl::ApplyRestoredTabInfo

virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);

Parametry

[in] bUseTabIndexes

Uwagi

CMFCBaseTabCtrl::AutoDestroyWindow

void AutoDestroyWindow(BOOL bAutoDestroy = TRUE);

Parametry

[in] bAutoDestroy

Uwagi

CMFCBaseTabCtrl::CalcRectEdit

virtual void CalcRectEdit(CRect& rectEdit);

Parametry

[in] rectEdit

Uwagi

CMFCBaseTabCtrl::CleanUp

virtual void CleanUp();

Uwagi

CMFCBaseTabCtrl::ClearImageList

virtual void ClearImageList();

Uwagi

CMFCBaseTabCtrl::CreateWrapper

Tworzy otokę dla okna ramki pochodzącego z klasy CWnd, ale nie pochodzi z klasy CDockablePane.

virtual CWnd* CreateWrapper(
    CWnd* pWndToWrap,
    LPCTSTR lpszTabLabel,
    BOOL bDetachable);

Parametry

pWndToWrap
[in] Wskaźnik do okna ramki, który jest opakowany.

lpszTabLabel
[in] Ciąg zawierający etykietę okna.

Element bDetachable
[in] Parametr logiczny wskazujący, czy okno jest odłączane.

Wartość zwracana

Wskaźnik do otoki pochodzącej CDockablePane z klasy, jeśli CreateWrapper pomyślnie utworzy klasę otoki dla elementu pWndToWrap. Jeśli metoda zakończy się niepowodzeniem, zwraca wartość pWndToWrap.

Uwagi

Okno z kartami może zadokować dowolny obiekt pochodzący z CWndklasy . Jednak aby CMFCBaseTabCtrl Class obiekt można było zadokować, każdy obiekt na obiekcie CMFCBaseTabCtrl musi być odłączany. CMFCBaseTabCtrl W związku z tym automatycznie opakowuje wszystkie obiekty, które nie pochodzą z CDockablePaneelementu .

Domyślnie obiekt CMFCBaseTabCtrl tworzy wystąpienia klasy CDockablePaneAdapter. Aby zmienić domyślną klasę otoki, wywołaj metodę CMFCBaseTabCtrl::SetDockingBarWrapperRTC.

Jeśli pWndToWrap pochodzi z CDockablePanemetody , ta metoda nie utworzy otoki. Zamiast tego zakończy się niepowodzeniem i zwróci wartość pWndToWrap.

CMFCBaseTabCtrl::D etachTab

Struktura wywołuje tę metodę, aby odłączyć kartę od kontrolki tabulacji.

virtual BOOL DetachTab(
    AFX_DOCK_METHOD dockMethod,
    int nTabNum = -1,
    BOOL bHide = FALSE);

Parametry

dockMethod
[in] Wyliczony typ danych dostarczony przez klasę CBasePane. Ten typ danych określa metodę, która została użyta do odłączenia karty.

nTabNum
[in] Indeks zera karty do odłączenia.

bHide
[in] Parametr logiczny wskazujący, czy struktura powinna ukryć odłączone karty.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Jeśli karta określona przez nTabNum nie jest odłączana, ta funkcja kończy się niepowodzeniem i zwraca wartość FALSE.

CMFCBaseTabCtrl::EnableActivateLastActive

void EnableActivateLastActive(BOOL bLastActive = TRUE);

Parametry

[in] bLastActive

Uwagi

CMFCBaseTabCtrl::EnableAutoColor

Określa, czy platforma używa automatycznych kolorów tła podczas rysowania karty.

void EnableAutoColor(BOOL bEnable = TRUE);

Parametry

bEnable
[in] Parametr logiczny określający, czy platforma używa kolorów automatycznych.

Uwagi

Kontrolka karty ma tablicę kilku wstępnie zdefiniowanych kolorów. Gdy platforma używa kolorów automatycznych, każda karta w serii kart ma przypisany następny kolor z tej tablicy.

Domyślnie kolory automatyczne są określane przez kolory zdefiniowane przez bibliotekę. Możesz podać niestandardową tablicę kolorów, wywołując metodę CMFCBaseTabCtrl::SetAutoColors.

CMFCBaseTabCtrl::EnableCustomToolTips

Włącza niestandardowe etykietki narzędzi dla kontrolki karty.

BOOL EnableCustomToolTips(BOOL bEnable = TRUE);

Parametry

bEnable
[in] Wartość logiczna określająca, czy używać niestandardowych etykietek narzędzi.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Jeśli niestandardowe etykietki narzędzi są włączone, kontrolka tabulatora wysyła komunikat AFX_WM_ON_GET_TAB_TOOLTIP do ramki głównej. Jeśli chcesz obsługiwać niestandardowe etykietki narzędzi w aplikacji, główne okno ramki musi obsłużyć tę metodę i podać niestandardowy tekst etykietki narzędzia. Aby uzyskać więcej informacji na temat udostępniania niestandardowego tekstu etykietki narzędzia, zobacz CMFCTabToolTipInfo Structure (Struktura CMFCTabToolTipInfo).

CMFCBaseTabCtrl::EnableInPlaceEdit

Umożliwia bezpośrednie edytowanie etykiet kart przez użytkownika.

virtual void EnableInPlaceEdit(BOOL bEnable) = 0;

Parametry

bEnable
[in] Parametr logiczny określający, czy włączyć bezpośrednie edytowanie etykiet kart.

Uwagi

Domyślnie bezpośrednie edytowanie etykiet kart jest wyłączone dla kontrolek tabulacji.

Bezpośrednie edytowanie dla podzestawu kart w kontrolce karty można włączyć. W tym celu przesłoń metodę CMFCBaseTabCtrl::StartRenameTab. StartRenameTab powinna zwracać wartość niezerową dla wszystkich kart, które obsługują bezpośrednie edytowanie etykiet tabulacji.

W metodzie CMFCBaseTabCtrl Classta metoda jest czystą funkcją wirtualną i nie ma implementacji. Jeśli utworzysz klasę z CMFCBaseTabCtrlklasy , musisz zaimplementować tę funkcję.

CMFCBaseTabCtrl::EnableTabDetach

Włącza karty odłączane.

virtual BOOL EnableTabDetach(
    int iTab,
    BOOL bEnable);

Parametry

iTab
[in] Indeks oparty na zerach karty.

bEnable
[in] Wartość logiczna wskazująca, czy karta jest odłączana.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

CMFCBaseTabCtrl::EnableTabSwap

Umożliwia użytkownikowi zmianę kolejności tabulacji przy użyciu myszy.

void EnableTabSwap(BOOL bEnable);

Parametry

bEnable
[in] Wartość logiczna wskazująca, czy włączyć zamianę kart.

Uwagi

Po włączeniu zamiany kart użytkownik może przeciągnąć kartę i zmienić jej względną pozycję w kontrolce karty.

CMFCBaseTabCtrl::EnsureVisible

Przewija karty, dopóki określona karta nie będzie widoczna.

virtual BOOL EnsureVisible(int iTab);

Parametry

iTab
[in] Indeks oparty na zerach karty.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Ta metoda nie ma wpływu, jeśli karta wskazywana przez kartę iTab jest już widoczna.

Domyślnie ta metoda nie jest obsługiwana przez program CMFCBaseTabCtrl Class. Tę funkcję należy zaimplementować w klasie niestandardowej pochodnej, CMFCBaseTabCtrl jeśli ta niestandardowa kontrolka karty obsługuje przewijanie kart. Ta metoda jest obsługiwana przez klasę CMFCTabCtrl.

CMFCBaseTabCtrl::EnterDragMode

void EnterDragMode();

Uwagi

CMFCBaseTabCtrl::FindTargetWnd

Identyfikuje okienko zawierające określony punkt.

virtual CWnd* FindTargetWnd(const CPoint& pt) = 0;

Parametry

Pt
[in] Punkt zdefiniowany przy użyciu współrzędnych obszaru klienta obiektu CMFCBaseTabCtrl .

Wartość zwracana

Wskaźnik do obiektu CWnd , jeśli się powiedzie; w przeciwnym razie wartość NULL.

Uwagi

CMFCBaseTabCtrl W klasie ta metoda jest czystą funkcją wirtualną: należy ją zaimplementować, jeśli utworzysz klasę z CMFCBaseTabCtrlklasy .

CMFCBaseTabCtrl::FireChangeActiveTab

virtual void FireChangeActiveTab(int nNewTab);

Parametry

[in] nNewTab

Uwagi

CMFCBaseTabCtrl::FireChangingActiveTab

virtual BOOL FireChangingActiveTab(int nNewTab);

Parametry

[in] nNewTab

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::GetActiveTab

Pobiera indeks aktualnie aktywnej karty.

virtual int GetActiveTab() const;

Wartość zwracana

Indeks na podstawie zera aktywnej karty; -1, jeśli nie ma aktywnej karty.

CMFCBaseTabCtrl::GetActiveTabColor

Pobiera kolor tła aktualnie aktywnej karty.

virtual COLORREF GetActiveTabColor() const;

Wartość zwracana

Wartość COLORREF określająca kolor tła aktywnej karty.

Uwagi

Domyślnie kolor tła aktywnej karty jest COLOR_WINDOW. Kolor tła aktywnej karty można zmienić przy użyciu metody CMFCBaseTabCtrl::SetActiveTabColor.

CMFCBaseTabCtrl::GetActiveTabTextColor

Pobiera kolor tekstu dla aktywnej karty.

virtual COLORREF GetActiveTabTextColor() const;

Wartość zwracana

Wartość COLORREF określająca kolor tekstu aktywnej karty.

Uwagi

Domyślnie kolor tekstu aktywnych kart jest COLOR_WINDOWTEXT. Kolor tekstu można zmienić za pomocą metody CMFCBaseTabCtrl::SetActiveTabTextColor.

CMFCBaseTabCtrl::GetActiveWnd

Pobiera wskaźnik do aktualnie aktywnego okna karty.

virtual CWnd* GetActiveWnd() const;

Wartość zwracana

Wskaźnik do okna.

CMFCBaseTabCtrl::GetAutoColors

Pobiera tablicę kolorów używanych do automatycznego kolorowania.

const CArray<COLORREF,COLORREF>& GetAutoColors() const;

Wartość zwracana

Odwołanie do tablicy wartości COLORREF używanych przez obiekt CMFCBaseTabCtrl do automatycznego kolorowania kart.

Uwagi

Domyślnie struktura inicjuje tablicę kolorów do kolorów zdefiniowanych przez bibliotekę. Możesz podać niestandardową tablicę kolorów, wywołując metodę CMFCBaseTabCtrl::SetAutoColors.

CMFCBaseTabCtrl::GetFirstVisibleTab

Pobiera wskaźnik do pierwszej widocznej karty.

virtual CWnd* GetFirstVisibleTab(int& iTabNum);

virtual CWnd* GetFirstVisibleTab(
    int iStartFrom,
    int& iTabNum);

Parametry

iTabNum
[out] Odwołanie do liczby całkowitej. Ta metoda zapisuje indeks na podstawie zera pierwszej widocznej karty do tego parametru.

iStartFrom
[in] Indeks na podstawie zera pierwszej karty do sprawdzenia.

Wartość zwracana

Wskaźnik do pierwszej widocznej karty, jeśli się powiedzie; w przeciwnym razie wartość NULL.

Uwagi

Jeśli ta metoda nie powiedzie się, zapisuje wartość -1 na iStartFrom.

Jeśli właściwość iStartFrom jest większa lub równa liczbie kart w kontrolce karty, GetFirstVisibleTab automatycznie kończy się niepowodzeniem.

CMFCBaseTabCtrl::GetFirstVisibleTabNum

virtual int GetFirstVisibleTabNum() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::GetHighlightedTab

Pobiera indeks aktualnie wyróżnionej karty.

int GetHighlightedTab() const;

Wartość zwracana

Indeks zerowy wyróżnionej karty.

CMFCBaseTabCtrl::GetImageList

virtual const CImageList* GetImageList() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::GetImageSize

virtual CSize GetImageSize() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::GetLastVisibleTab

virtual CWnd* GetLastVisibleTab(int& iTabNum);

Parametry

[in] iTabNum

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::GetLocation

Pobiera lokalizację części obszaru tabulacji kontrolki tabulacji.

Location GetLocation() const;

Wartość zwracana

Lokalizacja obszaru karty.

Uwagi

Możliwe wartości lokalizacji obszaru tabulacji są LOCATION_BOTTOM i LOCATION_TOP.

CMFCBaseTabCtrl::GetMaxWindowSize

virtual CSize GetMaxWindowSize() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::GetTabArea

Pobiera rozmiar i położenie obszaru karty kontrolki tabulacji.

virtual void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const = 0;

Parametry

rectTabAreaTop
[in] Odwołanie do CRect obiektu. GetTabArea używa tego obiektu do przechowywania rozmiaru i położenia górnego obszaru karty.

rectTabAreaBottom
[in] Odwołanie do CRect obiektu. GetTabArea używa tego obiektu do przechowywania rozmiaru i położenia dolnego obszaru karty.

Uwagi

Po GetTabArea powrocie CRect parametry zawierają rozmiar i położenie obszaru tabulacji we współrzędnych klienta kontrolki tabulacji. Jeśli w górnej lub dolnej części kontrolki karty nie ma obszaru tabulatora lub rectTabAreaTop rectTabAreaBottom są puste.

W metodzie CMFCBaseTabCtrl Classta metoda jest czystą funkcją wirtualną i nie ma implementacji. Jeśli utworzysz klasę z CMFCBaseTabCtrlklasy , musisz zaimplementować tę funkcję.

CMFCBaseTabCtrl::GetTabBkColor

Pobiera kolor tła określonej karty.

virtual COLORREF GetTabBkColor(int iTab) const;

Parametry

iTab
[in] Indeks na karcie oparty na zerach.

Wartość zwracana

Wartość COLORREF wskazująca kolor tła określonej karty; -1, jeśli element iTab jest poza zakresem.

CMFCBaseTabCtrl::GetTabBorderSize

Pobiera rozmiar obramowania karty w kontrolce karty.

virtual int GetTabBorderSize() const;

Wartość zwracana

Rozmiar obramowania karty w pikselach.

Uwagi

Domyślny rozmiar obramowania karty to trzy piksele. Ten rozmiar obramowania można zmienić za pomocą metody CMFCBaseTabCtrl::SetTabBorderSize.

CMFCBaseTabCtrl::GetTabByID

Pobiera indeks karty na podstawie identyfikatora karty.

virtual int GetTabByID(int id) const;

Parametry

id
[in] Identyfikator karty.

Wartość zwracana

Indeks karty oparty na zera, jeśli zostanie znaleziony; -1, jeśli nie znaleziono identyfikatora karty.

Uwagi

Identyfikatory kart są przypisywane automatycznie, gdy karty są dodawane do kontrolki karty.

CMFCBaseTabCtrl::GetTabCloseButton

CRect GetTabCloseButton() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::GetTabFromHwnd

Pobiera indeks karty zawierającej określony obiekt HWND.

virtual int GetTabFromHwnd(HWND hwnd) const;

Parametry

hwnd
[in] Uchwyt do okna.

Wartość zwracana

Jeśli to się powiedzie, indeks karty jest oparty na zerach; -1, jeśli żadna karta nie zawiera hwnd.

CMFCBaseTabCtrl::GetTabFromPoint

Pobiera kartę zawierającą określony punkt.

virtual int GetTabFromPoint(CPoint& pt) const;

Parametry

Pt
[in] Punkt we współrzędnych klienta kontrolki karty.

Wartość zwracana

Indeks karty zawierającej pkt; -1, jeśli żadna karta nie zawiera pkt.

CMFCBaseTabCtrl::GetTabFullWidth

virtual int GetTabFullWidth(int iTab) const;

Parametry

[in] iTab

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::GetTabHicon

Zwraca hiCON skojarzony z określoną kartą.

virtual HICON GetTabHicon(int iTab) const;

Parametry

iTab
[in] Indeks oparty na zera dla karty.

Wartość zwracana

HiCON skojarzony z etykietą karty, jeśli się powiedzie; Wartość NULL, jeśli nie ma HICON lub jeśli metoda nie powiedzie się.

CMFCBaseTabCtrl::GetTabIcon

Pobiera ikonę skojarzona z określoną kartą.

virtual UINT GetTabIcon(int iTab) const;

Parametry

iTab
[in] Indeks na karcie oparty na zerach.

Wartość zwracana

Jeśli ta karta zakończy się pomyślnie, identyfikator ikony dla określonej karty; -1, jeśli indeks jest nieprawidłowy.

Uwagi

Obiekt CMFCBaseTabCtrl przechowuje ikony w wewnętrznym obiekcie CImageList .

CMFCBaseTabCtrl::GetTabID

Pobiera identyfikator karty określonej przez indeks tabulacji.

int GetTabID(int iTab) const;

Parametry

iTab
[in] Indeks na karcie oparty na zerach.

Wartość zwracana

Identyfikator karty lub -1, jeśli element iTab jest poza zakresem.

CMFCBaseTabCtrl::GetTabLabel

Pobiera tekst etykiety karty.

virtual BOOL GetTabLabel(
    int iTab,
    CString& strLabel) const;

Parametry

iTab
[in] Indeks na karcie oparty na zerach.

strLabel
[out] Odwołanie do CString obiektu. Ta metoda przechowuje etykietę karty w tym parametrze.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; FAŁSZ w przeciwnym razie.

Uwagi

Ta metoda kończy się niepowodzeniem, jeśli indeks iTab jest nieprawidłowy.

Etykietę dla karty można ustawić podczas tworzenia karty przy użyciu polecenia CMFCBaseTabCtrl::AddTab. Etykietę można również zmienić po utworzeniu za pomocą metody CMFCBaseTabCtrl::SetTabLabel.

CMFCBaseTabCtrl::GetTabRect

Pobiera rozmiar i położenie określonej karty.

virtual BOOL GetTabRect(
    int iTab,
    CRect& rect) const;

Parametry

iTab
[in] Indeks na karcie oparty na zerach.

Rect
[out] Odwołanie do CRect obiektu. Ta metoda przechowuje rozmiar i położenie karty w tym parametrze.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; FAŁSZ, jeśli indeks karty jest nieprawidłowy.

CMFCBaseTabCtrl::GetTabsHeight

virtual int GetTabsHeight() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::GetTabsNum

Pobiera liczbę kart w kontrolce karty.

virtual int GetTabsNum() const;

Wartość zwracana

Liczba kart w kontrolce karty.

CMFCBaseTabCtrl::GetTabsRect

virtual void GetTabsRect(CRect& rect) const;

Parametry

[in] Rect

Uwagi

CMFCBaseTabCtrl::GetTabTextColor

Pobiera kolor tekstu dla określonej karty.

virtual COLORREF GetTabTextColor(int iTab) const;

Parametry

iTab
[in] Indeks na karcie oparty na zerach.

Wartość zwracana

Parametr COLORREF wskazujący kolor tekstu określonej karty; -1, jeśli element iTab jest poza zakresem.

CMFCBaseTabCtrl::GetTabWnd

Zwraca wskaźnik do okienka znajdującego się na określonej karcie.

virtual CWnd* GetTabWnd(int iTab) const;

Parametry

iTab
[in] Indeks oparty na zerach karty.

Wartość zwracana

Wskaźnik do obiektu CWnd , który znajduje się na karcie określonej przez iTab . Wartość NULL, jeśli element iTab jest nieprawidłowy.

Uwagi

Zwrócony obiekt jest obiektem dodanym przez aplikację po wywołaniu polecenia CMFCBaseTabCtrl::AddTab lub CMFCBaseTabCtrl::InsertTab.

Jeśli obiekt na karcie ma otokę, ta metoda zwróci otokę obiektu. Aby uzyskać więcej informacji na temat otoek, zobacz CMFCBaseTabCtrl::CreateWrapper. Jeśli chcesz uzyskać dostęp do wskaźnika do obiektu bezpośredniego bez otoki, użyj metody CMFCBaseTabCtrl::GetTabWndNoWrapper.

CMFCBaseTabCtrl::GetTabWndNoWrapper

Zwraca wskaźnik do kontrolki znajdującej się na karcie, nawet jeśli kontrolka ma otokę.

virtual CWnd* GetTabWndNoWrapper(int iTab) const;

Parametry

iTab
[in] Indeks oparty na zerach karty.

Wartość zwracana

Wskaźnik do obiektu CWnd , który znajduje się na określonej karcie; Wartość NULL, jeśli element iTab jest nieprawidłowy.

Uwagi

Ta metoda pobiera bezpośredni wskaźnik do CWnd obiektu, który został dodany przy użyciu metody CMFCBaseTabCtrl::AddTab lub CMFCBaseTabCtrl::InsertTab. GetTabWndNoWrapper Program pobierze wskaźnik do dodanego CWndobiektu , nawet jeśli struktura dodała otokę dla obiektu. Aby uzyskać więcej informacji na temat otoek i klasy CMFCBaseTabCtrl, zobacz CMFCBaseTabCtrl::CreateWrapper.

Użyj metody CMFCBaseTabCtrl::GetTabWnd , jeśli nie chcesz ignorować klasy otoki.

CMFCBaseTabCtrl::GetToolTipCtrl

Pobiera odwołanie do contorl etykietki narzędzia.

CToolTipCtrl& GetToolTipCtrl() const;

Wartość zwracana

Odwołanie do kontrolki etykietki narzędzia.

CMFCBaseTabCtrl::GetVisibleTabsNum

Pobiera liczbę aktualnie widocznych kart.

virtual int GetVisibleTabsNum() const;

Wartość zwracana

Liczba widocznych kart.

CMFCBaseTabCtrl::HasImage

virtual BOOL HasImage(int iTab) const;

Parametry

[in] iTab

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::HideSingleTab

Ustawia opcję ukrywania kart dla kontrolki karty, gdy istnieje jedna widoczna karta.

virtual void HideSingleTab(BOOL bHide = TRUE);

Parametry

bHide
[in] Wartość logiczna określająca, czy włączyć ukrywanie pojedynczych kart.

Uwagi

Po skonfigurowaniu aplikacji do ukrywania pojedynczych kart platforma automatycznie wyświetla karty po dodaniu drugiej karty do kontrolki karty.

CMFCBaseTabCtrl::InsertTab

Wstawia kartę do kontrolki karty.

Virtual void InsertTab(
    CWnd* pNewWnd,
    LPCTSTR lpszTabLabel,
    int nInsertAt,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

virtual void InsertTab(
    CWnd* pNewWnd,
    UINT uiResTabLabel,
    int nInsertAt,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

Parametry

pNewWnd
[in] Wskaźnik do okna, które ta metoda dodaje jako nową kartę.

lpszTabLabel
[in] Ciąg zawierający etykietę nowej karty.

nInsertAt
[in] Indeks oparty na zera nowej karcie.

uiImageId
[in] Identyfikator obrazu z listy obrazów. Kontrolka karty używa tego obrazu jako ikony nowej karty.

Element bDetachable
[in] Parametr logiczny określający, czy nowa karta jest odłączana.

uiResTabLabel
[in] Identyfikator zasobu etykiety.

Uwagi

Jeśli obiekt wskazany przez pNewWnd nie pochodzi z klasy CDockablePane, a jeśli parametr bDetachable ma wartość TRUE, struktura tworzy specjalną otokę dla nowej karty. Domyślnie otoka jest wystąpieniem klasy CDockablePaneAdapter. Użyj metody CMFCBaseTabCtrl::SetDockingBarWrapperRTC, aby utworzyć inną klasę otoki. Każda niestandardowa klasa otoki musi pochodzić z CDockablePaneAdapterklasy .

CMFCBaseTabCtrl::InvalidateTab

void InvalidateTab(int iTab);

Parametry

[in] iTab

Uwagi

CMFCBaseTabCtrl::IsActiveTabCloseButton

virtual BOOL IsActiveTabCloseButton() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::IsAutoColor

Określa, czy kontrolka karty jest w trybie automatycznego kolorowania.

BOOL IsAutoColor() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli kontrolka karty jest w trybie automatycznego kolorowania; FAŁSZ w przeciwnym razie.

Uwagi

Tryb automatycznego kolorowania można włączyć lub wyłączyć przy użyciu metody CMFCBaseTabCtrl::EnableAutoColor .

CMFCBaseTabCtrl::IsAutoDestroyWindow

BOOL IsAutoDestroyWindow() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::IsColored

virtual BOOL IsColored() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::IsDialogControl

BOOL IsDialogControl() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::IsDrawNoPrefix

BOOL IsDrawNoPrefix() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::IsFlatFrame

Wskazuje, czy ramka kontrolki tabulacji jest renderowana w stylu płaskim, czy w stylu 3D.

virtual BOOL IsFlatFrame() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli ramka kontrolki tabulacji jest renderowana w stylu płaskim; FAŁSZ, jeśli ramka jest renderowana w stylu 3D.

Uwagi

Użyj polecenia CMFCTabCtrl::SetFlatFrame , aby zmienić styl ramki kontrolki tabulacji.

Kontrolki tabulacji używające stylu programu Outlook nie mogą być renderowane z płaskimi ramkami. Obejmuje to klasę CMFCOutlookBarTabCtrl i wszystkie klasy pochodzące z tej klasy.

CMFCBaseTabCtrl::IsFlatTab

virtual BOOL IsFlatTab() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::IsHideSingleTab

Określa, czy kontrolka karty ukrywa etykietę karty, jeśli istnieje tylko jedna karta.

virtual BOOL IsHideSingleTab() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli kontrolka karty ukrywa etykietę karty, gdy ma jedną kartę; w przeciwnym razie FAŁSZ.

Uwagi

Użyj metody CMFCBaseTabCtrl::HideSingleTab, aby włączyć ukrywanie etykiety tabulacji, gdy istnieje tylko jedna karta.

CMFCBaseTabCtrl::IsIconAdded

BOOL IsIconAdded(
    HICON hIcon,
    int& iIcon);

Parametry

[in] hIcon

[in] iIcon

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::IsInPlaceEdit

Wskazuje, czy kontrolka karty jest skonfigurowana tak, aby umożliwić użytkownikowi dynamiczne modyfikowanie etykiet kart.

virtual BOOL IsInPlaceEdit() const;

Wartość zwracana

Niezerowe, jeśli jest włączona edycja w miejscu; w przeciwnym razie 0.

Uwagi

Edytowanie w miejscu można włączyć lub wyłączyć, wywołując metodę CMFCBaseTabCtrl::EnableInPlaceEdit.

CMFCBaseTabCtrl::IsLeftRightRounded

virtual BOOL IsLeftRightRounded() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::IsMDITab

BOOL IsMDITab() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::IsOneNoteStyle

Określa, czy karty są wyświetlane w stylu programu Microsoft OneNote.

virtual BOOL IsOneNoteStyle() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli karty są wyświetlane w stylu programu Microsoft OneNote; w przeciwnym razie FAŁSZ.

Uwagi

Wywołaj metodę CMDIFrameWndEx::EnableMDITabs , aby włączyć styl programu Microsoft OneNote. Ten styl można również włączyć po utworzeniu wystąpienia klasy CMFCTabCtrl: wystarczy przekazać STYLE_3D_ONENOTE stylu do metody CMFCTabCtrl::Create.

Domyślnie styl programu Microsoft OneNote nie jest obsługiwany w klasie niestandardowej pochodzącej z klasy CMFCBaseTabCtrl Class. Jest on jednak obsługiwany w CMFCTabCtrl klasie .

CMFCBaseTabCtrl::IsPtInTabArea

Określa, czy punkt znajduje się wewnątrz obszaru karty.

virtual BOOL IsPtInTabArea(CPoint point) const = 0;

Parametry

punkt
[in] Punkt do przetestowania.

Wartość zwracana

Nonzero, jeśli punkt znajduje się w obszarze tabulacji; 0 w przeciwnym razie.

Uwagi

W metodzie CMFCBaseTabCtrl Classta metoda jest czystą funkcją wirtualną i nie ma implementacji. Jeśli utworzysz klasę z CMFCBaseTabCtrlklasy , musisz zaimplementować tę funkcję.

CMFCBaseTabCtrl::IsTabCloseButtonHighlighted

BOOL IsTabCloseButtonHighlighted() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::IsTabCloseButtonPressed

BOOL IsTabCloseButtonPressed() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::IsTabDetachable

Określa, czy karta jest odłączana.

virtual BOOL IsTabDetachable(int iTab) const;

Parametry

iTab
[in] Indeks zera karty do sprawdzenia.

Wartość zwracana

WARTOŚĆ TRUE, jeśli karta jest odłączona; FAŁSZ w przeciwnym razie.

Uwagi

Aby odłączyć kartę, użyj metody CMFCBaseTabCtrl::EnableTabDetach.

CMFCBaseTabCtrl::IsTabiconOnly

Określa, czy etykieta karty zawiera tylko ikony i żaden tekst.

virtual BOOL IsTabIconOnly(int iTab) const;

Parametry

iTab
[in] Indeks na karcie oparty na zerach.

Wartość zwracana

WARTOŚĆ TRUE, jeśli etykieta karty ma tylko ikony; FAŁSZ w przeciwnym razie.

Uwagi

Aby ustawić karty w aplikacji tak, aby wyświetlały tylko ikony, wywołaj metodę CMFCBaseTabCtrl::SetTabIconOnly.

CMFCBaseTabCtrl::IsTabSwapEnabled

Określa, czy kontrolka tabulatora umożliwia użytkownikowi zmianę pozycji tabulatora przy użyciu myszy.

BOOL IsTabSwapEnabled() const;

Wartość zwracana

Niezerowe, jeśli pozycje tabulacji mogą być zmieniane przez użytkownika; w przeciwnym razie 0.

Uwagi

Domyślnie użytkownicy nie mogą zmieniać kolejności kart w kontrolce karty. Użyj metody CMFCBaseTabCtrl::EnableTabSwap, aby włączyć tę funkcję.

CMFCBaseTabCtrl::IsTabVisible

Wskazuje, czy określona karta jest widoczna.

virtual BOOL IsTabVisible(int iTab) const;

Parametry

iTab
[in] Indeks zera karty do sprawdzenia.

Wartość zwracana

Niezerowe, jeśli określona karta jest widoczna; w przeciwnym razie 0.

CMFCBaseTabCtrl::IsVS2005Style

virtual BOOL IsVS2005Style() const;

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::m_bActivateTabOnRightClick

m_bActivateTabOnRightClick określa, czy karty znajdują się w fokusie, gdy użytkownik kliknie etykietę karty przy użyciu prawego przycisku myszy.

BOOL m_bActivateTabOnRightClick;

Uwagi

Wartość domyślna dla tego elementu członkowskiego danych to FALSE.

CMFCBaseTabCtrl::m_bAutoDestroyWindow

m_bAutoDestroyWindow określa, czy struktura automatycznie niszczy obiekty na kartach po usunięciu kart.

BOOL m_bAutoDestroyWindow;

Uwagi

Domyślnie ten element członkowski ma wartość FALSE.

CMFCBaseTabCtrl::MoveTab

virtual void MoveTab(
    int nSource,
    int nDest);

Parametry

[in] nSource

[in] nDest

Uwagi

CMFCBaseTabCtrl::OnChangeTabs

Struktura wywołuje tę metodę, gdy zmienia się liczba kart w kontrolce karty.

virtual void OnChangeTabs();

Uwagi

Domyślnie ta metoda nic nie robi. Zastąpij tę metodę, aby wykonać kod niestandardowy, gdy zmienia się liczba kart w kontrolce karty.

CMFCBaseTabCtrl::OnDrop

virtual BOOL OnDrop(
    COleDataObject*,
    DROPEFFECT,
    CPoint);

Parametry

[in] COleDataObject*

[in] DROPEFFECT

[in] CPoint

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::OnDragOver

virtual DROPEFFECT OnDragOver(
    COleDataObject*,
    DWORD,
    CPoint);

Parametry

[in] COleDataObject*

[in] DWORD

[in] CPoint

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::OnDragLeave

virtual void OnDragLeave();

Uwagi

CMFCBaseTabCtrl::OnDragEnter

virtual DROPEFFECT OnDragEnter(
    COleDataObject*,
    DWORD,
    CPoint);

Parametry

[in] COleDataObject*

[in] DWORD

[in] CPoint

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::OnRenameTab

virtual BOOL OnRenameTab(int, CString&);

Parametry

[in] Int

[in] CString &

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametry

[in] PMsg

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::RecalcLayout

Oblicza ponownie układ wewnętrzny kontrolki tabulacji.

virtual void RecalcLayout() = 0;

Uwagi

W metodzie CMFCBaseTabCtrl Classta metoda jest czystą funkcją wirtualną. Jeśli utworzysz klasę z CMFCBaseTabCtrlklasy , musisz zaimplementować tę funkcję.

CMFCBaseTabCtrl::RemoveAllTabs

Usuwa wszystkie karty z kontrolki karty.

virtual void RemoveAllTabs();

Uwagi

Jeśli właściwość CMFCBaseTabCtrl::m_bAutoDestroyWindow ma wartość TRUE, struktura usuwa wszystkie obiekty CWnd dołączone do usuniętych kart.

CMFCBaseTabCtrl::RemoveTab

Usuwa kartę z kontrolki karty.

virtual BOOL RemoveTab(
    int iTab,
    BOOL bRecalcLayout = TRUE);

Parametry

iTab
[in] Indeks oparty na zerach karty.

bRecalcLayout
[in] Parametr logiczny określający, czy należy ponownie obliczyć układ karty.

Wartość zwracana

Wartość TRUE, jeśli metoda pomyślnie usunie kartę; w przeciwnym razie FAŁSZ.

Uwagi

Jeśli właściwość CMFCBaseTabCtrl::m_bAutoDestroyWindow ma wartość TRUE, RemoveTab niszczy obiekt CWnd skojarzony z określoną kartą.

CMFCBaseTabCtrl::RenameTab

virtual BOOL RenameTab();

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::ResetImageList

Resetuje listę obrazów dla wystąpienia klasy CMFCBaseTabCtrl.

void ResetImageList();

CMFCBaseTabCtrl::Serialize

virtual void Serialize(CArchive& ar);

Parametry

[in] Ar

Uwagi

CMFCBaseTabCtrl::SetActiveTab

Aktywuje określoną kartę.

virtual BOOL SetActiveTab(int iTab) = 0;

Parametry

iTab
[in] Indeks oparty na zerach karty. SetActiveTab powoduje, że karta z tym indeksem jest aktywna.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

W metodzie CMFCBaseTabCtrl Classta metoda jest czystą funkcją wirtualną. Jeśli utworzysz klasę z CMFCBaseTabCtrlklasy , musisz zaimplementować tę funkcję.

CMFCBaseTabCtrl::SetActiveTabColor

Ustawia kolor tła aktywnej karty.

virtual void SetActiveTabColor(COLORREF clr);

Parametry

Clr
[in] Określa nowy kolor tła.

Uwagi

Struktura uzyskuje domyślny kolor tła dla aktywnych kart z metody GetSysColor.

CMFCBaseTabCtrl::SetActiveTabTextColor

Ustawia kolor tekstu dla aktywnych kart.

virtual void SetActiveTabTextColor(COLORREF clr);

Parametry

Clr
[in] Parametr COLORREF określający nowy kolor tekstu.

Uwagi

Domyślnie struktura uzyskuje kolor tekstu z getSysColor. Zastąpi ten domyślny kolor przy użyciu SetActiveTabTextColor metody .

CMFCBaseTabCtrl::SetAutoColors

Ustawia kolory kontrolki karty używanej przez platformę w trybie automatycznego koloru.

void SetAutoColors(const CArray<COLORREF,COLORREF>& arColors);

Parametry

arColors
[in] Tablica kolorów RGB.

Uwagi

Jeśli podasz niestandardową tablicę kolorów, domyślna tablica kolorów zostanie zignorowana. Jeśli parametr arColors jest pusty, struktura przywraca domyślną tablicę kolorów.

Aby włączyć tryb automatycznego kolorowania, użyj metody CMFCBaseTabCtrl::EnableAutoColor .

CMFCBaseTabCtrl::SetDockingBarWrapperRTC

Ustawia klasę otoki używaną dla wszystkich obiektów, które nie pochodzą z klasy CDockablePane.

void SetDockingBarWrapperRTC(CRuntimeClass* pRTC);

Parametry

PRTC
[in] Informacje o klasie środowiska uruchomieniowego dla nowej klasy otoki.

Uwagi

Karty są dodawane do kontrolki tabulacji przy użyciu metod CMFCBaseTabCtrl::AddTab i CMFCBaseTabCtrl::InsertTab. Po dodaniu karty każda kontrolka na tej karcie musi być docka. Wszystkie obiekty, z których nie pochodzą CDockablePane , muszą być opakowane. AddTab i InsertTab utwórz otokę dla tych obiektów. Domyślną klasą otoki jest klasa CDockablePaneAdapter. Metoda SetDockingBarWrapperRTC umożliwia zmianę klasy, która jest używana jako klasa otoki. Dostarczana klasa otoki musi pochodzić z CDockablePaneAdapterklasy .

CMFCBaseTabCtrl::SetDrawNoPrefix

Włącza i wyłącza przetwarzanie znaków prefiksów w etykietach tabulacji.

void SetDrawNoPrefix(
    BOOL bNoPrefix,
    BOOL bRedraw = TRUE);

Parametry

bNoPrefix
[in] WARTOŚĆ TRUE, jeśli chcesz przetworzyć znaki prefiksu; w przeciwnym razie FAŁSZ.

bRedraw
[in] WARTOŚĆ TRUE, jeśli chcesz ponownie wyrysować okno z kartami; w przeciwnym razie FAŁSZ.

Uwagi

Znak prefiksu jest znakiem mnemonic, który jest poprzedzony znakiem ampersand (&).

CMFCBaseTabCtrl::SetImageList

Ustawia listę obrazów ikon dla kontrolki karty.

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

virtual BOOL SetImageList(HIMAGELIST hImageList);

Parametry

identyfikator uiID
[in] Identyfikator zasobu mapy bitowej. SetImageList ładuje listę obrazów z tego zasobu.

cx
[in] Szerokość każdego obrazu w pikselach.

clrTransp
[in] Parametr COLORREF wskazujący przezroczysty kolor obrazu.

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

Wartość zwracana

Nonzero, jeśli metoda zakończyła się pomyślnie; 0 w przeciwnym razie.

Uwagi

Obrazy z listy obrazów ikon są wyświetlane obok etykiet dla karty. Aby wyświetlić ikonę, należy określić jej indeks podczas wywoływania polecenia CMFCBaseTabCtrl::AddTab.

SetImageList nie powiedzie się, jeśli kontrolka karty została utworzona z płaskim stylem. Zakończy się to również niepowodzeniem, jeśli platforma nie może załadować obrazu wskazanego przez identyfikator uiID.

Ta metoda ponownie oblicza wysokość karty zgodnie z rozmiarami obrazu i tekstu.

CMFCBaseTabCtrl::SetLocation

virtual void SetLocation(Location location);

Parametry

[in] lokalizacja

Uwagi

CMFCBaseTabCtrl::SetTabBkColor

Ustawia kolor tła dla określonej karty.

virtual BOOL SetTabBkColor(
    int iTab,
    COLORREF color = (COLORREF)-1);

Parametry

iTab
[in] Indeks na karcie oparty na zerach.

Kolor
[in] Kolor do ustawienia.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; FAŁSZ w przeciwnym razie.

CMFCBaseTabCtrl::SetTabBorderSize

Ustawia nowy rozmiar obramowania dla kontrolki karty.

virtual void SetTabBorderSize(
    int nTabBorderSize,
    BOOL bRepaint = TRUE);

Parametry

nTabBorderSize
[in] Nowy rozmiar obramowania w pikselach.

bRepaint
[in] Parametr logiczny wskazujący, czy struktura ponownie rysuje kontrolkę.

CMFCBaseTabCtrl::SetTabHicon

Ustawia ikonę etykiety karty.

virtual BOOL SetTabHicon(
    int iTab,
    HICON hIcon);

Parametry

iTab
[in] Indeks oparty na zerach karty. Ta metoda zmienia ikonę tej karty.

hIcon
[in] Uchwyt do ikony.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

CMFCBaseTabCtrl::SetTabIcon

Ustawia ikonę karty.

virtual BOOL SetTabIcon(
    int iTab,
    UINT uiIcon);

Parametry

iTab
[in] Indeks oparty na zerach karty do aktualizacji.

uiIcon
[in] Identyfikator ikony nowej ikony. Ten identyfikator odwołuje się do wewnętrznego obiektu CImageList .

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

CMFCBaseTabCtrl::SetTabIconOnly

Włącza wyświetlanie tylko ikony (bez etykiety tekstowej) na określonej karcie.

virtual BOOL SetTabIconOnly(
    int iTab,
    BOOL bIconOnly = TRUE,
    BOOL bShowTooltipAlways = FALSE);

Parametry

iTab
[in] Indeks zera karty, który ma ulec zmianie.

bIconOnly
[in] Parametr logiczny określający, czy mają być wyświetlane tylko ikony.

bShowTooltipAlways
[in] Parametr logiczny określający, czy platforma wyświetla etykietki narzędzi dla etykiety karty, która wyświetla tylko ikony.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Domyślnie kontrolka karty wyświetla ikonę i etykietę tekstową dla każdej karty.

CMFCBaseTabCtrl::SetTabLabel

Ustawia tekst etykiety karty.

virtual BOOL SetTabLabel(
    int iTab,
    const CString& strLabel);

Parametry

iTab
[in] Indeks oparty na zerach karty do aktualizacji.

strLabel
[in] Odwołanie do ciągu zawierającego nowy tekst etykiety karty.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; 0 w przeciwnym razie.

CMFCBaseTabCtrl::SetTabsHeight

virtual void SetTabsHeight();

Uwagi

CMFCBaseTabCtrl::SetTabsOrder

Rozmieszcza karty w określonej kolejności.

BOOL SetTabsOrder(const CArray<int,int>& arOrder);

Parametry

arOrder
[in] Tablica indeksów opartych na zerach definiujących nową kolejność kart.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; NIEPOWODZENIE w przeciwnym razie.

Uwagi

Rozmiar tablicy arOrder musi być równy liczbie kart w kontrolce karty.

CMFCBaseTabCtrl::SetTabTextColor

Ustawia kolor tekstu dla określonej karty.

virtual BOOL SetTabTextColor(
    int iTab,
    COLORREF color = (COLORREF)-1);

Parametry

iTab
[in] Indeks na karcie oparty na zerach.

Kolor
[in] Parametr COLORREF wskazujący nowy kolor tekstu.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; 0 w przeciwnym razie.

CMFCBaseTabCtrl::ShowTab

Pokazuje lub ukrywa określoną kartę.

virtual BOOL ShowTab(
    int iTab,
    BOOL bShow = TRUE,
    BOOL bRecalcLayout = TRUE,
    BOOL bActivate = FALSE);

Parametry

iTab
[in] Indeks karty, która ShowTab będzie pokazywana lub ukrywana.

bShow
[in] Parametr logiczny wskazujący, czy ma być wyświetlana karta.

bRecalcLayout
[in] Parametr logiczny wskazujący, czy natychmiast ponownie obliczyć układ okna.

bActivate
[in] Parametr logiczny wskazujący, czy wybrać kartę określoną przez iTab.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Parametr bActivate ma zastosowanie tylko wtedy, gdy bShow ma wartość TRUE. Jeśli parametr bActivate ma wartość TRUE i jeśli ShowTab zakończy się powodzeniem, ShowTab wyśle komunikat AFX_WM_CHANGE_ACTIVE_TAB do elementu nadrzędnego okna karty.

CMFCBaseTabCtrl::StartRenameTab

virtual BOOL StartRenameTab(int iTab);

Parametry

[in] iTab

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::SwapTabs

virtual void SwapTabs(
    int nFisrtTabID,
    int nSecondTabID);

Parametry

[in] nFisrtTabID

[in] nSecondTabID

Uwagi

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCTabCtrl
Klasa CMFCOutlookBarTabCtrl

Udostępnij za pośrednictwem

Klasa CMFCBaseTabCtrl

Składnia

Elementy członkowskie

Metody publiczne

Metody chronione

Składowe danych

Uwagi

Porady dotyczące dostosowywania

Hierarchia dziedziczenia

Wymagania

CMFCBaseTabCtrl::AddIcon

Parametry

Uwagi

CMFCBaseTabCtrl::AddTab

Parametry

Uwagi

CMFCBaseTabCtrl::ApplyRestoredTabInfo

Parametry

Uwagi

CMFCBaseTabCtrl::AutoDestroyWindow

Parametry

Uwagi

CMFCBaseTabCtrl::CalcRectEdit

Parametry

Uwagi

CMFCBaseTabCtrl::CleanUp

Uwagi

CMFCBaseTabCtrl::ClearImageList

Uwagi

CMFCBaseTabCtrl::CreateWrapper

Parametry

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::D etachTab

Parametry

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::EnableActivateLastActive

Parametry

Uwagi

CMFCBaseTabCtrl::EnableAutoColor

Parametry

Uwagi

CMFCBaseTabCtrl::EnableCustomToolTips

Parametry

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::EnableInPlaceEdit

Parametry

Uwagi

CMFCBaseTabCtrl::EnableTabDetach

Parametry

Wartość zwracana

CMFCBaseTabCtrl::EnableTabSwap

Parametry

Uwagi

CMFCBaseTabCtrl::EnsureVisible

Parametry

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::EnterDragMode

Uwagi

CMFCBaseTabCtrl::FindTargetWnd

Parametry

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::FireChangeActiveTab

Parametry

Uwagi

CMFCBaseTabCtrl::FireChangingActiveTab

Parametry

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::GetActiveTab

Wartość zwracana

CMFCBaseTabCtrl::GetActiveTabColor

Wartość zwracana

Uwagi

CMFCBaseTabCtrl::GetActiveTabTextColor