Klasa CMFCOutlookBarTabCtrl
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
Członkowie
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
CMFCOutlookBarTabCtrl::CMFCOutlookBarTabCtrl |
Konstruktor domyślny. |
CMFCOutlookBarTabCtrl::~CMFCOutlookBarTabCtrl |
Destruktora. |
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
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
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
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