Struttura LVFINDINFOA (commctrl.h)

  • Articolo

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