CTabView Classe

A CTabView classe simplifica o uso da classe de controle de guia ( CMFCTabCtrl) em aplicativos que usam a arquitetura de documento/exibição do MFC.

Sintaxe

class CTabbedView : public CView

Membros

Métodos Públicos

Métodos Protegidos

Observações

Essa classe facilita a colocação de um modo de exibição com guias em um aplicativo de documento/exibição. CTabView é uma CViewclasse derivada que contém um objeto incorporado CMFCTabCtrl . CTabView lida com todas as mensagens necessárias para dar suporte ao CMFCTabCtrl objeto. Basta derivar uma classe e CTabView conectá-la ao seu aplicativo e, em seguida, adicionar CViewclasses derivadas usando o AddView método. O controle tab exibirá esses modos de exibição como guias.

Por exemplo, você pode ter um documento que pode ser representado de diferentes maneiras: como uma planilha, um gráfico, um formulário editável e assim por diante. Você pode criar visualizações individuais desenhando os dados conforme necessário, inseri-los em seu CTabViewobjeto derivado e tê-los tabulados sem qualquer codificação adicional.

Exemplo de TabbedView: O aplicativo MFC Tabbed View ilustra o uso do CTabView.

Exemplo

O exemplo a seguir mostra como CTabView é usado no exemplo 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()
};

Requerimentos

Cabeçalho: afxTabView.h

CTabView::AddView

Adiciona um modo de exibição ao controle de guia.

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

Parâmetros

pViewClass
[em] Um ponteiro para uma classe de tempo de execução do modo de exibição inserido.

strViewLabel
[em] Especifica o texto da guia.

iÍndice
[em] Especifica a posição baseada em zero na qual inserir o modo de exibição. Se a posição for -1 a nova guia será inserida no final.

pContexto
[em] Um ponteiro para o CCreateContext da vista.

Valor de retorno

Um índice de exibição se esse método for bem-sucedido. Caso contrário, -1.

Observações

Chame essa função para adicionar um modo de exibição ao controle de guia incorporado em um quadro.

CTabView::FindTab

Retorna o índice do modo de exibição especificado no controle de guia.

int FindTab(HWND hWndView) const;

Parâmetros

hWndView
[em] A alça da vista.

Valor de retorno

O índice da vista, se for encontrado; caso contrário, -1.

Observações

Chame essa função para recuperar o índice de um modo de exibição que tenha um identificador especificado.

CTabView::GetActiveView

Retorna um ponteiro para o modo de exibição ativo no momento.

CView* GetActiveView() const;

Valor de retorno

Um ponteiro válido para o modo de exibição ativo ou NULL se não houver nenhum modo de exibição ativo.

Observações

CTabView::GetTabControl

Retorna uma referência ao controle de guia associado ao modo de exibição.

DECLARE_DYNCREATE CMFCTabCtrl& GetTabControl();

Valor de retorno

Uma referência ao controle de guia associado ao modo de exibição.

CTabView::IsScrollBar

Chamado pela estrutura ao criar um modo de exibição de guia para determinar se o modo de exibição de guia tem uma barra de rolagem horizontal compartilhada.

virtual BOOL IsScrollBar() const;

Valor de retorno

TRUE se a visualização de tabulação deve ser criada junto com uma barra de rolagem compartilhada. Caso contrário, é FALSE.

Observações

A estrutura chama esse método quando um objeto CTabView está sendo criado.

Substitua o método IsScrollBar em uma classe derivada de CTabView e retorne TRUE se você quiser criar um modo de exibição que tenha uma barra de rolagem horizontal compartilhada.

CTabView::OnActivateView

Chamado pela estrutura quando a exibição de guia é ativada ou inativa.

virtual void OnActivateView(CView* view);

Parâmetros

Vista
[em] Um ponteiro para a vista.

Observações

A implementação padrão não faz nada. Substitua esse método em uma CTabViewclasse derivada para processar essa notificação.

CTabView::RemoveView

Remove o modo de exibição do controle de guia.

BOOL RemoveView(int iTabNum);

Parâmetros

iTabNum
[em] O índice da vista a remover.

Valor de retorno

O índice do modo de exibição removido se esse método for bem-sucedido. Caso contrário, -1.

Observações

CTabView::SetActiveView

Torna um modo de exibição ativo.

BOOL SetActiveView(int iTabNum);

Parâmetros

iTabNum
[em] O índice baseado em zero da exibição de guia.

Valor de retorno

TRUE se a vista especificada tiver sido ativada, FALSE se o índice da vista for inválido.

Observações

Para obter mais informações, consulte CMFCTabCtrl::SetActiveTab.

Ver também

Gráfico de hierarquia
Classes
CMFCTabCtrl
Classe CView