Macro ListView_SetItemText (commctrl.h)

Artigo
02/28/2024

Altera o texto de um item de exibição de lista ou subitem. Você pode usar essa macro ou enviar a mensagem LVM_SETITEMTEXT explicitamente.

Sintaxe

void ListView_SetItemText(
   hwndLV,
   i,
   iSubItem_,
   pszText_
);

Parâmetros

hwndLV

Tipo: HWND

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

i

Tipo: int

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

iSubItem_

Tipo: int

O índice com base em um do subitem. Para definir o rótulo do item, defina iSubItem como zero.

pszText_

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o novo texto. Esse parâmetro pode ser LPSTR_TEXTCALLBACK para indicar um item de retorno de chamada para o qual a janela pai armazena o texto. Nesse caso, o controle de exibição de lista envia ao pai um código de notificação LVN_GETDISPINFO quando ele precisa do texto. Este parâmetro pode ser NULL.

Retornar valor

Nenhum

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