Partilhar via

Classe CTabCtrl

  • Artigo

Fornece a funcionalidade do controle guia comum do Windows.

Sintaxe

class CTabCtrl : public CWnd

Membros

Construtores públicos

Nome Descrição
CTabCtrl::CTabCtrl Constrói um objeto CTabCtrl.

Métodos públicos

Nome Descrição
CTabCtrl::AdjustRect Calcula a área de exibição de um controle guia dado um retângulo de janela ou calcula o retângulo de janela que corresponderia a uma determinada área de exibição.
CTabCtrl::Create Cria um controle guia e o anexa a uma instância de um objeto TabCtrl
CTabCtrl::CreateEx Cria um controle guia com os estilos estendidos especificados do Windows e o anexa a uma instância de um objeto CTabCtrl.
CTabCtrl::DeleteAllItems Remove todos os itens de um controle guia.
CTabCtrl::DeleteItem Remove um item de um controle guia.
CTabCtrl::DeselectAll Redefine itens em um controle guia, desmarcando todos os que foram pressionados.
CTabCtrl::DrawItem Desenha um item especificado de um controle guia.
CTabCtrl::GetCurFocus Recupera a guia com o foco atual de um controle guia.
CTabCtrl::GetCurSel Determina a guia selecionada atualmente em um controle guia.
CTabCtrl::GetExtendedStyle Recupera os estilos estendidos que estão em uso para o controle guia.
CTabCtrl::GetImageList Recupera a lista de imagens associada a um controle guia.
CTabCtrl::GetItem Recupera informações sobre uma guia em um controle guia.
CTabCtrl::GetItemCount Recupera o número de guias no controle guia.
CTabCtrl::GetItemRect Recupera o retângulo delimitador de ma guia em um controle guia.
CTabCtrl::GetItemState Recupera o estado do item de controle guia indicado.
CTabCtrl::GetRowCount Recupera o número atual de linhas de guias em um controle guia.
CTabCtrl::GetToolTips Recupera o identificador do controle de dica de ferramenta associado a um controle guia.
CTabCtrl::HighlightItem Define o estado de realce de um item de guia.
CTabCtrl::HitTest Determina qual guia, se houver, está em uma posição especificada na tela.
CTabCtrl::InsertItem Insere uma nova guia em um controle guia.
CTabCtrl::RemoveImage Remove uma imagem da lista de imagens de um controle guia.
CTabCtrl::SetCurFocus Define o foco para uma guia especificada em um controle guia.
CTabCtrl::SetCurSel Seleciona uma guia em um controle guia.
CTabCtrl::SetExtendedStyle Define os estilos estendidos para um controle guia.
CTabCtrl::SetImageList Atribui uma lista de imagens a um controle guia.
CTabCtrl::SetItem Define alguns ou todos os atributos de uma guia.
CTabCtrl::SetItemExtra Define o número de bytes por guia reservado para dados definidos pelo aplicativo em um controle guia.
CTabCtrl::SetItemSize Define a largura e a altura de um item.
CTabCtrl::SetItemState Define o estado do item de controle guia indicado.
CTabCtrl::SetMinTabWidth Define a largura mínima dos itens em um controle guia.
CTabCtrl::SetPadding Define a quantidade de espaço (preenchimento) em torno do ícone e do rótulo de cada guia em um controle guia.
CTabCtrl::SetToolTips Atribui um controle de dica de ferramenta a um controle guia.

Comentários

Um "controle guia" é análogo aos divisores em um caderno ou aos rótulos em um armário de arquivos. Usando um controle tab, um aplicativo pode definir várias páginas para a mesma área de uma janela ou caixa de diálogo. Cada página é composta por um conjunto de informações ou um grupo de controles que o aplicativo exibe quando o usuário seleciona a guia correspondente. Um tipo especial de controle guia exibe guias que se parecem com botões. Clicar em um botão deve executar imediatamente um comando em vez de exibir uma página.

Esse controle (e, portanto, a classe CTabCtrl) está disponível apenas para programas em execução no Windows 95/98 e Windows NT versão 3.51 e posteriores.

Para obter mais informações sobre CTabCtrl, consulte Controles e Usando CTabCtrl.

Hierarquia de herança

CObject
CCmdTarget
CWnd

CTabCtrl

Requisitos

Cabeçalho: afxcmn.h

CTabCtrl::AdjustRect

Calcula a área de exibição de um controle guia dado um retângulo de janela ou calcula o retângulo de janela que corresponderia a uma determinada área de exibição.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

Parâmetros

bLarger
Indica qual operação executar. Se esse parâmetro for TRUE, lpRect especificará um retângulo de exibição e receberá o retângulo de janela correspondente. Se esse parâmetro for FALSE, lpRect especificará um retângulo de janela e receberá o retângulo de exibição correspondente.

lpRect
Ponteiro para uma estrutura RECT que especifica o retângulo fornecido e recebe o retângulo calculado.

Exemplo

void CTabDlg::OnSize(UINT nType, int cx, int cy)
{
   CDialog::OnSize(nType, cx, cy);

   if (m_TabCtrl.m_hWnd == NULL)
      return; // Return if window is not created yet.

   RECT rect;

   // Get size of dialog window.
   GetClientRect(&rect);

   // Adjust the rectangle to fit the tab control into the
   // dialog's client rectangle.
   m_TabCtrl.AdjustRect(FALSE, &rect);

   // Move the tab control to the new position and size.
   m_TabCtrl.MoveWindow(&rect, TRUE);
}

CTabCtrl::Create

Cria um controle guia e o anexa a uma instância de um objeto CTabCtrl.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parâmetros

dwStyle
Especifica o estilo do controle guia. Aplique qualquer combinação de estilos de controle guia, descritos no SDK do Windows. Consulte Comentários para obter uma lista de estilos de janela que você também pode aplicar ao controle.

rect
Especifica o tamanho e a posição do controle guia. Pode ser um objeto CRect ou uma estrutura RECT.

pParentWnd
Especifica a janela pai do controle guia, geralmente um CDialog. Não deve ser NULL.

nID
Especifica a ID do controle guia.

Valor de retorno

TRUE se a inicialização do objeto foi bem-sucedida; caso contrário, FALSE.

Comentários

Um objeto CTabCtrl é construído em duas etapas. Primeiro, chame o construtor e, em seguida, chame Create, que cria o controle guia e o anexa ao objeto CTabCtrl.

Além dos estilos de controle guia, você pode aplicar os seguintes estilos de janela a um controle guia:

  • WS_CHILD: cria uma janela filho que representa o controle guia. Não pode ser usado com o estilo WS_POPUP.
  • WS_VISIBLE: cria um controle guia inicialmente visível.
  • WS_DISABLED: cria uma janela inicialmente desabilitada.
  • WS_GROUP: especifica o primeiro controle de um grupo de controles no qual o usuário pode se mover de um controle para outro com as teclas de direção. Todos os controles definidos com o estilo WS_GROUP: após o primeiro controle pertencem ao mesmo grupo. O próximo controle com o estilo WS_GROUP: encerra o grupo de estilos e inicia o próximo grupo (ou seja, um grupo termina onde o próximo começa).
  • WS_TABSTOP: especifica um controle dentre qualquer número de controles por meio do qual o usuário pode se mover usando a tecla TAB. A tecla TAB move o usuário para o próximo controle especificado pelo estilo WS_TABSTOP:.

Para criar um controle guia com estilos de janela estendidos, chame CTabCtrl::CreateEx em vez de Create.

Exemplo

// Assuming you have a member variable m_TabCtrl, that is a CTabCtrl
// object, you can use the following to create a tab control.

m_TabCtrl.Create(TCS_TABS | TCS_FIXEDWIDTH | WS_CHILD | WS_VISIBLE,
                 rect, this, IDC_MYTAB);

// This creates a tab control with the given styles, and with
// an ID of IDC_MYTAB.

CTabCtrl::CreateEx

Cria um controle (uma janela filho) e o associa ao objeto CTabCtrl.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parâmetros

dwExStyle
Especifica o estilo estendido do controle que está sendo criado. Para obter uma lista de estilos estendidos do Windows, consulte o parâmetro dwExStyle para CreateWindowEx no SDK do Windows.

dwStyle
Especifica o estilo do controle guia. Aplique qualquer combinação de estilos de controle guia, descritos no SDK do Windows. Consulte os Comentários em Create para obter uma lista de estilos de janela que você também pode aplicar ao controle.

rect
Uma referência a uma estrutura RECT que descreve o tamanho e a posição da janela a ser criada, nas coordenadas de cliente de pParentWnd.

pParentWnd
Um ponteiro para a janela que é pai do controle.

nID
A ID da janela filho do controle.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

Use CreateEx, em vez de Create, para aplicar estilos estendidos do Windows, especificados pelo prefácio WS_EX_ de estilos estendidos do Windows.

CreateEx cria o controle com os estilos estendidos do Windows especificados por dwExStyle. Defina estilos estendidos específicos para um controle usando SetExtendedStyle. Por exemplo, use CreateEx para definir estilos como WS_EX_CONTEXTHELP, mas use SetExtendedStyle para definir estilos como TCS_EX_FLATSEPARATORS. Para saber mais, consulte os estilos descritos em Estilos estendidos de controles guia no SDK do Windows.

CTabCtrl::CTabCtrl

Constrói um objeto CTabCtrl.

CTabCtrl();

CTabCtrl::DeleteAllItems

Remove todos os itens de um controle guia.

BOOL DeleteAllItems();

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

CTabCtrl::DeleteItem

Remove o item especificado de um controle guia.

BOOL DeleteItem(int nItem);

Parâmetros

nItem
Valor baseado em zero do item a ser excluído.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Exemplo

// This example assumes that there is a CTabCtrl member of the
// CTabDlg class named m_TabCtrl.  On a button handler
// called OnDeleteItem of the dialog box the tab control will
// delete the 0 indexed item.

void CTabDlg::OnDeleteItem()
{
   // Delete the first item in the tab control.
   m_TabCtrl.DeleteItem(0);
}

CTabCtrl::DeselectAll

Redefine itens em um controle guia, desmarcando todos os que foram pressionados.

void DeselectAll(BOOL fExcludeFocus);

Parâmetros

fExcludeFocus
Sinalizador que especifica o escopo do cancelamento da seleção do item. Se esse parâmetro for definido como FALSE, todos os botões de guia serão redefinidos. Se for definido como TRUE, todos os itens de guia, exceto pelo selecionado no momento, serão redefinidos.

Comentários

Essa função membro implementa o comportamento da mensagem TCM_DESELECTALL do Win32, conforme descrito no SDK do Windows.

CTabCtrl::DrawItem

Chamada pela estrutura quando um aspecto visual de um controle guia desenhado pelo proprietário for alterado.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Parâmetros

lpDrawItemStruct
Um ponteiro para uma estrutura DRAWITEMSTRUCT descrevendo o item a ser pintado.

Comentários

O membro itemAction da estrutura DRAWITEMSTRUCT define a ação de desenho a ser executada.

Por padrão, essa função membro não faz nada. Substitua essa função de membro para implementar o desenho para um objeto CTabCtrl desenhado pelo proprietário.

O aplicativo deve restaurar todos os objetos de GDI (Graphics Device Interface) selecionados para o contexto de exibição fornecido em lpDrawItemStruct antes que a função membro seja encerrada.

CTabCtrl::GetCurFocus

Recupera o índice da guia com o foco atual.

int GetCurFocus() const;

Valor de retorno

O índice baseado em zero da guia com o foco atual.

CTabCtrl::GetCurSel

Recupera a guia selecionada atualmente em um controle guia.

int GetCurSel() const;

Valor de retorno

Índice baseado em zero da guia selecionada se tiver êxito ou -1 se nenhuma guia estiver selecionada.

CTabCtrl::GetExtendedStyle

Recupera os estilos estendidos que estão em uso para o controle guia.

DWORD GetExtendedStyle();

Valor de retorno

Representa os estilos estendidos em uso para o controle guia. Esse valor é uma combinação de estilos estendidos de controle guia, conforme descrito no SDK do Windows.

Comentários

Essa função membro implementa o comportamento da mensagem TCM_GETEXTENDEDSTYLE do Win32, conforme descrito no SDK do Windows.

CTabCtrl::GetImageList

Recupera a lista de imagens associada a um controle guia.

CImageList* GetImageList() const;

Valor de retorno

Se tiver êxito, um ponteiro para a lista de imagens do controle guia; caso contrário, NULL.

CTabCtrl::GetItem

Recupera informações sobre uma guia em um controle guia.

BOOL GetItem(int nItem,   TCITEM* pTabCtrlItem) const;

Parâmetros

nItem
O índice baseado em zero da guia.

pTabCtrlItem
Ponteiro para uma estrutura TCITEM, usada para especificar as informações a serem recuperadas. Também usado para receber informações sobre a guia. Essa estrutura é usada com as funções membro InsertItem, GetItem e SetItem.

Valor de retorno

Retorna TRUE, se bem-sucedido; caso contrário, FALSE.

Comentários

Quando a mensagem é enviada, o membro mask especifica quais atributos retornar. Se o membro mask especificar o valor TCIF_TEXT, o membro pszText deverá conter o endereço do buffer que recebe o texto do item e o membro cchTextMax deverá especificar o tamanho do buffer.

  • mask

    Valor que especifica quais membros da estrutura TCITEM recuperar ou definir. Esse membro pode ser zero ou uma combinação dos seguintes valores:

    • TCIF_TEXT: o membro pszText é válido.
    • TCIF_IMAGE: o membro iImage é válido.
    • TCIF_PARAM: o membro lParam é válido.
    • TCIF_RTLREADING: o texto de pszText é exibido usando a ordem de leitura da direita para a esquerda em sistemas hebraicos ou árabes.
    • TCIF_STATE: o membro dwState é válido.

  • pszText

    Ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto da guia se a estrutura contém informações sobre uma guia. Se a estrutura estiver recebendo informações, esse membro especificará o endereço do buffer que recebe o texto da guia.

  • cchTextMax

    Tamanho do buffer para o qual pszText apontou. Esse membro será ignorado se a estrutura não estiver recebendo informações.

  • iImage Índice na lista de imagens do controle guia ou -1 se não houver nenhuma imagem para a guia.

  • lParam

    Dados definidos pelo aplicativo associados à guia. Se houver mais de 4 bytes de dados definidos pelo aplicativo por guia, um aplicativo deverá definir uma estrutura e usá-la em vez da estrutura TCITEM. O primeiro membro da estrutura definida pelo aplicativo deve ser uma estrutura TCITEMHEADER. A estrutura TCITEMHEADER é idêntica à estrutura TCITEM, mas sem o membro lParam. A diferença entre o tamanho de sua estrutura e o tamanho da estrutura TCITEMHEADER deve ser igual ao número de bytes extras por guia.

Exemplo

// In this example a CTabCtrl data member, m_TabCtrl, changes the
// text of the tabs in the tab control.  A call to GetItem is used
// to get the current text, and then the text is changed.  A call
// to SetItem is used to update the tab with the new text.

void CTabDlg::OnChangeItem()
{
   TCITEM tcItem;
   CString pszString;

   //  Get text for the tab item.
   GetDlgItemText(IDC_ITEM_TEXT, pszString);

   //  Get the current tab item text.
   TCHAR buffer[256] = {0};
   tcItem.pszText = buffer;
   tcItem.cchTextMax = 256;
   tcItem.mask = TCIF_TEXT;
   m_TabCtrl.GetItem(0, &tcItem);
   TRACE(_T("Changing item text from %s to %s..."), tcItem.pszText, pszString);

   //  Set the new text for the item.
   tcItem.pszText = pszString.LockBuffer();

   //  Set the item in the tab control.
   m_TabCtrl.SetItem(0, &tcItem);

   pszString.UnlockBuffer();
}

CTabCtrl::GetItemCount

Recupera o número de guias no controle guia.

int GetItemCount() const;

Valor de retorno

Número de itens no controle guia.

Exemplo

Confira o exemplo de CPropertySheet::GetTabControl.

CTabCtrl::GetItemRect

Recupera o retângulo delimitador da guia especificada em um controle guia.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

Parâmetros

nItem
O índice baseado em zero do item de guia.

lpRect
Ponteiro para uma estrutura RECT que recebe o retângulo delimitador da guia. Essas coordenadas usam o modo de mapeamento atual do visor.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Exemplo

Confira o exemplo de CPropertySheet::GetTabControl.

CTabCtrl::GetItemState

Recupera o estado do item de controle guia identificado por nItem.

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

Parâmetros

nItem
O número do índice baseado em zero do item para o qual recuperar informações de estado.

dwMask
Máscara especificando qual sinalizador de estado do item deve ser retornado. Para obter uma lista de valores, consulte o membro de máscara da estrutura TCITEM, conforme descrito no SDK do Windows.

Valor de retorno

Uma referência a um valor DWORD que recebe as informações de estado. Pode ser um dos seguintes valores:

Valor Descrição
TCIS_BUTTONPRESSED O item de controle guia está selecionado.
TCIS_HIGHLIGHTED O item de controle guia é realçado e a guia e o texto são desenhados usando a cor de realce atual. Ao usar a cor de realce, essa será uma interpolação verdadeira, não uma cor pontilhada.

Comentários

O estado de um item é especificado pelo membro dwState da estrutura TCITEM.

CTabCtrl::GetRowCount

Recupera o número atual de linhas em um controle guia.

int GetRowCount() const;

Valor de retorno

O número de linhas de guias no controle guia.

Comentários

Somente controles guia que têm o estilo TCS_MULTILINE podem ter várias linhas de guias.

CTabCtrl::GetToolTips

Recupera o identificador do controle de dica de ferramenta associado a um controle guia.

CToolTipCtrl* GetToolTips() const;

Valor de retorno

Identificador do controle de dica de ferramenta se tiver êxito; caso contrário, NULL.

Comentários

Um controle guia criará um controle de dica de ferramenta se ele tiver o estilo TCS_TOOLTIPS. Você também pode atribuir um controle de dica de ferramenta a um controle guia usando a função membro SetToolTips.

CTabCtrl::HighlightItem

Define o estado de realce de um item de guia.

BOOL HighlightItem(int idItem,  BOOL fHighlight = TRUE);

Parâmetros

idItem
Índice baseado em zero de um item de controle guia.

fHighlight
Valor que especifica o estado de realce a ser definido. Se esse valor for TRUE, a guia será realçada; se for FALSE, a guia será definida como seu estado padrão.

Valor de retorno

Diferente de zero se bem-sucedido; caso contrário, zero.

Comentários

Essa função membro implementa a mensagem TCM_HIGHLIGHTITEM do Win32, conforme descrito no SDK do Windows.

CTabCtrl::HitTest

Determina qual guia, se houver, está na posição especificada na tela.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

Parâmetros

pHitTestInfo
Ponteiro para uma estrutura TCHITTESTINFO, conforme descrito no SDK do Windows, que especifica a posição de tela a ser testada.

Valor de retorno

Retorna o índice baseado em zero da guia, ou -1 se nenhuma guia está na posição especificada.

CTabCtrl::InsertItem

Insere uma nova guia em um controle guia existente.

LONG InsertItem(
    int nItem,
    TCITEM* pTabCtrlItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem,
    int nImage);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam,
    DWORD dwState,
    DWORD dwStateMask);

Parâmetros

nItem
O índice baseado em zero da nova guia.

pTabCtrlItem
Ponteiro para uma estrutura TCITEM que especifica os atributos da guia.

lpszItem
Endereço de uma cadeia de caracteres terminada em nulo que contém o texto da guia.

nImage
O índice baseado em zero de uma imagem a ser inserida de uma lista de imagens.

nMask
Especifica quais atributos de estrutura TCITEM definir. Pode ser zero ou uma combinação dos seguintes valores:

  • TCIF_TEXT: o membro pszText é válido.
  • TCIF_IMAGE: o membro iImage é válido.
  • TCIF_PARAM: o membro lParam é válido.
  • TCIF_RTLREADING: o texto de pszText é exibido usando a ordem de leitura da direita para a esquerda em sistemas hebraicos ou árabes.
  • TCIF_STATE: o membro dwState é válido.

lParam
Dados definidos pelo aplicativo associados à guia.

dwState
Especifica valores para os estados do item. Para obter mais informações, consulte TCITEM no SDK do Windows.

dwStateMask
Especifica quais estados devem ser definidos. Para obter mais informações, consulte TCITEM no SDK do Windows.

Valor de retorno

Índice baseado em zero da nova guia se bem-sucedido; caso contrário, -1.

Exemplo

TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");

m_TabCtrl.InsertItem(0, &tcItem);

CTabCtrl::RemoveImage

Remove a imagem especificada da lista de imagens de um controle guia.

void RemoveImage(int nImage);

Parâmetros

nImage
Índice baseado em zero da imagem a ser removida.

Comentários

O controle guia atualiza o índice de imagem de cada guia para que cada guia permaneça associada à mesma imagem.

CTabCtrl::SetCurFocus

Define o foco para uma guia especificada em um controle guia.

void SetCurFocus(int nItem);

Parâmetros

nItem
Especifica o índice da guia que recebe o foco.

Comentários

Essa função membro implementa o comportamento da mensagem TCM_SETCURFOCUS do Win32, conforme descrito no SDK do Windows.

CTabCtrl::SetCurSel

Seleciona uma guia em um controle guia.

int SetCurSel(int nItem);

Parâmetros

nItem
O índice baseado em zero do item a ser selecionado.

Valor de retorno

Índice baseado em zero da guia selecionada anteriormente, se bem-sucedido; caso contrário - 1.

Comentários

Um controle guia não envia uma mensagem de notificação TCN_SELCHANGING nem TCN_SELCHANGE quando uma guia é selecionada usando essa função. Essas notificações são enviadas, usando WM_NOTIFY, quando o usuário clica ou usa o teclado para alterar as guias.

CTabCtrl::SetExtendedStyle

Define os estilos estendidos para um controle guia.

DWORD SetExtendedStyle(DWORD dwNewStyle, DWORD dwExMask = 0);

Parâmetros

dwNewStyle
Valor que especifica uma combinação de estilos estendidos de controles guia.

dwExMask
Um valor DWORD que indica quais estilos em dwNewStyle devem ser afetados. Somente os estilos estendidos em dwExMask serão alterados. Todos os outros estilos serão mantidos como se encontram. Se esse parâmetro for zero, todos os estilos em dwNewStyle serão afetados.

Valor de retorno

Um valor DWORD que contém os estilos estendidos de controle guia anteriores, conforme descrito no SDK do Windows.

Comentários

Essa função membro implementa o comportamento da mensagem TCM_SETEXTENDEDSTYLE do Win32, conforme descrito no SDK do Windows.

CTabCtrl::SetImageList

Atribui uma lista de imagens a um controle guia.

CImageList* SetImageList(CImageList* pImageList);

Parâmetros

pImageList
Ponteiro para a lista de imagens a ser atribuída ao controle guia.

Valor de retorno

Retorna um ponteiro para a lista de imagens anterior ou NULL quando não há uma lista de imagens anterior.

CTabCtrl::SetItem

Define alguns ou todos os atributos de uma guia.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

Parâmetros

nItem
O índice baseado em zero do item.

pTabCtrlItem
Ponteiro para uma estrutura TCITEM que contém os novos atributos de item. O membro mask especifica quais atributos definir. Se o membro mask especificar o valor TCIF_TEXT, o membro pszText será o endereço de uma cadeia de caracteres terminada em nulo e o membro cchTextMax será ignorado.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Exemplo

Confira o exemplo de GetItem.

CTabCtrl::SetItemExtra

Define o número de bytes por guia reservado para dados definidos pelo aplicativo em um controle guia.

BOOL SetItemExtra(int nBytes);

Parâmetros

nBytes
O número de bytes extras a serem definidos.

Valor de retorno

Diferente de zero se bem-sucedido; caso contrário, zero.

Comentários

Essa função membro implementa o comportamento da mensagem TCM_SETITEMEXTRA do Win32, conforme descrito no SDK do Windows.

CTabCtrl::SetItemSize

Define a largura e a altura dos itens de controle guia.

CSize SetItemSize(CSize size);

Parâmetros

size
A nova largura e altura, em pixels, dos itens do controle guia.

Valor de retorno

Retorna a largura e a altura antigas dos itens de controle guia.

CTabCtrl::SetItemState

Define o estado do item de controle guia identificado por nItem.

BOOL SetItemState(
    int nItem,
    DWORD dwMask,
    DWORD dwState);

Parâmetros

nItem
O número do índice baseado em zero do item para o qual definir informações de estado.

dwMask
Máscara especificando qual sinalizador de estado do item deve ser definido. Para obter uma lista de valores, consulte o membro de máscara da estrutura TCITEM, conforme descrito no SDK do Windows.

dwState
Uma referência a um valor DWORD que contém as informações de estado. Pode ser um dos seguintes valores:

Valor Descrição
TCIS_BUTTONPRESSED O item de controle guia está selecionado.
TCIS_HIGHLIGHTED O item de controle guia é realçado e a guia e o texto são desenhados usando a cor de realce atual. Ao usar a cor de realce, essa será uma interpolação verdadeira, não uma cor pontilhada.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

CTabCtrl::SetMinTabWidth

Define a largura mínima dos itens em um controle guia.

int SetMinTabWidth(int cx);

Parâmetros

cx
Largura mínima a ser definida para um item de controle guia. Se esse parâmetro for definido como -1, o controle usará a largura da guia padrão.

Valor de retorno

A largura mínima da guia anterior.

Comentários

Essa função membro implementa o comportamento da mensagem TCM_SETMINTABWIDTH do Win32, conforme descrito no SDK do Windows.

CTabCtrl::SetPadding

Define a quantidade de espaço (preenchimento) em torno do ícone e do rótulo de cada guia em um controle guia.

void SetPadding(CSize size);

Parâmetros

size
Define a quantidade de espaço (preenchimento) em torno do ícone e do rótulo de cada guia em um controle guia.

CTabCtrl::SetToolTips

Atribui um controle de dica de ferramenta a um controle guia.

void SetToolTips(CToolTipCtrl* pWndTip);

Parâmetros

pWndTip
Identificador do controle de dica de ferramenta.

Comentários

Você pode obter o controle de dica de ferramenta associado a um controle guia fazendo uma chamada para GetToolTips.

Exemplo

Confira o exemplo de CPropertySheet::GetTabControl.

Confira também

Classe CWnd
Classe CHeaderCtrl
Classe CListCtrl
Gráfico da hierarquia