# VAPIM_SETHILITE

Highlights a region of text.

## Syntax

    #include <kvvapi.h>
    SendMessage(hWndVAPI, VAPIM_SETHILITE,
               (WPARAM) (int) cbTextToHilite,
               (LPARAM) (long) lLogicalAddress );

## Arguments

Argument | Description
--- | ---
`hWndVAPI` | The handle of VAPI window.
`cbTextToHilite` | An integer that is the number of bytes to highlight.
`lLogicalAddress` | A long integer that is the logical address from which to start highlighting.

## Returns

`SendMessage()` returns non-zero on success; or zero on error.

## Discussion

- This message should be sent to Viewing when a `VAPINM_TEXTBUFFER` is received, and before processing for that message has returned control to Viewing. When the `SendMessage( hWnd, VAPINM_TEXTBUFFER, ..)` returns, it is assumed that any highlights have been added to the buffer. There is no limit to the number of highlights that can be added.

- For spreadsheets, this message can also fail if the page containing the entire text region—that is, containing the last address in the text region—is not completely indexed.

_FT_HTML5_bannerTitle.htm