Classe CMFCOutlookBarPane

Articolo
10/12/2023

Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

Controllo derivato dalla classe CMFCToolBar che può essere inserita in una barra di Outlook ( classe CMFCOutlookBar). Il riquadro della barra di Outlook contiene una colonna di pulsanti di grandi dimensioni. L'utente può scorrere verso l'alto e verso il basso l'elenco dei pulsanti, se questo è più grande del riquadro. Quando l'utente scollega un riquadro della barra di Outlook dalla barra stessa, questo può rimanere mobile o essere ancorato nella finestra cornice principale.

Sintassi

class CMFCOutlookBarPane : public CMFCToolBar

Membri

Costruttori pubblici

Nome	Descrizione
`CMFCOutlookBarPane::CMFCOutlookBarPane`	Costruttore predefinito.
`CMFCOutlookBarPane::~CMFCOutlookBarPane`	Distruttore.

Metodi pubblici

Nome	Descrizione
CMFCOutlookBarPane::AddButton	Aggiunge un pulsante al riquadro della barra di Outlook.
CMFCOutlookBarPane::CanBeAttached	Determina se il riquadro può essere ancorato a un altro riquadro o a un'altra finestra cornice. (sostituzioni )CBasePane::CanBeAttached.)
`CMFCOutlookBarPane::CanBeRestored`	Determina se il sistema può ripristinare uno stato originale di una barra degli strumenti dopo la personalizzazione. (sostituzioni )CMFCToolBar::CanBeRestored.
CMFCOutlookBarPane::ClearAll	Libera le risorse utilizzate dalle immagini nel riquadro della barra di Outlook.
CMFCOutlookBarPane::Create	Crea il riquadro della barra di Outlook.
`CMFCOutlookBarPane::CreateObject`	Usato dal framework per creare un'istanza dinamica di questo tipo di classe.
`CMFCOutlookBarPane::Dock`	Chiamato dal framework per ancorare il riquadro della barra di Outlook. Esegue l'override di `CPane::Dock`.
CMFCOutlookBarPane::EnablePageScrollMode	Specifica se le frecce di scorrimento nel riquadro della barra di Outlook spostano in avanti l'elenco dei pulsanti per pagina o per pulsante.
CMFCOutlookBarPane::GetRegularColor	Restituisce il colore di testo normale (non selezionato) del riquadro della barra di Outlook.
`CMFCOutlookBarPane::GetThisClass`	Usato dal framework per ottenere un puntatore all'oggetto CRuntimeClass associato a questo tipo di classe.
CMFCOutlookBarPane::IsBackgroundTexture	Determina se è presente un'immagine di sfondo caricata per il riquadro della barra di Outlook.
`CMFCOutlookBarPane::IsChangeState`	Determina se è possibile ancorare un riquadro mobile. Esegue l'override di `CPane::IsChangeState`.
CMFCOutlookBarPane::IsDrawShadedHighlight	Determina se il bordo del pulsante è ombreggiato quando viene evidenziato un pulsante e viene visualizzata un'immagine di sfondo.
`CMFCOutlookBarPane::OnBeforeFloat`	Chiamato dal framework quando un riquadro sta per essere mobile. (sostituzioni )CPane::OnBeforeFloat.
CMFCOutlookBarPane::RemoveButton	Rimuove il pulsante con un ID comando specificato.
`CMFCOutlookBarPane::RestoreOriginalstate`	Ripristina lo stato originale di una barra degli strumenti. (sostituzioni )CMFCToolBar::RestoreOriginalState.
CMFCOutlookBarPane::SetBackColor	Imposta il colore di sfondo.
CMFCOutlookBarPane::SetBackImage	Imposta l'immagine di sfondo.
CMFCOutlookBarPane::SetDefaultState	Reimposta il riquadro della barra di Outlook sul set originale di pulsanti.
CMFCOutlookBarPane::SetExtraSpace	Imposta il numero di pixel di spaziatura interna utilizzati intorno ai pulsanti nel riquadro della barra di Outlook.
CMFCOutlookBarPane::SetTextColor	Imposta i colori del testo normale e evidenziato nel riquadro della barra di Outlook.
CMFCOutlookBarPane::SetTransparentColor	Imposta il colore trasparente per il riquadro della barra di Outlook.
`CMFCOutlookBarPane::SmartUpdate`	Utilizzato internamente per aggiornare la barra di Outlook. Esegue l'override di `CMFCToolBar::SmartUpdate`.

Metodi protetti

Nome	Descrizione
CMFCOutlookBarPane::EnableContextMenuItems	Specifica le voci di menu di scelta rapida visualizzate in modalità di personalizzazione.
CMFCOutlookBarPane::RemoveAllButtons	Rimuove tutti i pulsanti dal riquadro della barra di Outlook. (sostituzioni )CMFCToolBar::RemoveAllButtons.

Osservazioni:

Per informazioni su come implementare una barra di Outlook, vedere Classe CMFCOutlookBar.

Per un esempio di barra di Outlook, vedere il progetto di esempio OutlookDemo.

Esempio

Nell'esempio seguente viene illustrato come usare vari metodi della CMFCOutlookBarPane classe . Nell'esempio viene illustrato come creare un riquadro della barra di Outlook, abilitare la modalità di scorrimento della pagina, abilitare l'ancoraggio e impostare il colore di sfondo della barra di Outlook. Questo frammento di codice fa parte dell'esempio di visualizzazioni multi-vista di 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);

Gerarchia di ereditarietà

Requisiti

Intestazione: afxoutlookbarpane.h

CMFCOutlookBarPane::AddButton

Aggiunge un pulsante al riquadro della barra di 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);

Parametri

uiImage
[in] Specifica l'identificatore della risorsa di una bitmap.

lpszLabel
[in] Specifica il testo del pulsante.

iIdCommand
[in] Specifica l'ID del controllo pulsante.

iInsertAt
[in] Specifica l'indice in base zero nella pagina della barra di Outlook in corrispondenza del quale inserire il pulsante.

uiLabel
[in] ID risorsa stringa.

szBmpFileName
[in] Specifica il nome del file di immagine del disco da caricare.

szLabel
[in] Specifica il testo del pulsante.

hBmp
[in] Handle per la bitmap di un pulsante.

hIcon
[in] Handle dell'icona di un pulsante.

Valore restituito

TRUE se un pulsante è stato aggiunto correttamente; in caso contrario FALSE.

Osservazioni:

Utilizzare questo metodo per inserire un nuovo pulsante nella pagina di una barra di Outlook. L'immagine del pulsante può essere caricata dalle risorse dell'applicazione o da un file su disco.

Se l'ID pagina specificato da uiPageID è -1, il pulsante viene inserito nella prima pagina.

Se l'indice specificato da iInsertAt è -1, il pulsante viene aggiunto alla fine della pagina.

CMFCOutlookBarPane::CanBeAttached

Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

virtual BOOL CanBeAttached() const;

Valore restituito

Osservazioni:

CMFCOutlookBarPane::ClearAll

Libera le risorse utilizzate dalle immagini nel riquadro della barra di Outlook.

void ClearAll();

Osservazioni:

Questo metodo chiama direttamente CMFCToolBarImages::Clear, che viene chiamato sulle immagini utilizzate dal riquadro della barra di Outlook.

CMFCOutlookBarPane::Create

Crea il riquadro della barra di Outlook.

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

Parametri

pParentWnd
[in] Specifica la finestra padre del controllo riquadro della barra di Outlook. Non deve essere NULL.

dwStyle
[in] Stile della finestra. Per un elenco degli stili di finestra, vedere Stili finestra.

uiID
[in] ID del controllo. Deve essere univoco per abilitare il salvataggio dello stato del controllo.

dwControlBarStyle
[in] Specifica stili speciali che definiscono il comportamento del controllo del riquadro della barra di Outlook quando viene scollegato dalla barra di Outlook.

Valore restituito

TRUE se il metodo ha avuto esito positivo; in caso contrario FALSE.

Osservazioni:

Per costruire un CMFCOutlookBarPane oggetto, chiamare prima il costruttore e quindi chiamare Create, che crea il controllo riquadro della barra di Outlook e lo collega all'oggetto CMFCOutlookBarPane .

Per altre informazioni, dwControlBarStyle vedere CBasePane::CreateEx.

CMFCOutlookBarPane::EnableContextMenuItems

Specifica le voci di menu di scelta rapida visualizzate in modalità di personalizzazione.

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

Parametri

pButton
[in] Puntatore a un pulsante della barra degli strumenti su cui un utente ha fatto clic.

pPopup
[in] Puntatore al menu di scelta rapida.

Valore restituito

Restituisce TRUE se il menu di scelta rapida deve essere visualizzato; in caso contrario FALSE.

Osservazioni:

Eseguire l'override di questo metodo per modificare il menu di scelta rapida standard del framework visualizzato dal framework in modalità di personalizzazione.

L'implementazione predefinita controlla la modalità di personalizzazione ( CMFCToolBar::IsCustomizeMode) e, se è impostata su TRUE, disabilita tutte le voci di menu di scelta rapida ad eccezione di Elimina. Passa quindi i parametri di input a CMFCToolBar::EnableContextMenuItems.

Nota

Il menu di scelta rapida è un sinonimo del menu di scelta rapida.

CMFCOutlookBarPane::EnablePageScrollMode

Specifica se le frecce di scorrimento nel riquadro della barra di Outlook spostano in avanti l'elenco di pulsanti pagina per pagina o pulsante per pulsante.

void EnablePageScrollMode(BOOL bPageScroll=TRUE);

Parametri

bPageScroll
[in] Se TRUE, abilitare la modalità di scorrimento della pagina. Se FALSE, disabilitare la modalità di scorrimento della pagina.

CMFCOutlookBarPane::GetRegularColor

Restituisce il colore di testo normale (ovvero non selezionato) del riquadro della barra di Outlook.

DECLARE_MESSAGE_MAPCOLORREF GetRegularColor() const;

Valore restituito

Colore del testo corrente come valore di colore RGB.

Osservazioni:

Utilizzare CMFCOutlookBarPane::SetTextColor per impostare il colore di testo corrente (normale e selezionato) della barra di Outlook. È possibile ottenere il colore di testo predefinito chiamando la funzione GetSysColor con l'indice COLOR_WINDOW.

CMFCOutlookBarPane::IsBackgroundTexture

Determina se è presente un'immagine di sfondo caricata per il riquadro della barra di Outlook.

BOOL IsBackgroundTexture() const;

Valore restituito

TRUE se è presente un'immagine di sfondo da visualizzare; in caso contrario FALSE.

Osservazioni:

È possibile aggiungere un'immagine di sfondo chiamando la funzione CMFCOutlookBarPane::SetBackImage .

Se non è presente alcuna immagine di sfondo, lo sfondo viene disegnato con un colore specificato tramite CMFCOutlookBarPane::SetBackColor.

CMFCOutlookBarPane::IsDrawShadedHighlight

Determina se il bordo del pulsante è ombreggiato quando viene evidenziato un pulsante e viene visualizzata un'immagine di sfondo.

BOOL IsDrawShadedHighlight() const;

Valore restituito

TRUE se i bordi del pulsante sono ombreggiati; in caso contrario FALSE.

CMFCOutlookBarPane::RemoveAllButtons

Rimuove tutti i pulsanti dal riquadro della barra di Outlook.

virtual void RemoveAllButtons();

CMFCOutlookBarPane::RemoveButton

Rimuove il pulsante con un ID comando specificato.

BOOL RemoveButton(UINT iIdCommand);

Parametri

iIdCommand
[in] Specifica l'ID comando di un pulsante da rimuovere.

Valore restituito

TRUE se il pulsante è stato rimosso correttamente; FALSE se l'ID del comando specificato non è valido.

CMFCOutlookBarPane::SetBackColor

Imposta il colore di sfondo della barra di Outlook.

void SetBackColor(COLORREF color);

Parametri

color
[in] Specifica il nuovo colore di sfondo.

Osservazioni:

Chiamare questa funzione per impostare il colore di sfondo corrente per la barra di Outlook. Il colore di sfondo viene utilizzato solo se non è presente alcuna immagine di sfondo.

CMFCOutlookBarPane::SetBackImage

Imposta l'immagine di sfondo.

void SetBackImage(UINT uiImageID);

Parametri

uiImageID
[in] Specifica l'ID risorsa immagine.

Osservazioni:

Chiamare questo metodo per impostare l'immagine di sfondo della barra di Outlook. L'elenco delle immagini di sfondo viene gestito dall'oggetto classe CMFCToolBarImages incorporato.

CMFCOutlookBarPane::SetDefaultState

Reimposta il riquadro della barra di Outlook sul set originale di pulsanti.

void SetDefaultState();

Osservazioni:

Questo metodo ripristina i pulsanti della barra di Outlook nel set originale. Questo metodo è simile CMFCOutlookBarPane::RestoreOriginalstatea , ad eccezione del fatto che non attiva un ridisegno del riquadro della barra di Outlook.

CMFCOutlookBarPane::SetExtraSpace

Imposta il numero di pixel di spaziatura interna utilizzati intorno ai pulsanti nel riquadro della barra di Outlook.

void SetExtraSpace()

CMFCOutlookBarPane::SetTextColor

Imposta i colori del testo normale e evidenziato nel riquadro della barra di Outlook.

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

Parametri

clrRegText
[in] Specifica il nuovo colore per il testo non selezionato.

clrSelText
[in] Specifica il nuovo colore per il testo selezionato.

CMFCOutlookBarPane::SetTransparentColor

Imposta il colore trasparente per il riquadro della barra di Outlook.

void SetTransparentColor(COLORREF color);

Parametri

color
Specifica il nuovo colore trasparente.

Osservazioni:

Il colore trasparente è necessario per visualizzare immagini trasparenti. Qualsiasi occorrenza di questo colore in un'immagine viene invece dipinta con il colore di sfondo. Non esiste alcuna fusione di immagini di sfondo e di primo piano.

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCToolBar
Classe CMFCOutlookBar
Classe CMFCOutlookBarTabCtrl

Condividi tramite

Classe CMFCOutlookBarPane

Sintassi

Membri

Costruttori pubblici

Metodi pubblici

Metodi protetti

Osservazioni:

Esempio

Gerarchia di ereditarietà

Requisiti

CMFCOutlookBarPane::AddButton

Parametri

Valore restituito

Osservazioni:

CMFCOutlookBarPane::CanBeAttached

Valore restituito

Osservazioni:

CMFCOutlookBarPane::ClearAll

Osservazioni:

CMFCOutlookBarPane::Create

Parametri

Valore restituito

Osservazioni:

CMFCOutlookBarPane::EnableContextMenuItems

Parametri

Valore restituito

Osservazioni:

CMFCOutlookBarPane::EnablePageScrollMode

Parametri

CMFCOutlookBarPane::GetRegularColor

Valore restituito

Osservazioni:

CMFCOutlookBarPane::IsBackgroundTexture

Valore restituito

Osservazioni:

CMFCOutlookBarPane::IsDrawShadedHighlight

Valore restituito

CMFCOutlookBarPane::RemoveAllButtons

CMFCOutlookBarPane::RemoveButton

Parametri

Valore restituito

CMFCOutlookBarPane::SetBackColor

Parametri

Osservazioni:

CMFCOutlookBarPane::SetBackImage

Parametri

Osservazioni:

CMFCOutlookBarPane::SetDefaultState

Osservazioni:

CMFCOutlookBarPane::SetExtraSpace

CMFCOutlookBarPane::SetTextColor

Parametri

CMFCOutlookBarPane::SetTransparentColor

Parametri

Osservazioni:

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive