Classe CTabView

La CTabView classe semplifica l'uso della classe del controllo struttura a schede ( CMFCTabCtrl) nelle applicazioni che usano l'architettura di documento/visualizzazione di MFC.

Sintassi

class CTabbedView : public CView

Membri

Metodi pubblici

Metodi protetti

Osservazioni:

Questa classe semplifica l'inserimento di una visualizzazione a schede in un'applicazione documento/visualizzazione. CTabView è una CViewclasse derivata da che contiene un oggetto incorporato CMFCTabCtrl . CTabView gestisce tutti i messaggi necessari per supportare l'oggetto CMFCTabCtrl . È sufficiente derivare una classe da CTabView e collegarla all'applicazione, quindi aggiungere CViewclassi derivate da usando il AddView metodo . Il controllo struttura a schede visualizzerà tali visualizzazioni come schede.

Ad esempio, si potrebbe avere un documento che può essere rappresentato in modi diversi: come foglio di calcolo, un grafico, un modulo modificabile e così via. È possibile creare visualizzazioni singole che disegnano i dati in base alle esigenze, inserirli nell'oggetto CTabViewderivato da e inserirli a schede senza scrivere codice aggiuntivo.

Esempio di TabbedView: Applicazione visualizzazione a schede MFC che illustra l'utilizzo di CTabView.

Esempio

L'esempio seguente illustra come CTabView viene usato nell'esempio TabbedView.

class CTabbedViewView : public CTabView
{
protected: // create from serialization only
   CTabbedViewView();
   DECLARE_DYNCREATE(CTabbedViewView)

   // Attributes
public:
   CTabbedViewDoc *GetDocument();

   // Operations
public:
   // Overrides
public:
   virtual void OnDraw(CDC *pDC); // overridden to draw this view
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);

protected:
   virtual BOOL OnPreparePrinting(CPrintInfo *pInfo);
   virtual void OnBeginPrinting(CDC *pDC, CPrintInfo *pInfo);
   virtual void OnEndPrinting(CDC *pDC, CPrintInfo *pInfo);

   BOOL IsScrollBar() const
   {
      return TRUE;
   }

   // Implementation
public:
   virtual ~CTabbedViewView();
#ifdef _DEBUG
   virtual void AssertValid() const;
   virtual void Dump(CDumpContext &dc) const;
#endif

protected:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
   afx_msg BOOL OnEraseBkgnd(CDC *pDC);
   afx_msg void OnContextMenu(CWnd *, CPoint point);
   afx_msg void OnFilePrintPreview();

   DECLARE_MESSAGE_MAP()
};

Requisiti

Intestazione: afxTabView.h

CTabView::AddView

Aggiunge una visualizzazione al controllo Struttura a schede.

int AddView(
    CRuntimeClass* pViewClass,
    const CString& strViewLabel,
    int iIndex=-1,
    CCreateContext* pContext=NULL);

Parametri

pViewClass
[in] Puntatore a una classe di runtime della visualizzazione inserita.

strViewLabel
[in] Specifica il testo della scheda.

iIndex
[in] Specifica la posizione in base zero in corrispondenza della quale inserire la vista. Se la posizione è -1, la nuova scheda viene inserita alla fine.

pContext
[in] Puntatore all'oggetto CCreateContext della visualizzazione.

Valore restituito

Indice di visualizzazione se questo metodo ha esito positivo. In caso contrario, -1.

Osservazioni:

Chiamare questa funzione per aggiungere una visualizzazione al controllo struttura a schede incorporato in un frame.

CTabView::FindTab

Restituisce l'indice della vista specificata nel controllo struttura a schede.

int FindTab(HWND hWndView) const;

Parametri

hWndView
[in] Handle della visualizzazione.

Valore restituito

Indice della vista se viene trovato; in caso contrario, -1.

Osservazioni:

Chiamare questa funzione per recuperare l'indice di una vista con un handle specificato.

CTabView::GetActiveView

Restituisce un puntatore alla visualizzazione attualmente attiva.

CView* GetActiveView() const;

Valore restituito

Puntatore valido alla visualizzazione attiva o NULL se non è presente alcuna visualizzazione attiva.

Osservazioni:

CTabView::GetTabControl

Restituisce un riferimento al controllo struttura a schede associato alla visualizzazione.

DECLARE_DYNCREATE CMFCTabCtrl& GetTabControl();

Valore restituito

Riferimento al controllo struttura a schede associato alla visualizzazione.

CTabView::IsScrollBar

Chiamato dal framework durante la creazione di una visualizzazione struttura a schede per determinare se la visualizzazione struttura ha una barra di scorrimento orizzontale condivisa.

virtual BOOL IsScrollBar() const;

Valore restituito

TRUE se la visualizzazione struttura a schede deve essere creata insieme a una barra di scorrimento condivisa. In caso contrario, FALSE.

Osservazioni:

Il framework chiama questo metodo quando viene creato un oggetto CTabView .

Eseguire l'override del metodo IsScrollBar in una classe derivata da CTabView e restituire TRUE se si desidera creare una visualizzazione con una barra di scorrimento orizzontale condivisa.

CTabView::OnActivateView

Chiamato dal framework quando la visualizzazione struttura viene resa attiva o inattiva.

virtual void OnActivateView(CView* view);

Parametri

view
[in] Puntatore alla visualizzazione.

Osservazioni:

L'implementazione predefinita non esegue alcuna operazione. Eseguire l'override di questo metodo in una CTabViewclasse derivata da per elaborare questa notifica.

CTabView::RemoveView

Rimuove la visualizzazione dal controllo Struttura a schede.

BOOL RemoveView(int iTabNum);

Parametri

iTabNum
[in] Indice della vista da rimuovere.

Valore restituito

Indice della vista rimossa se questo metodo ha esito positivo. In caso contrario -1.

Osservazioni:

CTabView::SetActiveView

Rende attiva una visualizzazione.

BOOL SetActiveView(int iTabNum);

Parametri

iTabNum
[in] Indice in base zero della visualizzazione struttura a schede.

Valore restituito

TRUE se la vista specificata è stata resa attiva, FALSE se l'indice della vista non è valido.

Osservazioni:

Per altre informazioni, vedere CMFCTabCtrl::SetActiveTab.

Vedi anche

Grafico della gerarchia
Classi
CMFCTabCtrl
Classe CView