# VAPIM_GETTEXT

Gets a text buffer from a specified range.

## Syntax

    #include <kvvapi.h>
    SendMessage(hWndVAPI, VAPIM_GETTEXT, 0L,
               (LPARAM) (TPVAPIGetText*) lpGetText );

## Arguments

Argument | Description
--- | ---
`hWndVAPI` | The handle of the VAPI window.
`lpGetText` | A pointer to a TPVAPIGetText structure, which defines the text to get.

## Returns

`SendMessage()` returns the number of `BYTES` it stored in the buffer; or `-1` on error.

## Discussion

- Send this message to obtain a buffer of text from a specified range. It is assumed that the text buffer is large enough to hold the required number of bytes. The data is not null terminated.

- This message does not wait for a logical address to become valid in the same way as `VAPIM_POSITION` (for non-spreadsheets). This message does not retrieve text across buffer boundaries.

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

© Copyright 2016-2020 Micro Focus or one of its affiliates | Send documentation feedback Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a mail client, and then send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm