ListView_SetItemPosition macro (commctrl.h)

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

Sintaxe

BOOL ListView_SetItemPosition(
   HWND hwndLV,
   int  i,
   int  x,
   int  y
);

Parâmetros

hwndLV

Tipo: HWND

Um identificador para o controle de exibição de lista.

i

Tipo: int

O índice do item de exibição de lista.

x

Tipo: int

A nova posição x do canto superior esquerdo do item, em coordenadas de exibição.

y

Tipo: int

A nova posição y do canto superior esquerdo do item, em coordenadas de exibição.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

Se o controle list-view tiver o estilo LVS_AUTOARRANGE, o controle list-view será organizado após a posição do item ser definida.

No Windows Vista, chamar essa macro em um controle de exibição de lista com o estilo LVS_AUTOARRANGE não faz nada e o valor retornado é false.

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