1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMPONENTS_OMNIBOX_BROWSER_OMNIBOX_POPUP_MODEL_H_
#define COMPONENTS_OMNIBOX_BROWSER_OMNIBOX_POPUP_MODEL_H_
#include <stddef.h>
#include "base/macros.h"
#include "base/observer_list.h"
#include "components/omnibox/browser/autocomplete_controller.h"
#include "components/omnibox/browser/autocomplete_result.h"
#include "components/omnibox/browser/omnibox_edit_model.h"
#include "third_party/skia/include/core/SkBitmap.h"
class OmniboxPopupModelObserver;
class OmniboxPopupView;
namespace gfx {
class Image;
}
class OmniboxPopupModel {
public:
// See selected_line_state_ for details.
enum LineState {
NORMAL = 0,
KEYWORD
};
OmniboxPopupModel(OmniboxPopupView* popup_view, OmniboxEditModel* edit_model);
~OmniboxPopupModel();
// Computes the maximum width, in pixels, that can be allocated for the two
// parts of an autocomplete result, i.e. the contents and the description.
//
// When |description_on_separate_line| is true, the caller will be displaying
// two separate lines of text, so both contents and description can take up
// the full available width. Otherwise, the contents and description are
// assumed to be on the same line, with a separator between them.
//
// When |allow_shrinking_contents| is true, and the contents and description
// are together on a line without enough space for both, the code tries to
// divide the available space equally between the two, unless this would make
// one or both too narrow. Otherwise, the contents is given as much space as
// it wants and the description gets the remainder.
static void ComputeMatchMaxWidths(int contents_width,
int separator_width,
int description_width,
int available_width,
bool description_on_separate_line,
bool allow_shrinking_contents,
int* contents_max_width,
int* description_max_width);
// Returns true if the popup is currently open.
bool IsOpen() const;
OmniboxPopupView* view() const { return view_; }
// Returns the AutocompleteController used by this popup.
AutocompleteController* autocomplete_controller() const {
return edit_model_->autocomplete_controller();
}
const AutocompleteResult& result() const {
return autocomplete_controller()->result();
}
size_t hovered_line() const { return hovered_line_; }
// Call to change the hovered line. |line| should be within the range of
// valid lines (to enable hover) or kNoMatch (to disable hover).
void SetHoveredLine(size_t line);
size_t selected_line() const { return selected_line_; }
LineState selected_line_state() const { return selected_line_state_; }
// Call to change the selected line. This will update all state and repaint
// the necessary parts of the window, as well as updating the edit with the
// new temporary text. |line| will be clamped to the range of valid lines.
// |reset_to_default| is true when the selection is being reset back to the
// default match, and thus there is no temporary text (and no
// |manually_selected_match_|). If |force| is true then the selected line will
// be updated forcibly even if the |line| is same as the current selected
// line.
// NOTE: This assumes the popup is open, and thus both old and new values for
// the selected line should not be kNoMatch.
void SetSelectedLine(size_t line, bool reset_to_default, bool force);
// Called when the user hits escape after arrowing around the popup. This
// will change the selected line back to the default match and redraw.
void ResetToDefaultMatch();
// Immediately updates and opens the popup if necessary, then moves the
// current selection down (|count| > 0) or up (|count| < 0), clamping to the
// first or last result if necessary. If |count| == 0, the selection will be
// unchanged, but the popup will still redraw and modify the text in the
// OmniboxEditModel.
void Move(int count);
// If the selected line has both a normal match and a keyword match, this can
// be used to choose which to select. This allows the user to toggle between
// normal and keyword mode with tab/shift-tab without rerunning autocomplete
// or disturbing other popup state, which in turn is an important part of
// supporting the use of tab to do both tab-to-search and
// tab-to-traverse-dropdown.
//
// It is an error to call this when the selected line does not have both
// matches (or there is no selection).
void SetSelectedLineState(LineState state);
// Called when the user hits shift-delete. This should determine if the item
// can be removed from history, and if so, remove it and update the popup.
void TryDeletingCurrentItem();
// If |match| is from an extension, returns the extension icon; otherwise
// returns an empty Image.
gfx::Image GetIconIfExtensionMatch(const AutocompleteMatch& match) const;
// Returns true if the destination URL of the match is bookmarked.
bool IsStarredMatch(const AutocompleteMatch& match) const;
// The match the user has manually chosen, if any.
const AutocompleteResult::Selection& manually_selected_match() const {
return manually_selected_match_;
}
// Invoked from the edit model any time the result set of the controller
// changes.
void OnResultChanged();
// Add and remove observers.
void AddObserver(OmniboxPopupModelObserver* observer);
void RemoveObserver(OmniboxPopupModelObserver* observer);
// Stores the image in a local data member and schedules a repaint.
void SetAnswerBitmap(const SkBitmap& bitmap);
const SkBitmap& answer_bitmap() const { return answer_bitmap_; }
// The token value for selected_line_, hover_line_ and functions dealing with
// a "line number" that indicates "no line".
static const size_t kNoMatch;
private:
SkBitmap answer_bitmap_;
OmniboxPopupView* view_;
OmniboxEditModel* edit_model_;
// The line that's currently hovered. If we're not drawing a hover rect,
// this will be kNoMatch, even if the cursor is over the popup contents.
size_t hovered_line_;
// The currently selected line. This is kNoMatch when nothing is selected,
// which should only be true when the popup is closed.
size_t selected_line_;
// If the selected line has both a normal match and a keyword match, this
// determines whether the normal match (if NORMAL) or the keyword match
// (if KEYWORD) is selected.
LineState selected_line_state_;
// The match the user has manually chosen, if any.
AutocompleteResult::Selection manually_selected_match_;
// Observers.
base::ObserverList<OmniboxPopupModelObserver> observers_;
DISALLOW_COPY_AND_ASSIGN(OmniboxPopupModel);
};
#endif // COMPONENTS_OMNIBOX_BROWSER_OMNIBOX_POPUP_MODEL_H_
|