Compartilhar via


Mensagem LVM_SETITEMPOSITION

Move um item para uma posição especificada em um controle de exibição de lista (deve estar no modo de exibição de ícone ou de ícone pequeno). Você pode enviar essa mensagem explicitamente ou usando a macro ListView_SetItemPosition.

Parâmetros

wParam

Índice do item do modo de exibição de lista.

lParam

A LOWORD especifica a nova posição x do canto superior esquerdo do item, em coordenadas de exibição. A HIWORD especifica a nova posição y do canto superior esquerdo do item, em coordenadas de exibição.

Valor retornado

Retorna VERDADEIRO se for bem-sucedido ou FALSO caso contrário.

Comentários

Se o controle de exibição de lista tiver o estilo LVS_AUTOARRANGE, os itens no controle de visualização de lista serão organizados depois que a posição do item for definida.

No Windows Vista, o envio dessa mensagem para um controle de exibição de lista com o estilo LVS_AUTOARRANGE não faz nada, e o valor de retorno é FALSO.

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