Estrutura TCITEMA (commctrl.h)

Especifica ou recebe os atributos de um item de guia. Ele é usado com as mensagens TCM_INSERTITEM, TCM_GETITEMe TCM_SETITEM. Essa estrutura substitui a estrutura TC_ITEM.

Sintaxe

typedef struct tagTCITEMA {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMA, *LPTCITEMA;

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 do iImage é válido.
TCIF_PARAM	O membro lParam é válido.
TCIF_RTLREADING	A cadeia de caracteres apontada por pszText será exibida na direção oposta ao texto na janela pai.
TCIF_STATE	versão 4.70. O membro dwState é válido.
TCIF_TEXT	O membro pszText é válido.

dwState

Tipo: DWORD

versão 4.70. Especifica o estado atual do item se as informações estiverem sendo recuperadas. Se as informações do item estiverem sendo definidas, esse membro conterá o valor de estado a ser definido para o item. Para obter uma lista de estados válidos do item de controle de guia, consulte estados de item de controle de tabulação. Esse membro é ignorado na mensagem TCM_INSERTITEM.

dwStateMask

Tipo: DWORD

versão 4.70. Especifica quais bits do membro dwState contêm informações válidas. Esse membro é ignorado na mensagem TCM_INSERTITEM.

pszText

Tipo: LPTSTR

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto da guia quando as informações do item estão sendo definidas. Se as informações do item estiverem sendo recuperadas, esse membro especifica o endereço do buffer que recebe o texto da guia.

cchTextMax

Tipo: int

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

iImage

Tipo: int

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

lParam

Tipo: LPARAM

Dados definidos pelo aplicativo associados ao item de controle de tabulação. Se houver mais ou menos 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.

Observações

Normalmente, as janelas exibem texto da esquerda para a direita (LTR). As janelas podem ser espelhadas 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 será lido na direção oposta do texto na janela pai.

Nota

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	commctrl.h