Classe CMFCOutlookBarTabCtrl

Articolo
08/04/2024

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::CalcRectEdit`di .
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à

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

Condividi tramite

Classe CMFCOutlookBarTabCtrl

Sintassi

Membri

Costruttori pubblici

Metodi pubblici

Osservazioni:

Esempio

Gerarchia di ereditarietà

Requisiti

CMFCOutlookBarTabCtrl::AddControl

Parametri

Osservazioni:

Esempio

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

Valore restituito

Osservazioni:

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

Valore restituito

Osservazioni:

CMFCOutlookBarTabCtrl::Create

Parametri

Valore restituito

Osservazioni:

CMFCOutlookBarTabCtrl::EnableAnimation

Parametri

Osservazioni:

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Parametri

Osservazioni:

CMFCOutlookBarTabCtrl::EnableScrollButtons

Parametri

Osservazioni:

CMFCOutlookBarTabCtrl::GetBorderSize

Valore restituito

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

Valore restituito

Osservazioni:

CMFCOutlookBarTabCtrl::IsAnimation

Valore restituito

Osservazioni:

CMFCOutlookBarTabCtrl::IsMode2003

Valore restituito

Osservazioni:

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

Osservazioni:

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Osservazioni:

CMFCOutlookBarTabCtrl::OnShowOptions

Osservazioni:

CMFCOutlookBarTabCtrl::SetActiveTab

Parametri

Valore restituito

Osservazioni:

CMFCOutlookBarTabCtrl::SetBorderSize

Parametri

Osservazioni:

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Parametri

Osservazioni:

CMFCOutlookBarTabCtrl::SetToolbarImageList

Parametri

Valore restituito

Osservazioni:

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Parametri

Osservazioni:

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive