Classe CMFCOutlookBarTabCtrl

Controllo Struttura a schede che presenta l'aspetto visivo del Riquadro di navigazione in Microsoft Outlook. Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

Sintassi

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

Membri

Costruttori pubblici

Nome Descrizione
CMFCOutlookBarTabCtrl::CMFCOutlookBarTabCtrl Costruttore predefinito.
CMFCOutlookBarTabCtrl::~CMFCOutlookBarTabCtrl Distruttore.

Metodi pubblici

Nome Descrizione
CMFCOutlookBarTabCtrl::AddControl Aggiunge un controllo Windows come nuova scheda nella barra di Outlook.
CMFCOutlookBarTabCtrl::CalcRectEdit Chiamato dal framework per determinare le dimensioni della casella di modifica visualizzata quando un utente rinomina una scheda. (Esegue l'override CMFCBaseTabCtrl::CalcRectEditdi .
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons Chiamato dal framework durante le operazioni di ridimensionamento per determinare se è possibile visualizzare un numero inferiore di pulsanti della scheda della barra di Outlook rispetto a quelli attualmente visibili.
CMFCOutlookBarTabCtrl::CanShowMorePageButtons Chiamato dal framework durante le operazioni di ridimensionamento per determinare se è possibile visualizzare più pulsanti della pagina della scheda della barra di Outlook rispetto a quelli attualmente visibili.
CMFCOutlookBarTabCtrl::Create Crea il controllo struttura a schede della barra di Outlook.
CMFCOutlookBarTabCtrl::CreateObject Usato dal framework per creare un'istanza dinamica di questo tipo di classe.
CMFCOutlookBarTabCtrl::EnableAnimation Specifica se l'animazione che si verifica durante il passaggio tra le schede attive è abilitata.
CMFCOutlookBarTabCtrl::EnableInPlaceEdit Specifica se un utente può modificare le etichette di testo nei pulsanti della scheda della barra di Outlook. (sostituzioni )CMFCBaseTabCtrl::EnableInPlaceEdit.
CMFCOutlookBarTabCtrl::EnableScrollButtons Chiamato dal framework per abilitare i pulsanti che consentono all'utente di scorrere i pulsanti nel riquadro della barra di Outlook.
CMFCOutlookBarTabCtrl::FindTargetWnd Identifica il riquadro contenente un punto specificato. (sostituzioni )CMFCBaseTabCtrl::FindTargetWnd.
CMFCOutlookBarTabCtrl::GetBorderSize Restituisce le dimensioni del bordo del controllo struttura a schede di Outlook.
CMFCOutlookBarTabCtrl::GetTabArea Recupera le dimensioni e la posizione dell'area delle schede del controllo Struttura a schede. (sostituzioni )CMFCBaseTabCtrl::GetTabArea.
CMFCOutlookBarTabCtrl::GetThisClass Usato dal framework per ottenere un puntatore all'oggetto CRuntimeClass associato a questo tipo di classe.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation Determina se l'animazione che si verifica durante il passaggio tra le schede attive è abilitata.
CMFCOutlookBarTabCtrl::IsMode2003 Determina se il controllo struttura a schede della barra di Outlook è in modalità che emula Microsoft Outlook 2003.
CMFCOutlookBarTabCtrl::IsPtInTabArea Determina se un punto è all'interno dell'area delle schede. (sostituzioni )CMFCBaseTabCtrl::IsPtInTabArea.
CMFCOutlookBarTabCtrl::IsTabDetachable Determina se una scheda è rimovibile. (sostituzioni )CMFCBaseTabCtrl::IsTabDetachable.
CMFCOutlookBarTabCtrl::OnChangeTabs Chiamato dal framework quando una scheda viene inserita o rimossa. Esegue l'override di CMFCBaseTabCtrl::OnChangeTabs.
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons Chiamato dal framework per ridurre il numero di pulsanti di pagina di tabulazioni visibili.
CMFCOutlookBarTabCtrl::OnShowMorePageButtons Chiamato dal framework per aumentare il numero di pulsanti della pagina di tabulazioni visibili.
CMFCOutlookBarTabCtrl::OnShowOptions Visualizza la finestra di dialogo Opzioni riquadro di spostamento.
CMFCOutlookBarTabCtrl::RecalcLayout Ricalcola il layout interno del controllo Struttura a schede. (sostituzioni )CMFCBaseTabCtrl::RecalcLayout.
CMFCOutlookBarTabCtrl::SetActiveTab Imposta la scheda attiva. Esegue l'override di CMFCBaseTabCtrl::SetActiveTab.
CMFCOutlookBarTabCtrl::SetBorderSize Imposta le dimensioni del bordo del controllo struttura a schede di Outlook.
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign Imposta l'allineamento delle etichette di testo nei pulsanti della scheda della barra di Outlook.
CMFCOutlookBarTabCtrl::SetToolbarImageList Imposta la bitmap che contiene le icone visualizzate nella parte inferiore della barra di Outlook in modalità Outlook 2003 (vedere Classe CMFCOutlookBar).
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Osservazioni:

Per creare una barra di Outlook con supporto per l'ancoraggio, utilizzare un CMFCOutlookBar oggetto per ospitare il controllo scheda della barra di Outlook. Per altre informazioni, vedere Classe CMFCOutlookBar.

Esempio

Nell'esempio seguente viene illustrato come inizializzare un CMFCOutlookBarTabCtrl oggetto e utilizzare vari metodi nella CMFCOutlookBarTabCtrl classe . Nell'esempio viene illustrato come abilitare la modifica sul posto dell'etichetta di testo nei pulsanti della scheda della barra di Outlook, abilitare l'animazione, abilitare gli handle di scorrimento che consentono all'utente di scorrere i pulsanti nel riquadro della barra di Outlook, impostare le dimensioni del bordo del controllo struttura a schede di Outlook e impostare l'allineamento delle etichette di testo nei pulsanti di tabulazione della barra di Outlook. Questo frammento di codice fa parte dell'esempio demo di Outlook.

// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();
pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCOutlookBarTabCtrl

Requisiti

Intestazione: afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl::AddControl

Aggiunge un controllo Windows come nuova scheda nella barra di 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);

Parametri

pWndCtrl
[in] Puntatore a un controllo da aggiungere.

lpszName
[in] Specifica il nome della scheda.

bDetachable
[in] Se TRUE, la pagina verrà creata come scollegabile.

nImageID
[in] Indice immagine nell'elenco di immagini interno per l'immagine da visualizzare nella nuova scheda.

dwControlBarStyle
[in] Specifica lo stile AFX_ CBRS_* per i riquadri di ancoraggio incapsulati.

Osservazioni:

Utilizzare questa funzione per aggiungere un controllo come nuova pagina di una barra di Outlook.

Questa funzione chiama internamente su CMFCBaseTabCtrl::AddTab.

Se si imposta bDetachable su TRUE, AddControl crea internamente un CDockablePaneAdapter oggetto ed esegue il wrapping del controllo aggiunto. Imposta automaticamente la classe di runtime della finestra a schede sulla classe di runtime di CMFCOutlookBar e la classe di runtime del frame mobile su CMultiPaneFrameWnd.

Esempio

Nell'esempio seguente viene illustrato come usare il AddControl metodo nella CMFCOutlookBarTabCtrl classe . Questo frammento di codice fa parte dell'esempio demo di 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

Chiamato dal framework durante le operazioni di ridimensionamento per determinare se è possibile visualizzare un numero inferiore di pulsanti della scheda della barra di Outlook rispetto a quelli attualmente visibili.

virtual BOOL CanShowFewerPageButtons() const;

Valore restituito

TRUE se sono presenti più pulsanti; in caso contrario FALSE.

Osservazioni:

Il controllo scheda della barra di Outlook aggiunge o rimuove dinamicamente le schede dallo schermo a seconda della quantità di spazio disponibile. Questo metodo viene usato dal framework per facilitare il processo.

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

Chiamato dal framework durante le operazioni di ridimensionamento per determinare se è possibile visualizzare più pulsanti della pagina della scheda della barra di Outlook rispetto a quelli attualmente visibili.

virtual BOOL CanShowMorePageButtons() const;

Valore restituito

TRUE se sono presenti pulsanti che non sono attualmente visibili; in caso contrario FALSE.

Osservazioni:

Il controllo struttura a schede della barra di Outlook aggiunge o rimuove dinamicamente le schede dallo schermo, a seconda della quantità di spazio disponibile. Questo metodo viene usato dal framework per facilitare il processo.

CMFCOutlookBarTabCtrl::Create

Crea il controllo struttura a schede della barra di Outlook.

virtual BOOL Create(
    const CRect& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametri

rect
[in] Specifica le dimensioni iniziali e la posizione, in pixel.

pParentWnd
[in] Punta alla finestra padre. Non deve essere NULL.

nID
[in] ID del controllo.

Valore restituito

Diverso da zero se il controllo è stato creato correttamente; in caso contrario, 0.

Osservazioni:

In genere, i controlli struttura a schede della barra di Outlook vengono creati quando la classe CMFCOutlookBar controlla il messaggio WM_CREATE del processo.

CMFCOutlookBarTabCtrl::EnableAnimation

Specifica se l'animazione che si verifica durante il passaggio tra le schede attive è abilitata.

static void EnableAnimation(BOOL bEnable=TRUE);

Parametri

bEnable
[in] Specifica se l'animazione deve essere abilitata o disabilitata.

Osservazioni:

Chiamare questa funzione per abilitare e disabilitare l'animazione. Quando l'utente apre una pagina di tabulazioni, la didascalia della pagina scorre verso l'alto o verso il basso se l'animazione è abilitata. Se l'animazione è disabilitata, la pagina diventa attiva immediatamente.

Per impostazione predefinita, l'animazione è abilitata.

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Specifica se un utente può modificare le etichette di testo nei pulsanti della scheda della barra di Outlook.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parametri

bEnable
Se TRUE, abilitare la modifica sul posto dell'etichetta di testo. Se FALSE, disabilitare la modifica sul posto.

Osservazioni:

Chiamare questa funzione per abilitare o disabilitare la modifica sul posto delle etichette di testo nei pulsanti della pagina delle schede. Per impostazione predefinita, la modifica sul posto è disabilitata.

CMFCOutlookBarTabCtrl::EnableScrollButtons

Chiamato dal framework per abilitare gli handle di scorrimento che consentono all'utente di scorrere i pulsanti nel riquadro della barra di Outlook.

void EnableScrollButtons(
    BOOL bEnable = TRUE,
    BOOL bIsUp = TRUE,
    BOOL bIsDown = TRUE);

Parametri

bEnable
[in] Determina se i pulsanti di scorrimento vengono visualizzati.

bIsUp
[in] Determina se viene visualizzata la barra di scorrimento superiore.

bIsDown
[in] Determina se viene visualizzata la barra di scorrimento inferiore.

Osservazioni:

Abilita la visualizzazione dei pulsanti di scorrimento. Questo metodo viene chiamato dal framework quando la scheda attiva cambia per ripristinare i pulsanti di scorrimento.

CMFCOutlookBarTabCtrl::GetBorderSize

Restituisce le dimensioni del bordo del controllo struttura a schede di Outlook.

int GetBorderSize() const;

Valore restituito

Dimensione del bordo, in pixel.

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

Valore restituito

Osservazioni:

CMFCOutlookBarTabCtrl::IsAnimation

Specifica se l'animazione che si verifica durante il passaggio tra le schede attive è abilitata.

static BOOL IsAnimation();

Valore restituito

Diverso da zero se l'animazione è abilitata; in caso contrario, 0.

Osservazioni:

Chiamare la funzione CMFCOutlookBarTabCtrl::EnableAnimation per abilitare o disabilitare l'animazione.

CMFCOutlookBarTabCtrl::IsMode2003

Determina se il controllo struttura a schede della barra di Outlook è in modalità che emula Microsoft Outlook 2003.

BOOL IsMode2003() const;

Valore restituito

TRUE se il controllo della scheda della barra di Outlook è in modalità Outlook 2003; in caso contrario FALSE;

Osservazioni:

Questo valore viene impostato da CMFCOutlookBar::SetMode2003.

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

Chiamato dal framework per ridurre il numero di pulsanti di pagina di tabulazioni visibili.

virtual void OnShowFewerPageButtons();

Osservazioni:

Questo metodo regola il numero di pulsanti di tabulazioni pagina visibili quando il controllo viene ridimensionato.

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Chiamato dal framework per aumentare il numero di pulsanti della pagina di tabulazioni visibili.

virtual void OnShowMorePageButtons();

Osservazioni:

Questo metodo regola il numero di pulsanti della pagina di tabulazioni visibili quando il controllo viene ridimensionato.

CMFCOutlookBarTabCtrl::OnShowOptions

Visualizza la finestra di dialogo Opzioni riquadro di spostamento.

virtual void OnShowOptions();

Osservazioni:

La finestra di dialogo Opzioni riquadro di spostamento consente all'utente di selezionare i pulsanti della pagina della scheda da visualizzare e l'ordine in cui vengono visualizzati.

Questo metodo viene chiamato dal framework quando l'utente seleziona la voce di menu Opzioni riquadro di spostamento dal menu di personalizzazione del controllo.

CMFCOutlookBarTabCtrl::SetActiveTab

Imposta la scheda attiva. La scheda attiva è quella aperta, con il relativo contenuto visibile.

virtual BOOL SetActiveTab(int iTab);

Parametri

iTab
[in] Indice in base zero di una scheda da aprire.

Valore restituito

Diverso da zero se la scheda specificata è stata aperta correttamente; in caso contrario, 0.

Osservazioni:

L'effetto visivo dell'impostazione della scheda attiva dipende dal fatto che sia stata abilitata l'animazione. Per altre informazioni, vedere CMFCOutlookBarTabCtrl::EnableAnimation.

CMFCOutlookBarTabCtrl::SetBorderSize

Imposta le dimensioni del bordo del controllo struttura a schede di Outlook.

void SetBorderSize(int nBorderSize);

Parametri

nBorderSize
[in] Specifica la nuova dimensione del bordo in pixel.

Osservazioni:

Imposta la nuova dimensione del bordo e ricalcola il layout della finestra di Outlook.

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Imposta l'allineamento delle etichette di testo nei pulsanti della scheda della barra di Outlook.

void SetPageButtonTextAlign(
    UINT uiAlign,
    BOOL bRedraw=TRUE);

Parametri

uiAlign
[in] Specifica l'allineamento del testo.

bRedraw
[in] Se TRUE, la finestra di Outlook verrà ridisegnata.

Osservazioni:

Usare questa funzione per modificare l'allineamento del testo per i pulsanti di pagina.

uiAlign può essere uno dei valori seguenti:

Costante Significato
TA_LEFT Allineamento a sinistra
TA_CENTER Allineamento al centro
TA_RIGHT Allineamento a destra

Il valore predefinito è TA_CENTER.

CMFCOutlookBarTabCtrl::SetToolbarImageList

Imposta la bitmap che contiene le icone visualizzate nella parte inferiore della barra di Outlook in modalità Outlook 2003.

BOOL SetToolbarImageList(
    UINT uiID,
    int cx,
    COLORREF clrTransp=RGB(255, 0, 255));

Parametri

uiID
[in] Specifica l'ID risorsa dell'immagine da caricare.

cx
[in] Specifica la larghezza di un'immagine nell'elenco di immagini, espressa in pixel.

clrTransp
[in] Valore RGB che specifica il colore trasparente.

Valore restituito

Restituisce TRUE se ha esito positivo; in caso contrario restituisce FALSE.

Osservazioni:

Utilizzare questa funzione per allegare un elenco di immagini le cui immagini verranno visualizzate sui pulsanti della barra degli strumenti in modalità Microsoft Office 2003. Gli indici di immagine devono corrispondere agli indici di pagina.

Questo metodo non deve essere chiamato se non in modalità Microsoft Office 2003. Per altre informazioni, vedere Classe CMFCOutlookBar.

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

Parametri

[in] nVisiblePageButtons

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCBaseTabCtrl
Classe CMFCOutlookBar
Classe CMFCOutlookBarPane