ListView_EditLabel macro (commctrl.h)

Inicia a edição in-loco do texto do item de exibição de lista especificado. A mensagem seleciona implicitamente e concentra o item especificado. Você pode usar essa macro ou enviar a mensagem LVM_EDITLABEL explicitamente.

Sintaxe

HWND ListView_EditLabel(
   HWND hwndLV,
   int  i
);

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. Para cancelar a edição, defina i como -1.

Valor de retorno

Tipo: HWND

Retorna o identificador para o controle de edição usado para editar o texto do item se bem-sucedido ou NULL caso contrário.

Observações

Quando o usuário conclui ou cancela a edição, o controle de edição é destruído e o identificador não é mais válido. Você pode subclasse o controle de edição, mas não deve destruí-lo.

O controle deve ter o foco antes de enviar essa mensagem para o controle. O foco pode ser definido usando a função SetFocus.

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

Consulte também

WM_CANCELMODE