ui/views/controls/prefix_selector.h

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef UI_VIEWS_CONTROLS_PREFIX_SELECTOR_H_
   6 #define UI_VIEWS_CONTROLS_PREFIX_SELECTOR_H_
   7
   8 #include "base/strings/string16.h"
   9 #include "base/time/time.h"
  10 #include "ui/base/ime/text_input_client.h"
  11 #include "ui/views/views_export.h"
  12
  13 namespace views {
  14
  15 class PrefixDelegate;
  16
  17 // PrefixSelector is used to change the selection in a view as the user
  18 // types characters.
  19 class VIEWS_EXPORT PrefixSelector : public ui::TextInputClient {
  20  public:
  21   explicit PrefixSelector(PrefixDelegate* delegate);
  22   virtual ~PrefixSelector();
  23
  24   // Invoked from the view when it loses focus.
  25   void OnViewBlur();
  26
  27   // ui::TextInputClient:
  28   virtual void SetCompositionText(
  29       const ui::CompositionText& composition) OVERRIDE;
  30   virtual void ConfirmCompositionText() OVERRIDE;
  31   virtual void ClearCompositionText() OVERRIDE;
  32   virtual void InsertText(const base::string16& text) OVERRIDE;
  33   virtual void InsertChar(char16 ch, int flags) OVERRIDE;
  34   virtual gfx::NativeWindow GetAttachedWindow() const OVERRIDE;
  35   virtual ui::TextInputType GetTextInputType() const OVERRIDE;
  36   virtual ui::TextInputMode GetTextInputMode() const OVERRIDE;
  37   virtual bool CanComposeInline() const OVERRIDE;
  38   virtual gfx::Rect GetCaretBounds() const OVERRIDE;
  39   virtual bool GetCompositionCharacterBounds(uint32 index,
  40                                              gfx::Rect* rect) const OVERRIDE;
  41   virtual bool HasCompositionText() const OVERRIDE;
  42   virtual bool GetTextRange(gfx::Range* range) const OVERRIDE;
  43   virtual bool GetCompositionTextRange(gfx::Range* range) const OVERRIDE;
  44   virtual bool GetSelectionRange(gfx::Range* range) const OVERRIDE;
  45   virtual bool SetSelectionRange(const gfx::Range& range) OVERRIDE;
  46   virtual bool DeleteRange(const gfx::Range& range) OVERRIDE;
  47   virtual bool GetTextFromRange(const gfx::Range& range,
  48                                 base::string16* text) const OVERRIDE;
  49   virtual void OnInputMethodChanged() OVERRIDE;
  50   virtual bool ChangeTextDirectionAndLayoutAlignment(
  51       base::i18n::TextDirection direction) OVERRIDE;
  52   virtual void ExtendSelectionAndDelete(size_t before, size_t after) OVERRIDE;
  53   virtual void EnsureCaretInRect(const gfx::Rect& rect) OVERRIDE;
  54   virtual void OnCandidateWindowShown() OVERRIDE;
  55   virtual void OnCandidateWindowUpdated() OVERRIDE;
  56   virtual void OnCandidateWindowHidden() OVERRIDE;
  57
  58  private:
  59   // Invoked when text is typed. Tries to change the selection appropriately.
  60   void OnTextInput(const base::string16& text);
  61
  62   // Returns true if the text of the node at |row| starts with |lower_text|.
  63   bool TextAtRowMatchesText(int row, const base::string16& lower_text);
  64
  65   // Clears |current_text_| and resets |time_of_last_key_|.
  66   void ClearText();
  67
  68   PrefixDelegate* prefix_delegate_;
  69
  70   // Time OnTextInput() was last invoked.
  71   base::TimeTicks time_of_last_key_;
  72
  73   base::string16 current_text_;
  74
  75   DISALLOW_COPY_AND_ASSIGN(PrefixSelector);
  76 };
  77
  78 }  // namespace views
  79
  80 #endif  // UI_VIEWS_CONTROLS_PREFIX_SELECTOR_H_