Header_InsertItem macro (commctrl.h)

Artigo
10/24/2024

Insere um novo item em um controle de cabeçalho. Você pode usar essa macro ou enviar a mensagem HDM_INSERTITEM explicitamente.

Sintaxe

int Header_InsertItem(
         HWND     hwndHD,
         int      i,
   const LPHDITEM phdi
);

Parâmetros

hwndHD

Tipo: HWND

Um identificador para o controle de cabeçalho.

i

Tipo: int

O índice do item após o qual o novo item deve ser inserido. O novo item será inserido no final do controle de cabeçalho se i for maior ou igual ao número de itens no controle. Se i for zero, o novo item será inserido no início do controle de cabeçalho.

phdi

Tipo: const LPHDITEM

Um ponteiro para uma estrutura HDITEM que contém informações sobre o novo item.

Valor de retorno

Tipo: int

Retorna o índice do novo item se tiver êxito ou -1 caso contrário.

Observações

A macro Header_InsertItem é definida da seguinte maneira:

#define Header_InsertItem(hwndHD, i, phdi) \

    (int)SendMessage((hwndHD), HDM_INSERTITEM, (WPARAM)(int)(i), \

    (LPARAM)(const LPHDITEM)(phdi))

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]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via