---
UID: NS:commctrl.tagLVFINDINFOA
title: LVFINDINFOA (commctrl.h)
description: Contains information used when searching for a list-view item. This structure is identical to LV_FINDINFO but has been renamed to fit standard naming conventions.
old-location: controls\LVFINDINFO.htm
tech.root: Controls
ms.assetid: VS|Controls|~\controls\listview\structures\lvfindinfo.htm
ms.date: 12/05/2018
ms.keywords: '*LPFINDINFOA, LPFINDINFO, LPFINDINFO structure pointer [Windows Controls], LVFINDINFO, LVFINDINFO structure [Windows Controls], LVFINDINFOA, LVFINDINFOW, LVFI_NEARESTXY, LVFI_PARAM, LVFI_PARTIAL, LVFI_STRING, LVFI_SUBSTRING, LVFI_WRAP, _win32_LVFINDINFO, _win32_LVFINDINFO_cpp, commctrl/LPFINDINFO, commctrl/LVFINDINFO, commctrl/LVFINDINFOA, commctrl/LVFINDINFOW, controls.LVFINDINFO, controls._win32_LVFINDINFO'
f1_keywords:
- commctrl/LVFINDINFO
dev_langs:
- c++
req.header: commctrl.h
req.include-header: 
req.target-type: Windows
req.target-min-winverclnt: Windows Vista [desktop apps only]
req.target-min-winversvr: Windows Server 2003 [desktop apps only]
req.kmdf-ver: 
req.umdf-ver: 
req.ddi-compliance: 
req.unicode-ansi: LVFINDINFOW (Unicode) and LVFINDINFOA (ANSI)
req.idl: 
req.max-support: 
req.namespace: 
req.assembly: 
req.type-library: 
req.lib: 
req.dll: 
req.irql: 
topic_type:
- APIRef
- kbSyntax
api_type:
- HeaderDef
api_location:
- Commctrl.h
api_name:
- LVFINDINFO
- LVFINDINFOA
- LVFINDINFOW
targetos: Windows
req.typenames: LVFINDINFOA, *LPFINDINFOA
req.redist: 
ms.custom: 19H1
---

# LVFINDINFOA structure


## -description


Contains information used when searching for a list-view item. This structure is identical to LV_FINDINFO but has been renamed to fit standard naming conventions. 


## -struct-fields




### -field flags

Type: <b><a href="https://docs.microsoft.com/windows/desktop/WinProg/windows-data-types">UINT</a></b>

Type of search to perform. This member can be set to one or more of the following values: 

<table>
<tr>
<th>Value</th>
<th>Meaning</th>
</tr>
<tr>
<td width="40%"><a id="LVFI_PARAM"></a><a id="lvfi_param"></a><dl>
<dt><b>LVFI_PARAM</b></dt>
</dl>
</td>
<td width="60%">
Searches for a match between this structure's <b>lParam</b> member and the <b>lParam</b> member of an item's <a href="https://docs.microsoft.com/windows/desktop/api/commctrl/ns-commctrl-lvitema">LVITEM</a> structure.

</td>
</tr>
<tr>
<td width="40%"><a id="LVFI_PARTIAL"></a><a id="lvfi_partial"></a><dl>
<dt><b>LVFI_PARTIAL</b></dt>
</dl>
</td>
<td width="60%">
Checks to see if the item text begins with the string pointed to by the <b>psz</b> member. This value implies use of LVFI_STRING.

</td>
</tr>
<tr>
<td width="40%"><a id="LVFI_STRING"></a><a id="lvfi_string"></a><dl>
<dt><b>LVFI_STRING</b></dt>
</dl>
</td>
<td width="60%">
Searches based on the item text. Unless additional values are specified, the item text of the matching item must exactly match the string pointed to by the <b>psz</b> member. However, the search is case-insensitive.

</td>
</tr>
<tr>
<td width="40%"><a id="LVFI_SUBSTRING"></a><a id="lvfi_substring"></a><dl>
<dt><b>LVFI_SUBSTRING</b></dt>
</dl>
</td>
<td width="60%">
<b>Windows Vista and later.</b> Equivalent to LVFI_PARTIAL.

</td>
</tr>
<tr>
<td width="40%"><a id="LVFI_WRAP"></a><a id="lvfi_wrap"></a><dl>
<dt><b>LVFI_WRAP</b></dt>
</dl>
</td>
<td width="60%">
Continues the search at the beginning if no match is found. If this flag is used by itself, it is assumed that a string search is wanted.

</td>
</tr>
<tr>
<td width="40%"><a id="LVFI_NEARESTXY"></a><a id="lvfi_nearestxy"></a><dl>
<dt><b>LVFI_NEARESTXY</b></dt>
</dl>
</td>
<td width="60%">
Finds the item nearest to the position specified in the <b>pt</b> member, in the direction specified by the <b>vkDirection</b> member. This flag is supported only by large icon and small icon modes. If LVFI_NEARESTXY is specified, all other flags are ignored.

</td>
</tr>
</table>
 


### -field psz

Type: <b><a href="https://docs.microsoft.com/windows/desktop/WinProg/windows-data-types">LPCTSTR</a></b>

Address of a null-terminated string to compare with the item text. It is valid only if LVFI_STRING or LVFI_PARTIAL is set in the <b>flags</b> member.


### -field lParam

Type: <b><a href="https://docs.microsoft.com/windows/desktop/WinProg/windows-data-types">LPARAM</a></b>

Value to compare with the <b>lParam</b> member of a list-view item's <a href="https://docs.microsoft.com/windows/desktop/api/commctrl/ns-commctrl-lvitema">LVITEM</a> structure. It is valid only if LVFI_PARAM is set in the <b>flags</b> member.


### -field pt

Type: <b><a href="https://docs.microsoft.com/previous-versions/dd162805(v=vs.85)">POINT</a></b>


<a href="https://docs.microsoft.com/previous-versions/dd162805(v=vs.85)">POINT</a> structure with the initial search position. It is valid only if LVFI_NEARESTXY is set in the <b>flags</b> member.


### -field vkDirection

Type: <b><a href="https://docs.microsoft.com/windows/desktop/WinProg/windows-data-types">UINT</a></b>

Virtual key code that specifies the direction to search. The following codes are supported: 
			
            		

<ul>
<li>VK_LEFT </li>
<li>VK_RIGHT </li>
<li>VK_UP </li>
<li>VK_DOWN </li>
<li>VK_HOME </li>
<li>VK_END </li>
<li>VK_PRIOR </li>
<li>VK_NEXT </li>
</ul>
This member is valid only if LVFI_NEARESTXY is set in the <b>flags</b> member.

