Location:
COEINPUT.H
Link against: cone.lib
class TCoeInputCapabilities;
Describes which forms of text input are consumed by a control or view.
Defined in TCoeInputCapabilities
:
Capabilities()
, CaptionRetrieverForFep()
, EAllText
, EAutoSentenceCase
, EDialableCharacters
, EJapaneseHiragana
, EJapaneseKatakanaFullWidth
, EJapaneseKatakanaHalfWidth
, ENavigation
, ENonPredictive
, ENone
, ESecretText
, EWesternAlphabetic
, EWesternNumericIntegerNegative
, EWesternNumericIntegerPositive
, EWesternNumericReal
, FepAwareTextEditor()
, FepSpecificExtensions()
, IsNone()
, MergeWith()
, ObjectProvider()
, SetCapabilities()
, SetObjectProvider()
, SupportsAllText()
, SupportsAutoSentenceCase()
, SupportsDialableCharacters()
, SupportsJapaneseHiragana()
, SupportsJapaneseKatakanaFullWidth()
, SupportsJapaneseKatakanaHalfWidth()
, SupportsNavigation()
, SupportsNonPredictive()
, SupportsSecretText()
, SupportsWesternAlphabetic()
, SupportsWesternNumericIntegerNegative()
, SupportsWesternNumericIntegerPositive()
, SupportsWesternNumericReal()
, TCoeInputCapabilities()
, TCoeInputCapabilities()
, TCoeInputCapabilities()
, TCoeInputCapabilities()
, TCoeInputCapabilities()
, anonymous
, operator!=()
, operator=()
, operator==()
IMPORT_C TCoeInputCapabilities(TUint aCapabilities);
Constructor which initialises the capabilities.
The new object has NULL pointers to the FEP aware text editor and the FEP caption retriever objects.
|
IMPORT_C TCoeInputCapabilities(TUint aCapabilities, MCoeFepAwareTextEditor *aFepAwareTextEditor, MCoeCaptionRetrieverForFep
*aCaptionRetrieverForFep);
Constructor which sets the capabilities, a FEP aware text editor and a FEP caption retriever object.
|
IMPORT_C TCoeInputCapabilities(TUint aCapabilities, MCoeFepAwareTextEditor *aFepAwareTextEditor, MCoeCaptionRetrieverForFep
*aCaptionRetrieverForFep, TUid aFepUid, MCoeFepSpecificExtensions *aFepSpecificExtensions);
Constructor which sets the capabilities, a FEP aware text editor, a FEP caption retriever object, a FEP UID and a FEP specific extensions object.
This overload is provided to allow an application to report its specialised input capabilities, if any, to a FEP. The application
should override CCoeControl::InputCapabilities()
and/or CCoeAppUi::InputCapabilities()
, to return a TCoeInputCapabilities object created using this overload, passing the FEP's UID (as published in its header
file) and the address of a MCoeFepSpecificExtensions object.
|
IMPORT_C TCoeInputCapabilities(const TCoeInputCapabilities &aAnother);
Copy constructor. Constructs this object using the capabilities of another instance.
|
IMPORT_C TCoeInputCapabilities &operator=(const TCoeInputCapabilities &aAnother);
Assignment operator.
This copies the capabilities of aAnother into this object.
|
|
IMPORT_C TBool operator==(const TCoeInputCapabilities &aAnother) const;
Equality operator.
Compares this and aAnother for equality.
|
|
IMPORT_C TBool operator!=(const TCoeInputCapabilities &aAnother) const;
Inequality operator.
Compares this and aAnother for inequality.
|
|
IMPORT_C void MergeWith(const TCoeInputCapabilities &aAnother);
Merges the capabilities of a specified TCoeInputCapabilities with this object.
The capabilities are merged using a logical OR. The pointers to the FEP aware text editor, caption retriever and object provider are merged only if this object has NULL pointers.
|
IMPORT_C void SetCapabilities(TUint aCapabilities);
Sets the input capability flags of this object.
|
IMPORT_C TUint Capabilities() const;
Gets the input capability flags of this object.
|
IMPORT_C TBool IsNone() const;
Tests whether the control supports any type of text input.
|
IMPORT_C TBool SupportsWesternNumericIntegerPositive() const;
Tests whether the control supports entry of positive integers.
|
IMPORT_C TBool SupportsWesternNumericIntegerNegative() const;
Tests whether the control supports entry of negative integers.
|
IMPORT_C TBool SupportsWesternNumericReal() const;
Tests whether the control supports entry of real numbers.
|
IMPORT_C TBool SupportsWesternAlphabetic() const;
Tests whether the control supports entry of text in the western alphabets.
|
IMPORT_C TBool SupportsJapaneseHiragana() const;
Tests whether the control supports text input in Japanese Hiragana.
|
IMPORT_C TBool SupportsJapaneseKatakanaHalfWidth() const;
Tests whether the control supports text input in half width Japanese Katakana.
|
IMPORT_C TBool SupportsJapaneseKatakanaFullWidth() const;
Tests whether the control supports text input in full width Japanese Katakana.
|
IMPORT_C TBool SupportsDialableCharacters() const;
Tests whether the control supports dialable characters as text input.
|
IMPORT_C TBool SupportsSecretText() const;
Tests whether the control supports secret text.
|
IMPORT_C TBool SupportsAutoSentenceCase() const;
Tests whether the control supports auto sentence case.
|
IMPORT_C TBool SupportsNonPredictive() const;
Tests whether the control supports non-predictive input.
|
IMPORT_C TBool SupportsAllText() const;
Tests whether the control supports all types of text input.
|
IMPORT_C TBool SupportsNavigation() const;
Tests whether the control supports navigation keys.
|
IMPORT_C MCoeFepAwareTextEditor *FepAwareTextEditor() const;
Gets the FEP aware text editor object pointed to by this object.
|
IMPORT_C MCoeCaptionRetrieverForFep *CaptionRetrieverForFep() const;
Gets the caption retriever pointed to by this object.
|
IMPORT_C MCoeFepSpecificExtensions *FepSpecificExtensions(TUid aFepUid) const;
Gets the specialised input capabilities of the application.
This function is called by the FEP and returns the specialised capabilities supported by the application. If the application has no specialised input capabilities, or if the application does not know about this FEP, the function returns NULL.
Notes:
The application only knows about one FEP. This is the one that was written to implement its specialised capabilities. If aFepUid does not match the UID of this known FEP then NULL is returned.
If an MCoeFepSpecificExtensions is returned, the FEP then calls the supported extension functions in the application via its virtual interface. The functions return some value, which, depending on the current context, may instruct the FEP to perform some actions.
Background information:
The specialised capabilities are defined as pure virtual functions in the concrete FEP's MCoeFepSpecificExtensions interface, and are implemented by the app UI.
When the focus in the app UI changes, the FEP queries the application's capabilities using CCoeControl::InputCapabilities()
and/or CCoeAppUi::InputCapabilities()
. It then gets the extensions using this function.
The FEP then calls any member functions of MCoeFepSpecificExtensions that it needs to (to inquire about the extended capabilities). The functions return a value to the FEP instructing it to perform an action, if that extended functionality is appropriate to the current state of the application.
|
|
IMPORT_C MObjectProvider *ObjectProvider() const;
Gets the object provider of the control which supplied this TCoeInputCapabilities object.
This function can be called by a FEP to gain access to the object provider tree. For instance, the FEP might need to update an input mode indicator that is located in the same object provider tree as the editor with focus.
|
IMPORT_C void SetObjectProvider(MObjectProvider *aObjectProvider);
Sets the object provider of the control which supplied this TCoeInputCapabilities object.
This allows the control to give the FEP access to its object provider tree.
|
n/a
Text input capability flags. These are used to define the text input capabilities of a control or view.
|