Klasa CMFCOutlookBarPane

Artykuł
10/12/2023

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

Kontrolka pochodząca z klasy CMFCToolBar, którą można wstawić do paska programu Outlook ( KLASA CMFCOutlookBar). Okienko paska programu Outlook zawiera kolumnę dużych przycisków. Użytkownik może przewijać w górę i w dół listę przycisków, jeśli jest ona większa niż okienko. Gdy użytkownik odłączy okienko paska programu Outlook od paska programu Outlook, może unosić się lub zadokować w głównym oknie ramowym.

Składnia

class CMFCOutlookBarPane : public CMFCToolBar

Elementy członkowskie

Konstruktory publiczne

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

Metody publiczne

Nazwa/nazwisko	opis
CMFCOutlookBarPane::AddButton	Dodaje przycisk do okienka paska programu Outlook.
CMFCOutlookBarPane::CanBeAttached	Określa, czy okienko może być zadokowane do innego okienka lub okna ramki. (Przesłonięcia) CBasePane::CanBeAttached.)
`CMFCOutlookBarPane::CanBeRestored`	Określa, czy system może przywrócić pasek narzędzi do pierwotnego stanu po dostosowaniu. (Przesłonięcia) CMFCToolBar::CanBeRestored.)
CMFCOutlookBarPane::ClearAll	Zwalnia zasoby używane przez obrazy w okienku paska programu Outlook.
CMFCOutlookBarPane::Create	Tworzy okienko paska programu Outlook.
`CMFCOutlookBarPane::CreateObject`	Używana przez platformę do tworzenia wystąpienia dynamicznego tego typu klasy.
`CMFCOutlookBarPane::Dock`	Wywoływana przez strukturę w celu zadokowania okienka paska programu Outlook. (Przesłania `CPane::Dock`).
CMFCOutlookBarPane::EnablePageScrollMode	Określa, czy strzałki przewijania w okienku paska programu Outlook przesuwają listę przycisków według strony, czy według przycisku.
CMFCOutlookBarPane::GetRegularColor	Zwraca zwykły (nie zaznaczony) kolor tekstu okienka paska programu Outlook.
`CMFCOutlookBarPane::GetThisClass`	Używany przez platformę do uzyskiwania wskaźnika do obiektu CRuntimeClass skojarzonego z tym typem klasy.
CMFCOutlookBarPane::IsBackgroundTexture	Określa, czy dla okienka paska programu Outlook jest załadowany obraz tła.
`CMFCOutlookBarPane::IsChangeState`	Określa, czy okienko przestawne może być zadokowane. (Przesłania `CPane::IsChangeState`).
CMFCOutlookBarPane::IsDrawShadedHighlight	Określa, czy obramowanie przycisku jest cieniowane, gdy przycisk jest wyróżniony, a obraz tła jest wyświetlany.
`CMFCOutlookBarPane::OnBeforeFloat`	Wywoływana przez platformę, gdy okienko ma być zmiennoprzecinkowe. (Przesłonięcia) CPane::OnBeforeFloat.)
CMFCOutlookBarPane::RemoveButton	Usuwa przycisk, który ma określony identyfikator polecenia.
`CMFCOutlookBarPane::RestoreOriginalstate`	Przywraca oryginalny stan paska narzędzi. (Przesłonięcia) CMFCToolBar::RestoreOriginalState.)
CMFCOutlookBarPane::SetBackColor	Ustawia kolor tła.
CMFCOutlookBarPane::SetBackImage	Ustawia obraz tła.
CMFCOutlookBarPane::SetDefaultState	Resetuje okienko paska programu Outlook do oryginalnego zestawu przycisków.
CMFCOutlookBarPane::SetExtraSpace	Ustawia liczbę pikseli wypełnienia używanych wokół przycisków w okienku paska programu Outlook.
CMFCOutlookBarPane::SetTextColor	Ustawia kolory zwykłego i wyróżnionego tekstu w okienku paska programu Outlook.
CMFCOutlookBarPane::SetTransparentColor	Ustawia przezroczysty kolor okienka paska programu Outlook.
`CMFCOutlookBarPane::SmartUpdate`	Służy wewnętrznie do aktualizowania paska programu Outlook. (Przesłania `CMFCToolBar::SmartUpdate`).

Metody chronione

Nazwa/nazwisko	opis
CMFCOutlookBarPane::EnableContextMenuItems	Określa, które elementy menu skrótów są wyświetlane w trybie dostosowywania.
CMFCOutlookBarPane::RemoveAllButtons	Usuwa wszystkie przyciski z okienka paska programu Outlook. (Przesłonięcia) CMFCToolBar::RemoveAllButtons.

Uwagi

Aby uzyskać informacje na temat implementowania paska programu Outlook, zobacz Klasa CMFCOutlookBar.

Aby zapoznać się z przykładem paska programu Outlook, zobacz przykładowy projekt OutlookDemo.

Przykład

W poniższym przykładzie pokazano, jak używać różnych metod CMFCOutlookBarPane klasy. W przykładzie pokazano, jak utworzyć okienko paska programu Outlook, włączyć tryb przewijania strony, włączyć dokowanie i ustawić kolor tła paska programu Outlook. Ten fragment kodu jest częścią przykładu z wieloma widokami programu Outlook.

CMFCOutlookBarPane m_wndShortcutsPane1;

CImageList images;
images.Create(IDB_SHORTCUTS, 32, 0, RGB(255, 0, 255));

// Create first page:
m_wndShortcutsPane1.Create(&m_wndShortcutsBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_SHORTCUTS_PANE_1);
// The this pointer points to a CMainFrame class which extends the CFrameWnd class
m_wndShortcutsPane1.SetOwner(this);
m_wndShortcutsPane1.EnableTextLabels();
m_wndShortcutsPane1.EnableDocking(CBRS_ALIGN_ANY);
m_wndShortcutsPane1.EnablePageScrollMode();
m_wndShortcutsPane1.SetBackColor(RGB(0, 255, 0));

m_wndShortcutsPane1.AddButton(images.ExtractIcon(0), _T("View 1"), ID_SHORTCUT_1);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(1), _T("View 2"), ID_SHORTCUT_2);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(2), _T("View 3"), ID_SHORTCUT_3);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(3), _T("View 4"), ID_SHORTCUT_4);

Hierarchia dziedziczenia

Wymagania

Nagłówek: afxoutlookbarpane.h

CMFCOutlookBarPane::AddButton

Dodaje przycisk do okienka paska programu Outlook.

BOOL AddButton(
    UINT uiImage,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    UINT uiImage,
    UINT uiLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    LPCTSTR szBmpFileName,
    LPCTSTR szLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HBITMAP hBmp,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HICON hIcon,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1,
    BOOL bAlphaBlend=FALSE);

Parametry

uiImage
[in] Określa identyfikator zasobu mapy bitowej.

lpszLabel
[in] Określa tekst przycisku.

iIdPolecenia
[in] Określa identyfikator kontrolki przycisku.

iInsertAt
[in] Określa indeks na podstawie zera na stronie paska programu Outlook, na której ma być wstawiony przycisk.

uiLabel
[in] Identyfikator zasobu ciągu.

szBmpFileName
[in] Określa nazwę pliku obrazu dysku do załadowania.

szLabel
[in] Określa tekst przycisku.

hBmp
[in] Uchwyt do mapy bitowej przycisku.

hIcon
[in] Uchwyt ikony przycisków.

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk został dodany pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Użyj tej metody, aby wstawić nowy przycisk na stronie paska programu Outlook. Obraz przycisku można załadować z zasobów aplikacji lub z pliku dysku.

Jeśli identyfikator strony określony przez uiPageID to -1, przycisk zostanie wstawiony do pierwszej strony.

Jeśli indeks określony przez parametr iInsertAt to -1, przycisk zostanie dodany na końcu strony.

CMFCOutlookBarPane::CanBeAttached

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

virtual BOOL CanBeAttached() const;

Wartość zwracana

Uwagi

CMFCOutlookBarPane::ClearAll

Zwalnia zasoby używane przez obrazy w okienku paska programu Outlook.

void ClearAll();

Uwagi

Ta metoda bezpośrednio wywołuje metodę CMFCToolBarImages::Clear, która jest wywoływana na obrazach używanych przez okienko paska programu Outlook.

CMFCOutlookBarPane::Create

Tworzy okienko paska programu Outlook.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT uiID=(UINT)-1,
    DWORD dwControlBarStyle=0);

Parametry

pParentWnd
[in] Określa okno nadrzędne kontrolki okienka paska programu Outlook. Nie może mieć wartości NULL.

dwStyle
[in] Styl okna. Aby uzyskać listę stylów okien, zobacz Style okien.

identyfikator uiID
[in] Identyfikator kontrolki. Musi być unikatowa, aby umożliwić zapisywanie stanu kontrolki.

dwControlBarStyle
[in] Określa specjalne style, które definiują zachowanie kontrolki okienka paska programu Outlook, gdy jest odłączony od paska programu Outlook.

Wartość zwracana

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

Uwagi

Aby skonstruować CMFCOutlookBarPane obiekt, najpierw wywołaj konstruktor, a następnie wywołaj Createmetodę , która tworzy kontrolkę okienka paska programu Outlook i dołącza ją do CMFCOutlookBarPane obiektu.

Aby uzyskać więcej informacji, dwControlBarStyle zobacz CBasePane::CreateEx.

CMFCOutlookBarPane::EnableContextMenuItems

Określa, które elementy menu skrótów są wyświetlane w trybie dostosowywania.

virtual BOOL EnableContextMenuItems(
    CMFCToolBarButton* pButton,
    CMenu* pPopup);

Parametry

PButton
[in] Wskaźnik do przycisku paska narzędzi, który użytkownik kliknął.

pPopup
[in] Wskaźnik do menu skrótów.

Wartość zwracana

Zwraca wartość TRUE, jeśli powinno być wyświetlane menu skrótów; w przeciwnym razie FAŁSZ.

Uwagi

Zastąpij tę metodę, aby zmodyfikować standardowe menu skrótów platformy wyświetlane w trybie dostosowywania.

Domyślna implementacja sprawdza tryb dostosowywania ( CMFCToolBar::IsCustomizeMode) i jeśli jest ustawiona na wartość TRUE, wyłącza wszystkie elementy menu skrótów z wyjątkiem Usuń. Następnie po prostu przekazuje parametry wejściowe do .CMFCToolBar::EnableContextMenuItems

Uwaga

Menu kontekstowe to synonim menu skrótów.

CMFCOutlookBarPane::EnablePageScrollMode

Określa, czy strzałki przewijania w okienku paska programu Outlook przesuwają listę przycisków według strony, czy przycisk po przycisku.

void EnablePageScrollMode(BOOL bPageScroll=TRUE);

Parametry

bPageScroll
[in] Jeśli wartość TRUE, włącz tryb przewijania strony. Jeśli wartość FALSE, wyłącz tryb przewijania strony.

CMFCOutlookBarPane::GetRegularColor

Zwraca zwykły (czyli nie zaznaczony) kolor tekstu okienka paska programu Outlook.

DECLARE_MESSAGE_MAPCOLORREF GetRegularColor() const;

Wartość zwracana

Bieżący kolor tekstu jako wartość koloru RGB.

Uwagi

Użyj cmFCOutlookBarPane::SetTextColor , aby ustawić bieżący (zwykły i zaznaczony) kolor tekstu paska programu Outlook. Domyślny kolor tekstu można uzyskać, wywołując funkcję GetSysColor za pomocą indeksu COLOR_WINDOW.

CMFCOutlookBarPane::IsBackgroundTexture

Określa, czy dla okienka paska programu Outlook jest załadowany obraz tła.

BOOL IsBackgroundTexture() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli obraz tła ma być wyświetlany; w przeciwnym razie FAŁSZ.

Uwagi

Obraz tła można dodać, wywołując funkcję CMFCOutlookBarPane::SetBackImage .

Jeśli nie ma obrazu tła, tło jest malowane kolorem określonym przy użyciu cmFCOutlookBarPane::SetBackColor.

CMFCOutlookBarPane::IsDrawShadedHighlight

Określa, czy obramowanie przycisku jest cieniowane, gdy przycisk jest wyróżniony, a obraz tła jest wyświetlany.

BOOL IsDrawShadedHighlight() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli obramowania przycisku są cieniowane; w przeciwnym razie FAŁSZ.

CMFCOutlookBarPane::RemoveAllButtons

Usuwa wszystkie przyciski z okienka paska programu Outlook.

virtual void RemoveAllButtons();

CMFCOutlookBarPane::RemoveButton

Usuwa przycisk, który ma określony identyfikator polecenia.

BOOL RemoveButton(UINT iIdCommand);

Parametry

iIdPolecenia
[in] Określa identyfikator polecenia przycisku do usunięcia.

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk został pomyślnie usunięty; FAŁSZ, jeśli określony identyfikator polecenia jest nieprawidłowy.

CMFCOutlookBarPane::SetBackColor

Ustawia kolor tła paska programu Outlook.

void SetBackColor(COLORREF color);

Parametry

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

Uwagi

Wywołaj tę funkcję, aby ustawić bieżący kolor tła paska programu Outlook. Kolor tła jest używany tylko wtedy, gdy nie ma obrazu tła.

CMFCOutlookBarPane::SetBackImage

Ustawia obraz tła.

void SetBackImage(UINT uiImageID);

Parametry

uiImageID
[in] Określa identyfikator zasobu obrazu.

Uwagi

Wywołaj tę metodę, aby ustawić obraz tła paska programu Outlook. Lista obrazów tła jest zarządzana przez osadzony obiekt klasy CMFCToolBarImages.

CMFCOutlookBarPane::SetDefaultState

Resetuje okienko paska programu Outlook do oryginalnego zestawu przycisków.

void SetDefaultState();

Uwagi

Ta metoda przywraca przyciski paska programu Outlook do oryginalnego zestawu. Ta metoda jest podobna do CMFCOutlookBarPane::RestoreOriginalstatemetody , z tą różnicą, że nie wyzwala ponownego rysowania okienka paska programu Outlook.

CMFCOutlookBarPane::SetExtraSpace

Ustawia liczbę pikseli wypełnienia używanych wokół przycisków w okienku paska programu Outlook.

void SetExtraSpace()

CMFCOutlookBarPane::SetTextColor

Ustawia kolory zwykłego i wyróżnionego tekstu w okienku paska programu Outlook.

void SetTextColor(
    COLORREF clrRegText,
    COLORREF clrSelText=0);

Parametry

clrRegText
[in] Określa nowy kolor tekstu, który nie jest zaznaczony.

clrSelText
[in] Określa nowy kolor zaznaczonego tekstu.

CMFCOutlookBarPane::SetTransparentColor

Ustawia przezroczysty kolor okienka paska programu Outlook.

void SetTransparentColor(COLORREF color);

Parametry

Kolor
Określa nowy przezroczysty kolor.

Uwagi

Kolor przezroczysty jest wymagany do wyświetlania przezroczystych obrazów. Każde wystąpienie tego koloru na obrazie jest malowane kolorem tła. Nie ma łączenia obrazów tła i pierwszego planu.

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCToolBar
Klasa CMFCOutlookBar
Klasa CMFCOutlookBarTabCtrl

Udostępnij za pośrednictwem

Klasa CMFCOutlookBarPane

Składnia

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Metody chronione

Uwagi

Przykład

Hierarchia dziedziczenia

Wymagania

CMFCOutlookBarPane::AddButton

Parametry

Wartość zwracana

Uwagi

CMFCOutlookBarPane::CanBeAttached

Wartość zwracana

Uwagi

CMFCOutlookBarPane::ClearAll

Uwagi

CMFCOutlookBarPane::Create

Parametry

Wartość zwracana

Uwagi

CMFCOutlookBarPane::EnableContextMenuItems

Parametry

Wartość zwracana

Uwagi

CMFCOutlookBarPane::EnablePageScrollMode

Parametry

CMFCOutlookBarPane::GetRegularColor

Wartość zwracana

Uwagi

CMFCOutlookBarPane::IsBackgroundTexture

Wartość zwracana

Uwagi

CMFCOutlookBarPane::IsDrawShadedHighlight

Wartość zwracana

CMFCOutlookBarPane::RemoveAllButtons

CMFCOutlookBarPane::RemoveButton

Parametry

Wartość zwracana

CMFCOutlookBarPane::SetBackColor

Parametry

Uwagi

CMFCOutlookBarPane::SetBackImage

Parametry

Uwagi

CMFCOutlookBarPane::SetDefaultState

Uwagi

CMFCOutlookBarPane::SetExtraSpace

CMFCOutlookBarPane::SetTextColor

Parametry

CMFCOutlookBarPane::SetTransparentColor

Parametry

Uwagi

Zobacz też

Opinia

Dodatkowe zasoby