macro TreeView_GetISearchString (commctrl.h)

Recupera la cadena de búsqueda incremental de un control de vista de árbol. El control de vista de árbol usa la cadena de búsqueda incremental para seleccionar un elemento basado en caracteres tipados por el usuario. Puede usar esta macro o enviar el mensaje TVM_GETISEARCHSTRING explícitamente.

Sintaxis

BOOL TreeView_GetISearchString(
   HWND   hwndTV,
   LPTSTR lpsz
);

Parámetros

hwndTV

Tipo: HWND

Identificador del control de vista de árbol.

lpsz

Tipo: LPTSTR de

Puntero al búfer que recibe la cadena de búsqueda incremental.

Valor devuelto

Tipo: BOOL de

Devuelve TRUE si se recupera la cadena; FALSE de lo contrario.

Observaciones

advertencia de seguridad: Usar esta macro incorrectamente podría poner en peligro la seguridad del programa. Debe asignar un búfer lo suficientemente grande como para contener la cadena. En primer lugar, llame a la macro que pasa NULL en lpsz. Esto devuelve el número de caracteres, excepto NULL, que son necesarios. A continuación, llame a la macro una segunda vez para recuperar la cadena. Debe revisar Consideraciones de seguridad: Microsoft Windows Controls antes de continuar.

Si el control de vista de árbol no está en modo de búsqueda incremental, el valor devuelto es cero.

Requisitos