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 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315
|
# -*- Mode: Python; coding: utf-8; indent-tabs-mode: nil; tab-width: 4 -*-
#
# Copyright (C) 2012-2015 Canonical Ltd.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation; version 3.
#
# 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 Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
import logging
from autopilot import logging as autopilot_logging
from autopilot.introspection import dbus
from lomiriuitoolkit._custom_proxy_objects import (
_common,
_tabbar
)
_NO_TABS_ERROR = 'The MainView has no Tabs.'
logger = logging.getLogger(__name__)
class AppHeader(_common.LomiriUIToolkitCustomProxyObjectBase):
"""AppHeader Autopilot custom proxy object."""
def __init__(self, *args):
super().__init__(*args)
if not hasattr(self, 'useDeprecatedToolbar'):
self.useDeprecatedToolbar = None
def ensure_visible(self):
if not self._is_visible():
self._show()
def _is_visible(self):
return self.y == 0
def _show(self):
# FIXME This will fail if the header is not linked to a flickable that
# fills the main view. The header has a flickable property but it
# can't be read by autopilot. See bug http://pad.lv/1318829
top_container = self._get_top_container()
# Make the drag range be a multiple of the drag "rate" value.
# Workarounds https://bugs.launchpad.net/mir/+bug/1399690
rate = 10
start_x = stop_x = self.globalRect.x + self.globalRect.width // 2
start_y = top_container.globalRect.y + 5
stop_y = start_y + self.globalRect.height // rate * rate
self.pointing_device.drag(start_x, start_y, stop_x, stop_y, rate)
self.y.wait_for(0)
def wait_for_animation(self):
try:
style = self.select_single(objectName='PageHeadStyle')
style.animating.wait_for(False)
except dbus.StateNotFoundError:
# AppHeader is not using the new PageHeadStyle,
# so no need to wait.
return
# Wait showing/hiding animation of the header.
self.moving.wait_for(False)
@autopilot_logging.log_action(logger.info)
def switch_to_section_by_index(self, index):
"""Select a section in the header divider
:parameter index: The index of the section to select
:raise ToolkitEmulatorException: If the selection index is out of
range or useDeprecatedToolbar is set.
"""
self.ensure_visible()
if self.useDeprecatedToolbar:
raise _common.ToolkitException('Old header has no sections')
self.wait_for_animation()
try:
# Lomiri.Components >=1.3
sections = self.select_single(
'Sections', objectName='headerSectionsItem')
sections.click_section_button(index)
except dbus.StateNotFoundError:
# Lomiri.Components < 1.3, has no headerSectionsItem.
try:
object_name = "section_button_" + str(index)
button = self.select_single(objectName=object_name)
except dbus.StateNotFoundError:
raise _common.ToolkitException(
'Button for section with given index not found')
self.pointing_device.click_object(button)
def get_selected_section_index(self):
if self.useDeprecatedToolbar:
raise _common.ToolkitException('Old header has no sections')
self.wait_for_animation()
try:
# Lomiri.Components >=1.3
sections = self.select_single(
'Sections', objectName='headerSectionsItem')
return sections.selectedIndex
except dbus.StateNotFoundError:
# Lomiri.Components < 1.3, has no headerSectionsItem.
sectionsProperties = self.select_single(
'QQuickItem', objectName='sectionsProperties')
return sectionsProperties.selectedIndex
def click_back_button(self):
self.ensure_visible()
if self.useDeprecatedToolbar:
raise _common.ToolkitException('Old header has no back button')
try:
self.wait_for_animation()
back_button = self.select_single(objectName='backButton')
except dbus.StateNotFoundError:
raise _common.ToolkitException('Missing back button in header')
if not back_button.visible:
raise _common.ToolkitException('Back button in header not visible')
self.pointing_device.click_object(back_button)
self.wait_for_animation()
def click_custom_back_button(self):
self.ensure_visible()
if self.useDeprecatedToolbar:
raise _common.ToolkitException(
'Old header has no custom back button')
try:
self.wait_for_animation()
custom_back_button = self.select_single(
objectName='customBackButton')
except dbus.StateNotFoundError:
raise _common.ToolkitException(
'Missing custom back button in header')
if not custom_back_button.visible:
raise _common.ToolkitException(
'Custom back button in header not visible')
self.pointing_device.click_object(custom_back_button)
self.wait_for_animation()
def _get_animating(self):
if self.useDeprecatedToolbar:
tab_bar_style = self.select_single('TabBarStyle')
return tab_bar_style.animating
else:
return False
@autopilot_logging.log_action(logger.info)
def switch_to_next_tab(self):
"""Open the next tab.
:raise ToolkitException: If the main view has no tabs.
"""
self.ensure_visible()
if self.useDeprecatedToolbar:
self._switch_to_next_tab_in_deprecated_tabbar()
else:
self._switch_to_next_tab_in_drawer()
def _switch_to_next_tab_in_deprecated_tabbar(self):
try:
tab_bar = self.select_single(_tabbar.TabBar)
except dbus.StateNotFoundError:
raise _common.ToolkitException(_NO_TABS_ERROR)
tab_bar.switch_to_next_tab()
self._get_animating().wait_for(False)
def _switch_to_next_tab_in_drawer(self):
self.wait_for_animation()
tabs_model_properties = self.select_single(
'QQuickItem', objectName='tabsModelProperties')
if tabs_model_properties.count == 0:
raise _common.ToolkitException(_NO_TABS_ERROR)
next_tab_index =\
(tabs_model_properties.selectedIndex + 1)\
% tabs_model_properties.count
self._switch_to_tab_in_drawer_by_index(next_tab_index)
@autopilot_logging.log_action(logger.info)
def switch_to_tab_by_index(self, index):
"""Open a tab. This only supports the new tabs in the header
:parameter index: The index of the tab to open.
:raise ToolkitException: If the tab index is out
of range or useDeprecatedToolbar is set.
"""
self.ensure_visible()
if self.useDeprecatedToolbar:
raise _common.ToolkitException(
"AppHeader.switch_to_tab_by_index only works with new header")
else:
self._switch_to_tab_in_drawer_by_index(index)
def _switch_to_tab_in_drawer_by_index(self, index):
self.wait_for_animation()
try:
tabs_drawer_button = self.select_single(objectName='tabsButton')
except dbus.StateNotFoundError:
raise _common.ToolkitException(_NO_TABS_ERROR)
self.pointing_device.click_object(tabs_drawer_button)
tabs_model_properties = self.select_single(
'QQuickItem', objectName='tabsModelProperties')
if tabs_model_properties.selectedIndex == index:
return
popover = self.get_root_instance().select_single(
objectName='tabsPopover')
try:
# 1.3, using ActionSelectionPopover
action_name = 'select_tab_' + str(index)
popover.click_action_button(action_name)
except _common.ToolkitException:
try:
# < 1.3 using custom popover
tab_button = self.get_root_instance().select_single(
objectName='tabButton' + str(index))
self.pointing_device.click_object(tab_button)
except dbus.StateNotFoundError:
raise _common.ToolkitException(
"Tab button {0} not found.".format(index))
self.wait_for_animation()
def click_action_button(self, action_object_name):
"""Click an action button of the header.
:parameter object_name: The QML objectName property of the action
:raise ToolkitException: If there is no action button with that object
name.
"""
self.ensure_visible()
try:
# for Lomiri.Components 1.3
actionbar = self.select_single(
'ActionBar', objectName='headerActionBar')
actionbar.click_action_button(action_object_name)
except dbus.StateNotFoundError:
# for Lomiri.Components < 1.3
button = self._get_action_button(action_object_name)
# In an animating header, the button is disabled until the header
# animation is done. Wait for that:
button.enabled.wait_for(True)
self.pointing_device.click_object(button)
except _common.ToolkitException:
# Catch 'Button not found in ActionBar or overflow' exception
raise _common.ToolkitException(
'Button not found in header or overflow')
self.wait_for_animation()
def _get_action_button(self, action_object_name):
self.wait_for_animation()
try:
object_name = action_object_name + "_header_button"
button = self.select_single(objectName=object_name)
except dbus.StateNotFoundError:
# the button is not in the header, but it may be in the overflow
try:
button = self._get_action_button_in_overflow(
action_object_name)
except dbus.StateNotFoundError:
raise _common.ToolkitException(
'Button not found in header or overflow')
return button
def _get_action_button_in_overflow(self, action_object_name):
actions_overflow_button = self.select_single(
objectName='actions_overflow_button')
if not actions_overflow_button.visible:
raise _common.ToolkitException('No actions in overflow')
# open the popover
self.pointing_device.click_object(actions_overflow_button)
object_name = action_object_name + "_header_overflow_button"
# the popover is not a child of the header, so use the root object
# to find the requested button
return self.get_root_instance().select_single(objectName=object_name)
class Header(AppHeader):
"""Autopilot helper for the deprecated Header."""
def __init__(self, *args):
logger.warning(
'Header is an internal QML component of Lomiri.Components and '
'its API may change or be removed at any moment. Please use '
'MainView and Page instead.')
super().__init__(*args)
|