AGK for Pascal
ContentsIndexHome
PreviousUpNext
TAgkTextInput.Start Method (String)

This method pops up a text entry prompt over your app whilst your app continues in the background.

Syntax
Pascal
class procedure Start(const Initial: String = ''); overload; static;
Parameters 
Description 
const Initial: String = '' 
(optional) The initial string to display to the user that they can edit. 

Accepted characters are ASCII values in the range 32 to 126 inclusive. 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 Completed will return True and Cancelled 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 sucessful you can get the inputted text with Input

There is also a version of Start that fires a notification event instead on completion.

Copyright (c) 2012. All rights reserved.