JUCE  v5.4.1-191-g0ab5e696f
JUCE API
Looking for a senior C++ dev?
I'm looking for work. Hire me!
juce::TextInputTarget Class Referenceabstract

An abstract base class which can be implemented by components that function as text editors. More...

#include <juce_TextInputTarget.h>

Inheritance diagram for juce::TextInputTarget:

Public Types

enum  VirtualKeyboardType {
  textKeyboard = 0,
  numericKeyboard,
  decimalKeyboard,
  urlKeyboard,
  emailAddressKeyboard,
  phoneNumberKeyboard
}
 A set of possible on-screen keyboard types, for use in the getKeyboardType() method. More...
 

Public Member Functions

 TextInputTarget ()
 
virtual ~TextInputTarget ()
 Destructor. More...
 
virtual Rectangle< intgetCaretRectangle ()=0
 Returns the position of the caret, relative to the component's origin. More...
 
virtual Range< intgetHighlightedRegion () const =0
 Returns the extents of the selected text region, or an empty range if nothing is selected,. More...
 
virtual VirtualKeyboardType getKeyboardType ()
 Returns the target's preference for the type of keyboard that would be most appropriate. More...
 
virtual String getTextInRange (const Range< int > &range) const =0
 Returns a specified sub-section of the text. More...
 
virtual void insertTextAtCaret (const String &textToInsert)=0
 Inserts some text, overwriting the selected text region, if there is one. More...
 
virtual bool isTextInputActive () const =0
 Returns true if this input target is currently accepting input. More...
 
virtual void setHighlightedRegion (const Range< int > &newRange)=0
 Sets the currently-selected text region. More...
 
virtual void setTemporaryUnderlining (const Array< Range< int >> &underlinedRegions)=0
 Sets a number of temporarily underlined sections. More...
 

Detailed Description

An abstract base class which can be implemented by components that function as text editors.

This class allows different types of text editor component to provide a uniform interface, which can be used by things like OS-specific input methods, on-screen keyboards, etc.

{GUI}

Member Enumeration Documentation

◆ VirtualKeyboardType

A set of possible on-screen keyboard types, for use in the getKeyboardType() method.

Enumerator
textKeyboard 
numericKeyboard 
decimalKeyboard 
urlKeyboard 
emailAddressKeyboard 
phoneNumberKeyboard 

Constructor & Destructor Documentation

◆ TextInputTarget()

juce::TextInputTarget::TextInputTarget ( )
inline

◆ ~TextInputTarget()

virtual juce::TextInputTarget::~TextInputTarget ( )
inlinevirtual

Destructor.

Member Function Documentation

◆ getCaretRectangle()

virtual Rectangle<int> juce::TextInputTarget::getCaretRectangle ( )
pure virtual

Returns the position of the caret, relative to the component's origin.

Implemented in juce::TextEditor, and juce::CodeEditorComponent.

◆ getHighlightedRegion()

virtual Range<int> juce::TextInputTarget::getHighlightedRegion ( ) const
pure virtual

Returns the extents of the selected text region, or an empty range if nothing is selected,.

Implemented in juce::TextEditor, and juce::CodeEditorComponent.

◆ getKeyboardType()

virtual VirtualKeyboardType juce::TextInputTarget::getKeyboardType ( )
inlinevirtual

Returns the target's preference for the type of keyboard that would be most appropriate.

This may be ignored, depending on the capabilities of the OS.

Reimplemented in juce::TextEditor.

◆ getTextInRange()

virtual String juce::TextInputTarget::getTextInRange ( const Range< int > &  range) const
pure virtual

Returns a specified sub-section of the text.

Implemented in juce::TextEditor, and juce::CodeEditorComponent.

◆ insertTextAtCaret()

virtual void juce::TextInputTarget::insertTextAtCaret ( const String textToInsert)
pure virtual

Inserts some text, overwriting the selected text region, if there is one.

Implemented in juce::TextEditor, and juce::CodeEditorComponent.

◆ isTextInputActive()

virtual bool juce::TextInputTarget::isTextInputActive ( ) const
pure virtual

Returns true if this input target is currently accepting input.

For example, a text editor might return false if it's in read-only mode.

Implemented in juce::TextEditor, and juce::CodeEditorComponent.

◆ setHighlightedRegion()

virtual void juce::TextInputTarget::setHighlightedRegion ( const Range< int > &  newRange)
pure virtual

Sets the currently-selected text region.

Implemented in juce::TextEditor, and juce::CodeEditorComponent.

◆ setTemporaryUnderlining()

virtual void juce::TextInputTarget::setTemporaryUnderlining ( const Array< Range< int >> &  underlinedRegions)
pure virtual

Sets a number of temporarily underlined sections.

This is needed by MS Windows input method UI.

Implemented in juce::TextEditor, and juce::CodeEditorComponent.


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