Classe CBaseTabbedPane
Estende a funcionalidade da Classe CDockablePane para dar suporte à criação de janelas com guias.
Sintaxe
class CBaseTabbedPane : public CDockablePane
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
CBaseTabbedPane::CBaseTabbedPane |
Construtor padrão. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CBaseTabbedPane::AddTab | Adiciona uma nova guia a um painel com guias. |
| CBaseTabbedPane::AllowDestroyEmptyTabbedPane | Especifica se um painel com guias vazio pode ser destruído. |
| CBaseTabbedPane::ApplyRestoredTabInfo | Aplica as configurações de guia, que são carregadas do registro, a um painel com guias. |
| CBaseTabbedPane::CanFloat | Determina se o painel pode flutuar. (Substitui CBasePane::CanFloat.) |
| CBaseTabbedPane::CanSetCaptionTextToTabName | Determina se a legenda do painel com guias deve exibir o mesmo texto que a guia ativa. |
| CBaseTabbedPane::ConvertToTabbedDocument | (Substitui CDockablePane::ConvertToTabbedDocument.) |
| CBaseTabbedPane::DetachPane | Converte um ou mais painéis encaixáveis em documentos com guia MDI. |
| CBaseTabbedPane::EnableSetCaptionTextToTabName | Habilita ou desabilita a capacidade do painel com guias de sincronizar o texto de legenda com o texto de rótulo na guia ativa. |
| CBaseTabbedPane::FillDefaultTabsOrderArray | Restaura a ordem de tabulação interna para um estado padrão. |
| CBaseTabbedPane::FindBarByTabNumber | Retorna um painel que reside em uma guia quando a guia é identificada por um índice de guias baseado em zero. |
| CBaseTabbedPane::FindPaneByID | Retorna um painel identificado pela ID de painel. |
| CBaseTabbedPane::FloatTab | Faz com que um painel flutue, mas somente se o painel residir em uma guia desanexável. |
| CBaseTabbedPane::GetDefaultTabsOrder | Retorna a ordem padrão das guias no painel. |
| CBaseTabbedPane::GetFirstVisibleTab | Recupera um ponteiro para a primeira guia exibida. |
| CBaseTabbedPane::GetMinSize | Recupera o tamanho mínimo permitido para o painel. (Substitui CPane::GetMinSize.) |
| CBaseTabbedPane::GetPaneIcon | Retorna um identificador para o ícone do painel. (Substitui CBasePane::GetPaneIcon.) |
| CBaseTabbedPane::GetPaneList | Retorna uma lista de painéis contidos no painel com guias. |
| CBaseTabbedPane::GetTabArea | Retorna os retângulos delimitadores para as áreas superior e inferior da guia. |
| CBaseTabbedPane::GetTabsNum | Retorna a contagem de guias em uma janela de guia. |
| CBaseTabbedPane::GetUnderlyingWindow | Obtém a janela da guia subjacente (encapsulada). |
| CBaseTabbedPane::GetVisibleTabsNum | Retorna a contagem de guias exibidas. |
| CBaseTabbedPane::HasAutoHideMode | Determina se o painel com guias pode ser alternado para o modo de ocultação automática. |
| CBaseTabbedPane::IsHideSingleTab | Determina se o painel com guias será ocultado se apenas uma guia for exibida. |
CBaseTabbedPane::LoadSiblingPaneIDs |
Usado internamente durante a serialização. |
| CBaseTabbedPane::RecalcLayout | Recalcula informações de layout do painel. (Substitui CPane::RecalcLayout.) |
| CBaseTabbedPane::RemovePane | Remove um painel do painel com guias. |
CBaseTabbedPane::SaveSiblingBarIDs |
Usado internamente durante a serialização. |
CBaseTabbedPane::Serialize |
(Substitui CDockablePane::Serialize.) |
CBaseTabbedPane::SerializeTabWindow |
Usado internamente durante a serialização. |
| CBaseTabbedPane::SetAutoDestroy | Determina se a barra de controle com guias será destruída automaticamente. |
| CBaseTabbedPane::SetAutoHideMode | Alterna o painel de encaixe entre o modo exibido e de ocultação automática. (Substitui CDockablePane::SetAutoHideMode.) |
| CBaseTabbedPane::ShowTab | Mostra ou oculta uma guia. |
Comentários
Essa é uma classe abstrata e não pode ter uma instância criada. Ele implementa os serviços comuns a todos os tipos de painéis com guias.
Atualmente, a biblioteca inclui duas classes de painel com guias: classe CTabbedPane e classe CMFCOutlookBar.
Um objeto CBaseTabbedPane encapsula um ponteiro para um objeto CMFCBaseTabCtrl Class. A classe CMFCBaseTabCtrl torna-se uma janela filho do painel com guias.
Para obter mais informações sobre como criar painéis com guias, consulte Classe CDockablePane, Classe CTabbedPane e Classe CMFCOutlookBar.
Hierarquia de herança
CBaseTabbedPane
Requisitos
Cabeçalho: afxBaseTabbedPane.h
CBaseTabbedPane::AddTab
Adiciona uma nova guia a um painel com guias.
virtual BOOL AddTab(
CWnd* pNewBar,
BOOL bVisible = TRUE,
BOOL bSetActive = TRUE,
BOOL bDetachable = TRUE);
Parâmetros
pNewBar
[in, out] Um ponteiro para o painel a ser adicionado. Esse ponteiro poderá se tornar inválido após você chamar esse método. Para obter mais informações, consulte a seção Comentários.
bVisible
[in] TRUE para tornar a guia visível; caso contrário, FALSE.
bSetActive
[in] TRUE para fazer da guia a guia ativa; caso contrário, FALSE.
bDetachable
[in] TRUE para tornar a guia desanexável; caso contrário, FALSE.
Valor de Devolução
TRUE se o painel foi adicionado com êxito como uma guia e não foi destruído no processo. FALSE se o painel que está sendo adicionado for um objeto do tipo CBaseTabbedPane. Para obter mais informações, consulte a seção Comentários.
Comentários
Chame esse método para adicionar um painel como uma nova guia em um painel com guias. Se pNewBar apontar para um objeto do tipo CBaseTabbedPane, todas as suas guias serão copiadas no painel com guias e pNewBar será destruída. Portanto, pNewBar se tornará ponteiro inválido e não deverá ser usada.
CBaseTabbedPane::AllowDestroyEmptyTabbedPane
Especifica se um painel com guias vazio pode ser destruído.
virtual BOOL AllowDestroyEmptyTabbedPane() const;
Valor de Devolução
TRUE se um painel com guias vazio puder ser destruído; caso contrário, FALSE. A implementação padrão sempre retorna TRUE.
Comentários
Se um painel com guias vazio não puder ser destruído, a estrutura ocultará o painel.
CBaseTabbedPane::ApplyRestoredTabInfo
Carrega as configurações da guia do registro e as aplica a um painel com guias.
virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);
Parâmetros
bUseTabIndexes
[in] Esse parâmetro é usado internamente pela estrutura.
Comentários
Esse método é chamado pela estrutura quando recarrega as informações de estado de encaixe do registro. O método obtém informações sobre a ordem de tabulação e os nomes das guias para um painel com guias.
CBaseTabbedPane::CanFloat
Especifica se o painel com guias pode flutuar.
virtual BOOL CanFloat() const;
Valor de Devolução
TRUE se o painel puder flutuar; caso contrário, FALSE.
CBaseTabbedPane::CanSetCaptionTextToTabName
Determina se a legenda do painel com guias deve exibir o mesmo texto que a guia ativa.
virtual BOOL CanSetCaptionTextToTabName() const;
Valor de Devolução
TRUE se o texto de legenda do painel com guias estiver definido como o texto da guia ativa; caso contrário, FALSE.
Comentários
O método é usado para determinar se o texto exibido na legenda do painel com guias duplica o rótulo da guia ativa. Você pode habilitar ou desabilitar essa funcionalidade chamando CBaseTabbedPane::EnableSetCaptionTextToTabName.
CBaseTabbedPane::ConvertToTabbedDocument
Converte um ou mais painéis encaixáveis em documentos com guia MDI.
virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);
Parâmetros
bActiveTabOnly
[in] Ao converter um painel com guias, especifique TRUE para converter apenas a guia ativa e FALSE para converter todas as guias no painel.
CBaseTabbedPane::DetachPane
Desanexa um painel do painel com guias.
virtual BOOL DetachPane(
CWnd* pBar,
BOOL bHide = FALSE);
Parâmetros
pBar
[in] Ponteiro para o painel que será desanexado.
bHide
[in] Parâmetro booliano que especifica se a estrutura oculta o painel após ele ser desanexado.
Valor de Devolução
TRUE se a estrutura desanexar com êxito o painel; FALSE se pBar for NULL ou se referir a um painel que não está no painel com guias.
Comentários
A estrutura faz com que o painel desanexado flutue, se possível. Para obter mais informações, consulte CBasePane::CanFloat.
CBaseTabbedPane::EnableSetCaptionTextToTabName
Habilita ou desabilita a capacidade do painel com guias de sincronizar o texto de legenda com o texto de rótulo na guia ativa.
virtual void EnableSetCaptionTextToTabName(BOOL bEnable);
Parâmetros
bEnable
[in] TRUE para sincronizar a legenda do painel com guias e a legenda da guia ativa; caso contrário, FALSE.
CBaseTabbedPane::FillDefaultTabsOrderArray
Restaura a ordem de tabulação interna para um estado padrão.
void FillDefaultTabsOrderArray();
Comentários
Esse método é chamado quando a estrutura restaura uma barra do Outlook para o estado inicial.
CBaseTabbedPane::FindPaneByID
Retorna um painel identificado pela ID de painel.
virtual CWnd* FindPaneByID(UINT uBarID);
Parâmetros
uBarID
[in] Especifica a ID do painel a ser localizado.
Valor de Devolução
Um ponteiro para o painel, se localizado; caso contrário, NULL.
Comentários
Esse método compara todas as guias no painel e retorna aquela com a ID especificada pelo parâmetro uBarID.
CBaseTabbedPane::FindBarByTabNumber
Retorna um painel que reside em uma guia.
virtual CWnd* FindBarByTabNumber(
int nTabNum,
BOOL bGetWrappedBar = FALSE);
Parâmetros
nTabNum
[in] Especifica o índice baseado em zero da guia a ser recuperada.
bGetWrappedBar
[in] TRUE para retornar a janela subjacente (encapsulada) do painel em vez do próprio painel; caso contrário, FALSE. Isso se aplica somente a painéis derivados de CDockablePaneAdapter.
Valor de Devolução
Se o painel for encontrado, um ponteiro válido para o painel que está sendo pesquisado será retornado; caso contrário, NULL.
Comentários
Chame esse método para recuperar o painel que reside na guia especificada pelo parâmetro nTabNum.
CBaseTabbedPane::FloatTab
Faz com que um painel flutue, mas somente se o painel residir em uma guia desanexável.
virtual BOOL FloatTab(
CWnd* pBar,
int nTabID,
AFX_DOCK_METHOD dockMethod,
BOOL bHide = FALSE);
Parâmetros
pBar
[in, out] Um ponteiro para o painel que deverá flutuar.
nTabID
[in] Especifica o índice baseado em zero da guia que deverá flutuar.
dockMethod
[in] Especifica o método a ser usado para fazer o painel flutuar. Para obter mais informações, consulte a seção Comentários.
bHide
[in] TRUE para ocultar o painel antes de flutuar; caso contrário, FALSE.
Valor de Devolução
TRUE se o painel flutuou; caso contrário, FALSE.
Comentários
Chame esse método para fazer flutuar um painel que reside em uma guia desanexável.
Se você quiser desanexar um painel de maneira programática, especifique DM_SHOW para o parâmetro dockMethod. Se você quiser fazer o painel flutuar na mesma posição em que ele flutuou anteriormente, especifique DM_DBL_CLICK como o parâmetro dockMethod.
CBaseTabbedPane::GetDefaultTabsOrder
Retorna a ordem padrão das guias no painel.
const CArray<int,int>& GetDefaultTabsOrder();
Valor de Devolução
Um objeto CArray que especifica a ordem padrão das guias no painel.
Comentários
A estrutura chama esse método quando uma barra do Outlook é redefinida para um estado inicial.
CBaseTabbedPane::GetFirstVisibleTab
Recupera um ponteiro para a primeira guia exibida.
virtual CWnd* GetFirstVisibleTab(int& iTabNum);
Parâmetros
iTabNum
[in] Uma referência a um inteiro. Esse método gravará o índice baseado em zero da primeira guia exibida nesse parâmetro ou -1 se nenhuma guia exibida for encontrada.
Valor de Devolução
Se tiver êxito, um ponteiro para a primeira guia exibida; caso contrário, NULL.
CBaseTabbedPane::GetMinSize
Recupera o tamanho mínimo permitido para o painel.
virtual void GetMinSize(CSize& size) const;
Parâmetros
size
[out] Um objeto CSize que é preenchido com o tamanho mínimo permitido.
Comentários
Se a manipulação consistente de tamanhos mínimos do painel estiver ativa (CPane::m_bHandleMinSize), size será preenchido com o tamanho mínimo permitido para a guia ativa. Caso contrário, size será preenchido com o valor retornado de CPane::GetMinSize.
CBaseTabbedPane::GetPaneIcon
Recupera o tamanho mínimo permitido para o painel.
virtual void GetMinSize(CSize& size) const;
Parâmetros
size
[out] Um objeto CSize que é preenchido com o tamanho mínimo permitido.
Comentários
Se a manipulação consistente de tamanhos mínimos do painel estiver ativa (CPane::m_bHandleMinSize), size será preenchido com o tamanho mínimo permitido para a guia ativa. Caso contrário, size será preenchido com o valor retornado de CPane::GetMinSize.
CBaseTabbedPane::GetPaneList
Retorna uma lista de painéis contidos no painel com guias.
virtual void GetPaneList(
CObList& lst,
CRuntimeClass* pRTCFilter = NULL);
Parâmetros
lst
[out] Um CObList preenchido com os painéis contidos no painel com guias.
pRTCFilter
[in] Se ele não for NULL, a lista retornada conterá apenas painéis da classe de runtime especificada.
CBaseTabbedPane::GetTabArea
Retorna os retângulos delimitadores para as áreas superior e inferior da guia.
virtual void GetTabArea(
CRect& rectTabAreaTop,
CRect& rectTabAreaBottom) const = 0;
Parâmetros
rectTabAreaTop
[out] Recebe as coordenadas de tela da área superior da guia.
rectTabAreaBottom
[out] Recebe as coordenadas de tela da área inferior da guia.
Comentários
Chame esse método para determinar os retângulos delimitadores, em coordenadas de tela, para as áreas superior e inferior da guia.
CBaseTabbedPane::GetTabsNum
Retorna a contagem de guias em uma janela de guia.
virtual int GetTabsNum() const;
Valor de Devolução
O número de guias no painel com guias.
CBaseTabbedPane::GetUnderlyingWindow
Obtém a janela da guia subjacente (encapsulada).
virtual CMFCBaseTabCtrl* GetUnderlyingWindow();
Valor de Devolução
Um ponteiro para a janela da guia subjacente.
CBaseTabbedPane::GetVisibleTabsNum
Retorna a contagem de guias visíveis.
virtual int GetVisibleTabsNum() const;
Valor de Devolução
O número de guias visíveis, que será maior ou igual a zero.
Comentários
Chame esse método para determinar o número de guias visíveis no painel com guias.
CBaseTabbedPane::HasAutoHideMode
Determina se o painel com guias pode ser alternado para o modo de ocultação automática.
virtual BOOL HasAutoHideMode() const;
Valor de Devolução
TRUE se o painel puder ser alternado para o modo de ocultação automática; caso contrário, FALSE.
Comentários
Se o modo de ocultação automática estiver desabilitado, nenhum botão de fixação será exibido na legenda do painel com guias.
CBaseTabbedPane::IsHideSingleTab
Determina se o painel com guias será ocultado se apenas uma guia for exibida.
virtual BOOL IsHideSingleTab() const;
Valor de Devolução
TRUE se a janela com guias não for mostrada quando houver apenas uma guia visível; caso contrário, FALSE.
Comentários
Se o painel não for exibido porque apenas uma guia está aberta, você poderá chamar esse método para determinar se o painel com guias está funcionando corretamente.
CBaseTabbedPane::RemovePane
Remove um painel do painel com guias.
virtual BOOL RemovePane(CWnd* pBar);
Parâmetros
pBar
[in, out] Um ponteiro para o painel a ser removido do painel com guias.
Valor de Devolução
TRUE se o painel tiver sido removido com êxito do painel com guias e se o painel com guias ainda for válido. FALSE se o último painel tiver sido removido do painel com guias e o painel com guias estiver prestes a ser destruído. Se o valor retornado for FALSE, não use mais o painel com guias.
Comentários
Chame esse método para remover o painel especificado pelo parâmetro pBar do painel com guias.
CBaseTabbedPane::SetAutoDestroy
Determina se a barra de controle com guias será destruída automaticamente.
void SetAutoDestroy(BOOL bAutoDestroy = TRUE);
Parâmetros
bAutoDestroy
[in] TRUE se o painel com guias foi criado dinamicamente e você não está controlando o tempo de vida dele; caso contrário, FALSE.
Comentários
Defina o modo de destruição automática como TRUE se você criar um painel com guias dinamicamente e se não estiver controlando o tempo de vida dele. Se o modo de destruição automática for TRUE, o painel com guias será destruído automaticamente pela estrutura.
CBaseTabbedPane::ShowTab
Mostra ou oculta uma guia.
virtual BOOL ShowTab(
CWnd* pBar,
BOOL bShow,
BOOL bDelay,
BOOL bActivate);
Parâmetros
pBar
[in] Um ponteiro para o painel a ser mostrado ou ocultado.
bShow
[in] TRUE para mostrar o painel; FALSE para ocultá-lo.
bDelay
[in] TRUE para atrasar o ajuste do layout da guia; caso contrário, FALSE.
bActivate
[in] TRUE para fazer da guia a guia ativa; caso contrário, FALSE.
Valor de Devolução
TRUE se a guia foi mostrada ou ocultada com êxito; caso contrário, FALSE.
Comentários
Quando você chama esse método, um painel é mostrado ou ocultado, dependendo do valor do parâmetro bShow. Se você ocultar uma guia e ela for a última guia visível na janela da guia subjacente, o painel com guias ficará oculto. Se você mostrar uma guia quando não havia guias visíveis anteriormente, o painel com guias será mostrado.
CBaseTabbedPane::RecalcLayout
Recalcula informações de layout do painel.
virtual void RecalcLayout();
Comentários
Se o painel estiver flutuando, esse método notificará a estrutura para redimensionar o painel para o tamanho atual da minimoldura.
Se o painel estiver encaixado, o método não fará nada.
CBaseTabbedPane::SetAutoHideMode
Define o modo de ocultação automática para painéis desanexáveis no painel com guias.
virtual CMFCAutoHideToolBar* SetAutoHideMode(
BOOL bMode,
DWORD dwAlignment,
CMFCAutoHideToolBar* pCurrAutoHideBar = NULL,
BOOL bUseTimer = TRUE);
Parâmetros
bMode
[in] TRUE para habilitar o modo de ocultação automática; FALSE para habilitar o modo de encaixe regular.
dwAlignment
[in] Especifica o alinhamento do painel com ocultação automática a ser criado. Para obter uma lista de valores possíveis, confira CPane::MoveByAlignment.
pCurrAutoHideBar
[in, out] Um ponteiro para a barra de ferramentas com ocultação automática atual. Pode ser NULL.
bUseTimer
[in] Especifica se é necessário usar o efeito de ocultação automática quando o usuário alterna o painel para o modo de ocultação automática ou se o painel deve ser ocultado imediatamente.
Valor de Devolução
Um ponteiro para a barra de ferramentas com ocultação automática criada ao alternar para o modo com ocultação automática ou NULL se nenhuma barra de ferramentas for criada.
Comentários
A estrutura chama esse método quando um usuário escolhe o botão fixar para alternar o painel com guias para o modo de ocultação automática ou para o modo de encaixe regular.
O modo de ocultação automática é definido para cada painel desanexável no painel com guias. Painéis que não são desanexáveis são ignorados. Para obter mais informações, consulte CMFCBaseTabCtrl::EnableTabDetach.
Chame esse método para alternar um painel com guias para o modo de ocultação automática de maneira programática. O painel deve ser encaixado na janela de quadro principal (CDockablePane::GetDefaultPaneDivider deve retornar um ponteiro válido para o CPaneDivider).
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de