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:
Utwórz wystąpienie
CTabbedPaneklasy.Wywołaj polecenie
CDockablePane::Create.Użyj
CBaseTabbedPane::AddTabpolecenia lubCMFCBaseTabCtrl::InsertTab, aby dodać nowe karty.Wywołaj metodę
CBasePane::EnableDockingtak, aby bieżąca kontrolka karty dokowania mogła zadokować się w głównym oknie ramki.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
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
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla