Klasa CMFCOutlookBarTabCtrl

Artykuł
10/12/2023

Kontrolka karty, która ma wizualny wygląd okienka nawigacji w programie Microsoft Outlook. 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 CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

Elementy członkowskie

Konstruktory publiczne

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

Metody publiczne

Nazwa/nazwisko	opis
CMFCOutlookBarTabCtrl::AddControl	Dodaje kontrolkę systemu Windows jako nową kartę na pasku programu Outlook.
`CMFCOutlookBarTabCtrl::CalcRectEdit`	Wywoływana przez strukturę w celu określenia wymiarów pola edycji wyświetlanego, gdy użytkownik zmieni nazwę karty. (Przesłonięcia `CMFCBaseTabCtrl::CalcRectEdit`).
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons	Wywoływana przez platformę podczas operacji zmiany rozmiaru w celu określenia, czy można wyświetlić mniej przycisków strony karty paska programu Outlook niż są obecnie widoczne.
CMFCOutlookBarTabCtrl::CanShowMorePageButtons	Wywoływana przez platformę podczas operacji zmiany rozmiaru w celu określenia, czy można wyświetlić więcej przycisków strony karty paska programu Outlook niż są obecnie widoczne.
CMFCOutlookBarTabCtrl::Create	Tworzy kontrolkę karty pasek programu Outlook.
`CMFCOutlookBarTabCtrl::CreateObject`	Używana przez platformę do tworzenia wystąpienia dynamicznego tego typu klasy.
CMFCOutlookBarTabCtrl::EnableAnimation	Określa, czy animacja wykonywana podczas przełączania między aktywnymi kartami jest włączona.
CMFCOutlookBarTabCtrl::EnableInPlaceEdit	Określa, czy użytkownik może modyfikować etykiety tekstowe na przyciskach kart paska programu Outlook. (Przesłonięcia) CMFCBaseTabCtrl::EnableInPlaceEdit.
CMFCOutlookBarTabCtrl::EnableScrollButtons	Wywoływana przez platformę w celu włączenia przycisków, które umożliwiają użytkownikowi przewijanie przycisków w okienku paska programu Outlook.
`CMFCOutlookBarTabCtrl::FindTargetWnd`	Identyfikuje okienko zawierające określony punkt. (Przesłonięcia) CMFCBaseTabCtrl::FindTargetWnd.
CMFCOutlookBarTabCtrl::GetBorderSize	Zwraca rozmiar obramowania kontrolki karty programu Outlook.
`CMFCOutlookBarTabCtrl::GetTabArea`	Pobiera rozmiar i położenie obszaru karty kontrolki tabulacji. (Przesłonięcia) CMFCBaseTabCtrl::GetTabArea.)
`CMFCOutlookBarTabCtrl::GetThisClass`	Używany przez platformę do uzyskiwania wskaźnika do obiektu CRuntimeClass skojarzonego z tym typem klasy.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation	Określa, czy animacja wykonywana podczas przełączania między aktywnymi kartami jest włączona.
CMFCOutlookBarTabCtrl::IsMode2003	Określa, czy kontrolka karty pasek programu Outlook jest w trybie emulacji programu Microsoft Outlook 2003.
`CMFCOutlookBarTabCtrl::IsPtInTabArea`	Określa, czy punkt znajduje się wewnątrz obszaru karty. (Przesłonięcia) CMFCBaseTabCtrl::IsPtInTabArea.)
`CMFCOutlookBarTabCtrl::IsTabDetachable`	Określa, czy karta jest odłączana. (Przesłonięcia) CMFCBaseTabCtrl::IsTabDetachable.)
`CMFCOutlookBarTabCtrl::OnChangeTabs`	Wywoływana przez platformę po wstawieniu lub usunięciu karty. (Przesłania `CMFCBaseTabCtrl::OnChangeTabs`).
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons	Wywoływana przez strukturę w celu zmniejszenia liczby widocznych przycisków strony tabulacji.
CMFCOutlookBarTabCtrl::OnShowMorePageButtons	Wywoływana przez strukturę w celu zwiększenia liczby widocznych przycisków strony tabulacji.
CMFCOutlookBarTabCtrl::OnShowOptions	Wyświetla okno dialogowe Opcje okienka nawigacji.
`CMFCOutlookBarTabCtrl::RecalcLayout`	Oblicza ponownie układ wewnętrzny kontrolki tabulacji. (Przesłonięcia) CMFCBaseTabCtrl::RecalcLayout).
CMFCOutlookBarTabCtrl::SetActiveTab	Ustawia aktywną kartę. (Zastępuje cmFCBaseTabCtrl ::SetActiveTab).)
CMFCOutlookBarTabCtrl::SetBorderSize	Ustawia rozmiar obramowania kontrolki karty programu Outlook.
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign	Ustawia wyrównanie etykiet tekstowych na przyciskach kart paska programu Outlook.
CMFCOutlookBarTabCtrl::SetToolbarImageList	Ustawia mapę bitową zawierającą ikony wyświetlane w dolnej części paska programu Outlook w trybie programu Outlook 2003 (zobacz Klasa CMFCOutlookBar).
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Uwagi

Aby utworzyć pasek programu Outlook z obsługą CMFCOutlookBar dokowania, użyj obiektu do hostowania kontrolki karty pasek programu Outlook. Aby uzyskać więcej informacji, zobacz CMFCOutlookBar Class (Klasa CMFCOutlookBar).

Przykład

W poniższym przykładzie pokazano, jak zainicjować CMFCOutlookBarTabCtrl obiekt i użyć różnych metod w CMFCOutlookBarTabCtrl klasie. W przykładzie pokazano, jak włączyć edycję w miejscu etykiety tekstowej na przyciskach strony karty paska programu Outlook, włączyć animację, włączyć uchwyty przewijania, które umożliwiają użytkownikowi przewijanie przycisków w okienku paska programu Outlook, ustawianie rozmiaru obramowania kontrolki karty programu Outlook i ustawianie wyrównania etykiet tekstowych na przyciskach kart paska programu Outlook. Ten fragment kodu jest częścią przykładu demonstracyjnego programu Outlook.

// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();

pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);

Hierarchia dziedziczenia

CMFCOutlookBarTabCtrl

Wymagania

Nagłówek: afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl::AddControl

Dodaje kontrolkę systemu Windows jako nową kartę na pasku programu Outlook.

void AddControl(
    CWnd* pWndCtrl,
    LPCTSTR lpszName,
    int nImageID=-1,
    BOOL bDetachable=TRUE,
    DWORD dwControlBarStyle=AFX_CBRS_FLOAT |  AFX_CBRS_CLOSE | AFX_CBRS_RESIZE |  CBRS_AFX_AUTOHIDE);

Parametry

pWndCtrl
[in] Wskaźnik do kontrolki do dodania.

lpszName
[in] Określa nazwę karty.

Element bDetachable
[in] Jeśli wartość TRUE, strona zostanie utworzona jako odłączana.

nImageID
[in] Indeks obrazu na wewnętrznej liście obrazów, który ma być wyświetlany na nowej karcie.

dwControlBarStyle
[in] Określa styl AFX_ CBRS_* dla opakowanych okienek dokowania.

Uwagi

Ta funkcja służy do dodawania kontrolki jako nowej strony paska programu Outlook.

Ta funkcja wewnętrznie wywołuje polecenie CMFCBaseTabCtrl::AddTab.

Jeśli ustawisz wartość bDetachable na wartość TRUE, AddControl wewnętrznie tworzy obiekt i opakowuje dodaną kontrolkę CDockablePaneAdapter . Automatycznie ustawia klasę środowiska uruchomieniowego okna z kartami na klasę CMFCOutlookBar środowiska uruchomieniowego i klasę środowiska uruchomieniowego zmiennej ramki na CMultiPaneFrameWndwartość .

Przykład

W poniższym przykładzie pokazano, jak używać AddControl metody w CMFCOutlookBarTabCtrl klasie . Ten fragment kodu jest częścią przykładu demonstracyjnego programu Outlook.

// CMFCOutlookBarTabCtrl* pOutlookBar
// DWORD dwStyle = AFX_CBRS_FLOAT | AFX_CBRS_AUTOHIDE | AFX_CBRS_RESIZE
// CMFCOutlookBarPane pane1
// The third parameter is the image index.
pOutlookBar->AddControl(&pane1, _T("General"), 0, TRUE, dwStyle);

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

Wywoływana przez platformę podczas operacji zmiany rozmiaru w celu określenia, czy można wyświetlić mniej przycisków kart paska programu Outlook niż są obecnie widoczne.

virtual BOOL CanShowFewerPageButtons() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli istnieje więcej niż jeden przycisk; w przeciwnym razie FAŁSZ.

Uwagi

Kontrolka karty pasek programu Outlook dynamicznie dodaje lub usuwa karty z wyświetlania w zależności od ilości dostępnego miejsca. Ta metoda jest używana przez platformę do pomocy w tym procesie.

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

Wywoływana przez platformę podczas operacji zmiany rozmiaru w celu określenia, czy można wyświetlić więcej przycisków stron kart paska programu Outlook niż są obecnie widoczne.

virtual BOOL CanShowMorePageButtons() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli istnieją przyciski, które nie są obecnie widoczne; w przeciwnym razie FAŁSZ.

Uwagi

Kontrolka karty pasek programu Outlook dynamicznie dodaje lub usuwa karty z wyświetlacza, w zależności od ilości dostępnego miejsca. Ta metoda jest używana przez platformę do pomocy w tym procesie.

CMFCOutlookBarTabCtrl::Create

Tworzy kontrolkę karty pasek programu Outlook.

virtual BOOL Create(
    const CRect& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametry

Rect
[in] Określa początkowy rozmiar i położenie w pikselach.

pParentWnd
[in] Wskazuje okno nadrzędne. Nie może mieć wartości NULL.

Nid
[in] Identyfikator kontrolki.

Wartość zwracana

Nonzero, jeśli kontrolka została utworzona pomyślnie; w przeciwnym razie 0.

Uwagi

Zazwyczaj kontrolki karty paska programu Outlook są tworzone, gdy klasa CMFCOutlookBar steruje komunikatem WM_CREATE procesu.

CMFCOutlookBarTabCtrl::EnableAnimation

Określa, czy animacja wykonywana podczas przełączania między aktywnymi kartami jest włączona.

static void EnableAnimation(BOOL bEnable=TRUE);

Parametry

bEnable
[in] Określa, czy animacja ma być włączona, czy wyłączona.

Uwagi

Wywołaj tę funkcję, aby włączyć i wyłączyć animację. Gdy użytkownik otworzy stronę karty, podpis strony przesuwa się w górę lub w dół, jeśli animacja jest włączona. Jeśli animacja zostanie wyłączona, strona stanie się aktywna natychmiast.

Domyślnie animacja jest włączona.

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Określa, czy użytkownik może modyfikować etykiety tekstowe na przyciskach strony karty paska programu Outlook.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parametry

bEnable
Jeśli wartość TRUE, włącz edycję w miejscu etykiety tekstowej. Jeśli wartość FALSE, wyłącz edycję w miejscu.

Uwagi

Wywołaj tę funkcję, aby włączyć lub wyłączyć edycję w miejscu etykiet tekstowych na przyciskach stron tabulacji. Domyślnie edytowanie w miejscu jest wyłączone.

CMFCOutlookBarTabCtrl::EnableScrollButtons

Wywoływana przez platformę w celu włączenia uchwytów przewijania, które umożliwiają użytkownikowi przewijanie przycisków w okienku paska programu Outlook.

void EnableScrollButtons(
    BOOL bEnable = TRUE,
    BOOL bIsUp = TRUE,
    BOOL bIsDown = TRUE);

Parametry

bEnable
[in] Określa, czy są wyświetlane przyciski przewijania.

bIsUp
[in] Określa, czy jest wyświetlany górny pasek przewijania.

bIsDown
[in] Określa, czy jest wyświetlany dolny pasek przewijania.

Uwagi

Włącza wyświetlanie przycisków przewijania. Ta metoda jest wywoływana przez platformę, gdy aktywna karta zmieni się w celu przywrócenia przycisków przewijania.

CMFCOutlookBarTabCtrl::GetBorderSize

Zwraca rozmiar obramowania kontrolki karty programu Outlook.

int GetBorderSize() const;

Wartość zwracana

Rozmiar obramowania w pikselach.

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

Wartość zwracana

Uwagi

CMFCOutlookBarTabCtrl::IsAnimation

Określa, czy animacja wykonywana podczas przełączania między aktywnymi kartami jest włączona.

static BOOL IsAnimation();

Wartość zwracana

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

Uwagi

Wywołaj funkcję CMFCOutlookBarTabCtrl::EnableAnimation , aby włączyć lub wyłączyć animację.

CMFCOutlookBarTabCtrl::IsMode2003

Określa, czy kontrolka karty pasek programu Outlook jest w trybie emulacji programu Microsoft Outlook 2003.

BOOL IsMode2003() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli kontrolka karty pasek programu Outlook jest w trybie programu Outlook 2003; w przeciwnym razie FAŁSZ;

Uwagi

Ta wartość jest ustawiana przez cmFCOutlookBar::SetMode2003.

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

Wywoływana przez strukturę w celu zmniejszenia liczby widocznych przycisków strony tabulacji.

virtual void OnShowFewerPageButtons();

Uwagi

Ta metoda dostosowuje liczbę widocznych przycisków kart strony po zmianie rozmiaru kontrolki.

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Wywoływana przez strukturę w celu zwiększenia liczby widocznych przycisków strony tabulacji.

virtual void OnShowMorePageButtons();

Uwagi

Ta metoda dostosowuje liczbę przycisków strony karty, które są widoczne po zmianie rozmiaru kontrolki.

CMFCOutlookBarTabCtrl::OnShowOptions

Wyświetla okno dialogowe Opcje okienka nawigacji.

virtual void OnShowOptions();

Uwagi

Okno dialogowe Opcje okienka nawigacji umożliwia użytkownikowi wybranie przycisków strony karty, które mają być wyświetlane, oraz kolejność wyświetlania.

Ta metoda jest wywoływana przez platformę, gdy użytkownik wybierze element menu Opcje okienka nawigacji z menu dostosowywania kontrolki.

CMFCOutlookBarTabCtrl::SetActiveTab

Ustawia aktywną kartę. Aktywna karta to ta, która jest otwarta, z widoczną jego zawartością.

virtual BOOL SetActiveTab(int iTab);

Parametry

iTab
[in] Indeks oparty na zerach karty, który ma zostać otwarty.

Wartość zwracana

Nonzero, jeśli określona karta została pomyślnie otwarta; w przeciwnym razie 0.

Uwagi

Efekt wizualny ustawiania aktywnej karty zależy od tego, czy włączono animację. Aby uzyskać więcej informacji, zobacz CMFCOutlookBarTabCtrl::EnableAnimation.

CMFCOutlookBarTabCtrl::SetBorderSize

Ustawia rozmiar obramowania kontrolki karty programu Outlook.

void SetBorderSize(int nBorderSize);

Parametry

nBorderSize
[in] Określa nowy rozmiar obramowania w pikselach.

Uwagi

Ustawia nowy rozmiar obramowania i ponownie oblicza układ okna programu Outlook.

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Ustawia wyrównanie etykiet tekstowych na przyciskach kart paska programu Outlook.

void SetPageButtonTextAlign(
    UINT uiAlign,
    BOOL bRedraw=TRUE);

Parametry

uiAlign
[in] Określa wyrównanie tekstu.

bRedraw
[in] Jeśli wartość TRUE, okno programu Outlook zostanie ponownie wyrysowane.

Uwagi

Użyj tej funkcji, aby zmienić wyrównanie tekstu dla przycisków strony.

uiAlign może być jedną z następujących wartości:

Stała	Znaczenie
TA_LEFT	Wyrównanie do lewej
TA_CENTER	Wyrównanie do środka
TA_RIGHT	Wyrównanie do prawej

Wartość domyślna to TA_CENTER.

CMFCOutlookBarTabCtrl::SetToolbarImageList

Ustawia mapę bitową zawierającą ikony wyświetlane w dolnej części paska programu Outlook w trybie outlook 2003.

BOOL SetToolbarImageList(
    UINT uiID,
    int cx,
    COLORREF clrTransp=RGB(255, 0, 255));

Parametry

identyfikator uiID
[in] Określa identyfikator zasobu obrazu do załadowania.

cx
[in] Określa szerokość obrazu na liście obrazów w pikselach.

clrTransp
[in] Wartość RGB określająca przezroczysty kolor.

Wartość zwracana

Zwraca wartość TRUE, jeśli operacja powiedzie się; w przeciwnym razie zwraca wartość FALSE.

Uwagi

Ta funkcja służy do dołączania listy obrazów, których obrazy będą wyświetlane na przyciskach paska narzędzi w trybie pakietu Microsoft Office 2003. Indeksy obrazów powinny odpowiadać indeksom stron.

Ta metoda nie powinna być wywoływana, jeśli nie jest w trybie pakietu Microsoft Office 2003. Aby uzyskać więcej informacji, zobacz CMFCOutlookBar Class (Klasa CMFCOutlookBar).

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

Parametry

[in] nVisiblePageButtons

Uwagi

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCBaseTabCtrl
Klasa CMFCOutlookBar
Klasa CMFCOutlookBarPane

Udostępnij za pośrednictwem

Klasa CMFCOutlookBarTabCtrl

Składnia

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Uwagi

Przykład

Hierarchia dziedziczenia

Wymagania

CMFCOutlookBarTabCtrl::AddControl

Parametry

Uwagi

Przykład

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

Wartość zwracana

Uwagi

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

Wartość zwracana

Uwagi

CMFCOutlookBarTabCtrl::Create

Parametry

Wartość zwracana

Uwagi

CMFCOutlookBarTabCtrl::EnableAnimation

Parametry

Uwagi

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Parametry

Uwagi

CMFCOutlookBarTabCtrl::EnableScrollButtons

Parametry

Uwagi

CMFCOutlookBarTabCtrl::GetBorderSize

Wartość zwracana

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

Wartość zwracana

Uwagi

CMFCOutlookBarTabCtrl::IsAnimation

Wartość zwracana

Uwagi

CMFCOutlookBarTabCtrl::IsMode2003

Wartość zwracana

Uwagi

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

Uwagi

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Uwagi

CMFCOutlookBarTabCtrl::OnShowOptions

Uwagi

CMFCOutlookBarTabCtrl::SetActiveTab

Parametry

Wartość zwracana

Uwagi

CMFCOutlookBarTabCtrl::SetBorderSize

Parametry

Uwagi

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Parametry

Uwagi

CMFCOutlookBarTabCtrl::SetToolbarImageList

Parametry

Wartość zwracana

Uwagi

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Parametry

Uwagi

Zobacz też

Opinia

Dodatkowe zasoby