Struttura LVFINDINFOA (commctrl.h)

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;

Membri

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 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	Esegue ricerche 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. Equivalente 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 venga ricercata una stringa.
LVFI_NEARESTXY	Trova l'elemento più vicino alla posizione specificata nel membro pt , nella direzione specificata dal membro vkDirection. Questo flag è supportato solo da modalità icona di grandi dimensioni e icona piccola. Se si specifica 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 flag .

lParam

Tipo: LPARAM

Valore da confrontare con il membro di un elemento LVITEM di un elemento della visualizzazione elenco. È valido solo se LVFI_PARAM è impostato nei flag membro.

pt

Tipo: POINT

struttura POINT con la posizione di ricerca iniziale. È valido solo se LVFI_NEARESTXY è impostato nei flag membro.

vkDirection

Tipo: UINT

Codice della 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 flag.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	commctrl.h