Classe CMFCOutlookBarPane
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; altrimenti FAL edizione Standard.
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; altrimenti FAL edizione Standard.
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; altrimenti FAL edizione Standard.
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 FAL edizione Standard, 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; altrimenti FAL edizione Standard.
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; altrimenti FAL edizione Standard.
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; FAL edizione Standard se l'ID 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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per