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