macro ListView_SetItemPosition (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

void ListView_SetItemPosition(
   hwndLV,
   i,
   x,
   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.

Retornar valor

Nenhum

Comentários

Se o controle de exibição de lista tiver o estilo LVS_AUTOARRANGE , o controle de exibição de lista será organizado depois que a posição do item for 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
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]
Plataforma de Destino Windows
Cabeçalho commctrl.h