Classe CTabView
A classe CTabView simplifica o uso da classe de controle de guia ( CMFCTabCtrl) em aplicativos que usam a arquitetura de documento/modo de exibição do MFC.
Sintaxe
class CTabbedView : public CView
Membros
Métodos públicos
| Nome | Descrição |
|---|---|
| CTabView::AddView | Adiciona um novo modo de exibição ao controle de guia. |
| CTabView::FindTab | Retorna o índice da exibição especificada no controle de guia. |
| CTabView::GetActiveView | Retorna um ponteiro para o modo de exibição ativo no momento |
| CTabView::GetTabControl | Retorna uma referência ao controle de guia associado ao modo de exibição. |
| CTabView::RemoveView | Remove o modo de exibição do controle de guia. |
| CTabView::SetActiveView | Torna um modo de exibição ativo. |
Métodos protegidos
| Nome | Descriçã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. |
| CTabView::OnActivateView | Chamado pela estrutura quando o modo de exibição de guia fica ativo ou inativo. |
Comentários
Essa classe facilita a inserção de um modo de exibição em um aplicativo de documento/exibição. CTabView é uma classe derivada de CView que contém um objeto inserido CMFCTabCtrl. CTabView manipula todas as mensagens necessárias para dar suporte ao objeto CMFCTabCtrl. Basta derivar uma classe de CTabView e conectá-la ao seu aplicativo e, em seguida, adicionar classes derivadas de CView usando o método AddView. O controle de guia 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 exibições individuais desenhando os dados conforme necessário, inseri-los em seu objeto derivado de CTabView e colocá-los na guia sem qualquer codificação adicional.
Exemplo de TabbedView: aplicativo de modo de exibição com guias do MFC ilustra o uso de 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()
};
Requisitos
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
[in] Um ponteiro para uma classe de runtime do modo de exibição inserido.
strViewLabel
[in] Especifica o texto da guia.
iIndex
[in] 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.
pContext
[in] Um ponteiro para o modo de exibição CCreateContext.
Valor de retorno
Um índice do modo de exibição, se esse método for bem-sucedido. Caso contrário, -1.
Comentários
Chame essa função para adicionar um modo de exibição ao controle de guia inserido em um quadro.
CTabView::FindTab
Retorna o índice da exibição especificada no controle de guia.
int FindTab(HWND hWndView) const;
Parâmetros
hWndView
[in] O identificador do modo de exibição.
Valor de retorno
O índice do modo de exibição, se encontrado; caso contrário, -1.
Comentários
Chame essa função para recuperar o índice de um modo de exibição que tem 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 modo de exibição ativo.
Comentários
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 o modo de exibição de guia devesse ser criado junto com uma barra de rolagem compartilhada. Caso contrário, FALSE.
Comentários
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 o modo de exibição de guia fica ativo ou inativo.
virtual void OnActivateView(CView* view);
Parâmetros
view
[in] Um ponteiro para o modo de exibição.
Comentários
A implementação padrão não tem ação. Substitua esse método em uma classe derivada de CTabView para processar essa notificação.
CTabView::RemoveView
Remove o modo de exibição do controle de guia.
BOOL RemoveView(int iTabNum);
Parâmetros
iTabNum
[in] O índice do modo de exibição a ser removido.
Valor de retorno
O índice do modo de exibição removido se esse método for bem-sucedido. Caso contrário, -1.
Comentários
CTabView::SetActiveView
Torna um modo de exibição ativo.
BOOL SetActiveView(int iTabNum);
Parâmetros
iTabNum
[in] O índice baseado em zero do modo de exibição de guia.
Valor de retorno
TRUE se o modo de exibição especificado tiver sido ativado, FALSE se o índice do modo de exibição for inválido.
Comentários
Para obter mais informações, consulte CMFCTabCtrl::SetActiveTab.