xref: /external/chromium_org/ui/app_list/search_result.h

// 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 UI_APP_LIST_SEARCH_RESULT_H_
#define UI_APP_LIST_SEARCH_RESULT_H_

#include <vector>

#include "base/basictypes.h"
#include "base/observer_list.h"
#include "base/string16.h"
#include "ui/app_list/app_list_export.h"
#include "ui/base/models/list_model.h"
#include "ui/base/range/range.h"
#include "ui/gfx/image/image_skia.h"

namespace app_list {

class SearchResultObserver;

// SearchResult consists of an icon, title text and details text. Title and
// details text can have tagged ranges that are displayed differently from
// default style.
class APP_LIST_EXPORT SearchResult {
 public:
  // A tagged range in search result text.
  struct Tag {
    // Similar to ACMatchClassification::Style, the style values are not
    // mutually exclusive.
    enum Style {
      NONE  = 0,
      URL   = 1 << 0,
      MATCH = 1 << 1,
      DIM   = 1 << 2,
    };

    Tag(int styles, size_t start, size_t end)
        : styles(styles),
          range(start, end) {
    }

    int styles;
    ui::Range range;
  };
  typedef std::vector<Tag> Tags;

  // A collection of images representing an action that can be performed on this
  // search result.
  struct ActionIconSet {
    ActionIconSet(const gfx::ImageSkia& base_image,
                  const gfx::ImageSkia& hover_image,
                  const gfx::ImageSkia& pressed_image,
                  const string16& tooltip_text);
    ~ActionIconSet();

    gfx::ImageSkia base_image;
    gfx::ImageSkia hover_image;
    gfx::ImageSkia pressed_image;

    string16 tooltip_text;
  };
  typedef std::vector<ActionIconSet> ActionIconSets;

  SearchResult();
  virtual ~SearchResult();

  const gfx::ImageSkia& icon() const { return icon_; }
  void SetIcon(const gfx::ImageSkia& icon);

  const string16& title() const { return title_; }
  void set_title(const string16& title) { title_ = title;}

  const Tags& title_tags() const { return title_tags_; }
  void set_title_tags(const Tags& tags) { title_tags_ = tags; }

  const string16& details() const { return details_; }
  void set_details(const string16& details) { details_ = details; }

  const Tags& details_tags() const { return details_tags_; }
  void set_details_tags(const Tags& tags) { details_tags_ = tags; }

  const ActionIconSets& action_icons() const {
    return action_icons_;
  }
  void SetActionIcons(const ActionIconSets& sets);

  void AddObserver(SearchResultObserver* observer);
  void RemoveObserver(SearchResultObserver* observer);

 private:
  gfx::ImageSkia icon_;

  string16 title_;
  Tags title_tags_;

  string16 details_;
  Tags details_tags_;

  // Optional list of icons representing additional actions that can be
  // performed on this result.
  ActionIconSets action_icons_;

  ObserverList<SearchResultObserver> observers_;

  DISALLOW_COPY_AND_ASSIGN(SearchResult);
};

}  // namespace app_list

#endif  // UI_APP_LIST_SEARCH_RESULT_H_