Partilhar via


Guias e atributos de controle da guia

Você tem um controle considerável sobre a aparência e o comportamento das guias que compõem um controle de guias (CTabCtrl). Cada guia pode ter um rótulo, um ícone, um estado de item e um valor de 32 bits definido pelo aplicativo associado a ele. Para cada guia, você pode exibir o ícone, o rótulo ou ambos.

Além disso, cada item de guia pode ter três estados possíveis: pressionado, não pressionado ou realçado. Esse estado só pode ser definido modificando um item de guia existente. Para modificar um item de guia existente, recupere-o com uma chamada para GetItem, modifique a estrutura TCITEM (especificamente os membros de dados dwState e dwStateMask) e retorne a estrutura modificada TCITEM com uma chamada para SetItem. Se você precisar limpar os estados de item de todos os itens de guia em um objeto CTabCtrl, faça uma chamada para DeselectAll. Essa função redefine o estado de todos os itens de guia ou de todos os itens, exceto aquele selecionado no momento.

O código a seguir limpa o estado de todos os itens de guia e modifica o estado do terceiro item:

//modify the third item to be highlighted
TCITEM curItem = {0};

m_TabCtrl.DeselectAll(FALSE); //reset all tab items
curItem.mask = TCIF_STATE;
m_TabCtrl.GetItem(2, &curItem);
curItem.mask = TCIF_STATE;
curItem.dwState = TCIS_HIGHLIGHTED;
curItem.dwStateMask = TCIS_HIGHLIGHTED;
m_TabCtrl.SetItem(2, &curItem);

Para obter mais informações sobre atributos de guias, consulte Guias e atributos de guias no SDK do Windows. Para obter mais informações sobre como adicionar guias a um controle de guias, consulte Adicionar guias a um controle de guias mais adiante neste tópico.

Confira também

Usando CTabCtrl
Controles