TreeView_GetISearchString macro (commctrl.h)

Retrieves the incremental search string for a tree-view control. The tree-view control uses the incremental search string to select an item based on characters typed by the user. You can use this macro or send the TVM_GETISEARCHSTRING message explicitly.

Syntax

void TreeView_GetISearchString(
   hwndTV,
   lpsz
);

Parameters

hwndTV

Type: HWND

Handle to the tree-view control.

lpsz

Type: LPTSTR

Pointer to the buffer that receives the incremental search string.

Return value

None

Remarks

Security Warning:  Using this macro incorrectly might compromise the security of your program. You must allocate a large enough buffer to hold the string. First call the macro passing NULL in lpsz. This returns the number of characters, excluding NULL, that are required. Then call the macro a second time to retrieve the string. You should review Security Considerations: Microsoft Windows Controls before continuing.

If the tree-view control is not in incremental search mode, the return value is zero.

Requirements