Partilhar via


HDM_INSERTITEM mensagem

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

Parâmetros

wParam

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 wParam for maior ou igual ao número de itens no controle. Se wParam for zero, o novo item será inserido no início do controle de cabeçalho.

lParam

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

Valor retornado

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

Requisitos

Requisito Valor
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
Nomes Unicode e ANSI
HDM_INSERTITEMW (Unicode) e HDM_INSERTITEMA (ANSI)