# StartTextInput

## Description

This command pops up a text entry prompt over your app whilst your app continues in the background. Accepted characters are ASCII values in the range 32 to 126 inclusive, unless you have activated the new default fonts with UseNewDefaultFonts, in which case any Unicode characters can be used. If a virtual keyboard is required for text entry on this device then it will be displayed over your app. You cannot assume that any part of your app will be visible whilst text entry is in progress, although your code will continue running. When the user has finished entering text GetTextInputCompleted will return 1 and GetTextInputCancelled will let you know if they completed the text entry or cancelled it. On keyboard based devices cancelling is done with the escape key whilst completing is done with the enter key. If successful you can get the inputted text with GetTextInput.

## Definition

StartTextInput( initial )

void agk::StartTextInput( const char* initial )

StartTextInput( )

void agk::StartTextInput( )

## Parameters

- initial - The initial string to display to the user that they can edit.