xbmc
Public Member Functions | List of all members
CGUIKeyboard Class Referenceabstract
Inheritance diagram for CGUIKeyboard:
Inheritance graph
[legend]
Collaboration diagram for CGUIKeyboard:
Collaboration graph
[legend]

Public Member Functions

virtual bool ShowAndGetInput (char_callback_t pCallback, const std::string &initialString, std::string &typedString, const std::string &heading, bool bHiddenInput=false)=0
 each native keyboard needs to implement this function with the following behaviour: More...
 
virtual void Cancel ()=0
 This call should cancel a currently shown keyboard dialog. The implementation should return false from the modal ShowAndGetInput once anyone calls this method.
 
virtual int GetWindowId () const
 
void OnTimeout () override
 
void startAutoCloseTimer (unsigned int autoCloseMs)
 
void resetAutoCloseTimer ()
 
virtual bool SetTextToKeyboard (const std::string &text, bool closeKeyboard=false)
 

Member Function Documentation

◆ ShowAndGetInput()

virtual bool CGUIKeyboard::ShowAndGetInput ( char_callback_t  pCallback,
const std::string &  initialString,
std::string &  typedString,
const std::string &  heading,
bool  bHiddenInput = false 
)
pure virtual

each native keyboard needs to implement this function with the following behaviour:

Parameters
pCallbackimplementation should call this on each keypress with the current whole string
initialStringimplementation should show that initialstring
typedstringreturns the typed string after close if return is true
headingimplementation should show a heading (e.x. "search for a movie")
bHiddenInputif true the implementation should obfuscate the user input (e.x. by printing "*" for each char)
Returns
- true if typedstring is valid and user has confirmed input - false if typedstring is undefined and user canceled the input

Implemented in CGUIDialogKeyboardGeneric, CGUIDialogKeyboardTouch, and CDarwinEmbedKeyboard.


The documentation for this class was generated from the following file: