// -*- Mode: C++; indent-tabs-mode: nil; tab-width: 2 -*-
/*
* Copyright (C) 2010 Canonical Ltd
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 3 as
* published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
*
* Authored by: Jay Taoko
* Authored by: Mirco Müller
#include
#include
#include
#include
#include
#include
#include
#include
#include "CairoBaseWindow.h"
#include "QuicklistMenuItem.h"
#include "unity-shared/Introspectable.h"
#include "unity-shared/RawPixel.h"
namespace unity
{
class QuicklistView : public CairoBaseWindow, public debug::Introspectable
{
NUX_DECLARE_OBJECT_TYPE(QuicklistView, unity::CairoBaseWindow);
public:
QuicklistView(int monitor = 0);
void SetText(std::string const& text);
void RemoveAllMenuItem();
void AddMenuItem(QuicklistMenuItem* item);
void RenderQuicklistView();
void SetQuicklistPosition(int x, int y);
void ShowQuicklistWithTipAt(int x, int y);
void Show();
void Hide();
void HideAndEndQuicklistNav();
int GetNumItems();
QuicklistMenuItem* GetNthItems(int index);
QuicklistMenuItemType GetNthType(int index);
int GetItemIndex(QuicklistMenuItem* item);
std::list GetChildren();
void SelectFirstItem();
void TestMenuItems(DbusmenuMenuitem* root);
// Introspection
std::string GetName() const;
void AddProperties(debug::IntrospectionData&);
IntrospectableList GetIntrospectableChildren();
void EnableQuicklistForTesting(bool enable_testing);
// Key navigation
virtual bool InspectKeyEvent(unsigned int eventType,
unsigned int keysym,
const char* character);
//Required for a11y
QuicklistMenuItem* GetSelectedMenuItem();
sigc::signal selection_change;
protected:
void Draw(nux::GraphicsEngine& gfxContext, bool forceDraw);
void DrawContent(nux::GraphicsEngine& gfxContext, bool forceDraw);
private:
void RecvCairoTextChanged(QuicklistMenuItem* item);
void RecvCairoTextColorChanged(QuicklistMenuItem* item);
void RecvItemMouseClick(QuicklistMenuItem* item, int x, int y);
void RecvItemMouseRelease(QuicklistMenuItem* item, int x, int y);
void RecvItemMouseEnter(QuicklistMenuItem* item);
void RecvItemMouseLeave(QuicklistMenuItem* item);
void RecvItemMouseDrag(QuicklistMenuItem* item, int x, int y);
void RecvMouseDown(int x, int y, unsigned long button_flags, unsigned long key_flags);
void RecvMouseUp(int x, int y, unsigned long button_flags, unsigned long key_flags);
void RecvMouseClick(int x, int y, unsigned long button_flags, unsigned long key_flags);
void RecvMouseMove(int x, int y, int dx, int dy, unsigned long button_flags, unsigned long key_flags);
void RecvMouseDrag(int x, int y, int dx, int dy, unsigned long button_flags, unsigned long key_flags);
void RecvMouseDownOutsideOfQuicklist(int x, int y, unsigned long button_flags, unsigned long key_flags);
void RecvKeyPressed(unsigned long eventType , /*event type*/
unsigned long keysym , /*event keysym*/
unsigned long state , /*event state*/
const TCHAR* character , /*character*/
unsigned short keyCount);
void RecvStartFocus();
void RecvEndFocus();
void PreLayoutManagement();
long PostLayoutManagement(long layoutResult);
void PositionChildLayout(float offsetX, float offsetY);
void LayoutWindowElements();
void NotifyConfigurationChange(int width, int height);
//! A convenience function to fill in the default quicklist with some random items.
void FillInDefaultItems();
void CancelItemsPrelightStatus();
//! Check the mouse up event sent by an item. Detect the item where the mous is and emit the appropriate signal.
void CheckAndEmitItemSignal(int x, int y);
void ActivateItem(QuicklistMenuItem* item);
void SelectItem(int index);
bool IsMenuItemSelectable(int index);
int CalculateX() const;
int CalculateY() const;
int _anchorX;
int _anchorY;
std::string _labelText;
RawPixel _top_size; // size of the segment from point 13 to 14. See figure in ql_compute_full_mask_path.
RawPixel _padding;
bool _mouse_down;
//iIf true, suppress the Quicklist behaviour that is expected in Unity.
// Keep the Quicklist on screen for testing and automation.
bool _enable_quicklist_for_testing;
nux::HLayout* _hlayout;
nux::VLayout* _vlayout;
nux::VLayout* _item_layout;
nux::SpaceLayout* _left_space; //!< Space from the left of the widget to the left of the text.
nux::SpaceLayout* _right_space; //!< Space from the right of the text to the right of the widget.
nux::SpaceLayout* _top_space; //!< Space from the left of the widget to the left of the text.
nux::SpaceLayout* _bottom_space; //!< Space from the right of the text to the right of the widget.
bool _cairo_text_has_changed;
void UpdateTexture();
std::list _item_list;
// used by keyboard/a11y-navigation
int _current_item_index;
};
} // NAMESPACE
#endif // QUICKLISTVIEW_H