Struttura LVFINDINFOA (commctrl.h)

Articolo
08/22/2023

Contiene informazioni utilizzate durante la ricerca di un elemento della visualizzazione elenco. Questa struttura è identica a LV_FINDINFO ma è stata rinominata in base alle convenzioni di denominazione standard.

Sintassi

typedef struct tagLVFINDINFOA {
  UINT   flags;
  LPCSTR psz;
  LPARAM lParam;
  POINT  pt;
  UINT   vkDirection;
} LVFINDINFOA, *LPFINDINFOA;

Members

flags

Tipo: UINT

Tipo di ricerca da eseguire. Questo membro può essere impostato su uno o più dei valori seguenti:

Valore	Significato
LVFI_PARAM	Cerca una corrispondenza tra il membro lParam di questa struttura e il membro lParam della struttura LVITEM di un elemento.
LVFI_PARTIAL	Verifica se il testo dell'elemento inizia con la stringa a cui punta il membro psz . Questo valore implica l'uso di LVFI_STRING.
LVFI_STRING	Cerca in base al testo dell'elemento. A meno che non vengano specificati valori aggiuntivi, il testo dell'elemento corrispondente deve corrispondere esattamente alla stringa a cui punta il membro psz . Tuttavia, la ricerca non fa distinzione tra maiuscole e minuscole.
LVFI_SUBSTRING	Windows Vista e versioni successive. Equivale a LVFI_PARTIAL.
LVFI_WRAP	Continua la ricerca all'inizio se non viene trovata alcuna corrispondenza. Se questo flag viene usato da solo, si presuppone che la ricerca di stringhe sia desiderata.
LVFI_NEARESTXY	Trova l'elemento più vicino alla posizione specificata nel membro pt , nella direzione specificata dal membro vkDirection . Questo flag è supportato solo dalle modalità icona di grandi dimensioni e icona piccola. Se viene specificato LVFI_NEARESTXY, tutti gli altri flag vengono ignorati.

psz

Tipo: LPCTSTR

Indirizzo di una stringa con terminazione Null da confrontare con il testo dell'elemento. È valido solo se LVFI_STRING o LVFI_PARTIAL è impostato nel membro flags .

lParam

Tipo: LPARAM

Valore da confrontare con il membro lParam della struttura LVITEM di un elemento della visualizzazione elenco. È valido solo se LVFI_PARAM è impostato nel membro flags .

pt

Tipo: POINT

Struttura POINT con la posizione di ricerca iniziale. È valido solo se LVFI_NEARESTXY è impostato nel membro flags .

vkDirection

Tipo: UINT

Codice chiave virtuale che specifica la direzione di ricerca. Sono supportati i codici seguenti:

VK_LEFT
VK_RIGHT
VK_UP
VK_DOWN
VK_HOME
VK_END
VK_PRIOR
VK_NEXT

Questo membro è valido solo se LVFI_NEARESTXY è impostato nel membro flags .

Commenti

Nota

L'intestazione commctrl.h definisce LVFINDINFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	commctrl.h

Condividi tramite