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à
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; altrimenti FAL edizione Standard.
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; altrimenti FAL edizione Standard.
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 pagina didascalia 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 FAL edizione Standard, 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; altrimenti FAL edizione Standard;
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 FAL edizione Standard.
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
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