Estrutura TCITEMHEADERA (commctrl.h)

Especifica ou recebe os atributos de uma guia. Ele é usado com as mensagens TCM_INSERTITEM, TCM_GETITEM e TCM_SETITEM . Essa estrutura substitui a estrutura TC_ITEMHEADER .

Sintaxe

typedef struct tagTCITEMHEADERA {
  UINT  mask;
  UINT  lpReserved1;
  UINT  lpReserved2;
  LPSTR pszText;
  int   cchTextMax;
  int   iImage;
} TCITEMHEADERA, *LPTCITEMHEADERA;

Membros

mask

Tipo: UINT

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

Valor	Significado
TCIF_IMAGE	O membro iImage é válido.
TCIF_RTLREADING	A cadeia de caracteres apontada por pszText será exibida na direção oposta ao texto na janela pai.
TCIF_TEXT	O membro pszText é válido.

lpReserved1

Tipo: UINT

Membro reservado. Não use.

lpReserved2

Tipo: UINT

Membro reservado. Não use.

pszText

Tipo: LPTSTR

Endereço de uma cadeia de caracteres terminada em nulo que contém o texto da guia se as informações do item estiverem sendo definidas. Se as informações do item estiverem sendo recuperadas, esse membro especificará o endereço do buffer que recebe o texto da guia.

cchTextMax

Tipo: int

Tamanho do buffer apontado pelo membro pszText. Se a estrutura não estiver recebendo informações, esse membro será ignorado.

iImage

Tipo: int

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

Comentários

Normalmente, as janelas exibem texto da esquerda para a direita (LTR). O Windows pode ser espelhado para exibir idiomas como hebraico ou árabe que leem da direita para a esquerda (RTL). Normalmente, pszText será exibido na mesma direção que o texto em sua janela pai. Se TCIF_RTLREADING estiver definido, pszText lerá na direção oposta do texto na janela pai.

Observação

O cabeçalho commctrl.h define TCITEMHEADER como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	commctrl.h