/usr/share/sugar/activities/Browse.activity/progresstoolbutton.py is in sugar-browse-activity 202-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | # Copyright (C) 2016 Utkarsh Tiwari <iamutkarshtiwari@gmail.com>
# Copyright (C) 2016 Sam Parkinson <sam@sam.today>
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# 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 <http://www.gnu.org/licenses/>.
'''
The progress toolbutton is a :class:`sugar3.graphics.progressicon.ProgressIcon`
that fits into a toolbar. It is a great way to convey progress of an
ongoing background operation, especially if you want to have a palette with
more detailed information.
Using the progress toolbutton is just like using a regular toolbutton; you
set the icon name and add it to the toolbar. You can then use the `update`
function as the operation progresses to change the fill percentage.
Example::
self._download_icon = ProgressToolButton(icon_name='emblem-downloads')
self._download_icon.props.tooltip = _('No Download Running')
toolbar.insert(self._download_icon, -1)
self._download_icon.show()
def __download_progress_cb(self, progress):
self._download_icon.props.tooltip = _('Downloading')
self._download_icon.update(progress)
'''
from gi.repository import Gtk
from gi.repository import GObject
from sugar3.graphics import style
from sugar3.graphics.toolbutton import ToolButton
from sugar3.graphics.progressicon import ProgressIcon
from sugar3.graphics.xocolor import XoColor
class ProgressToolButton(ToolButton):
'''
This button is just like a normal tool button, except that the
icon can dynamically fill based on a progress number.
'''
__gtype_name__ = 'SugarProgressToolButton'
def __init__(self, **kwargs):
self._xo_color = XoColor('insensitive')
self._icon_name = None
self._direction = 'vertical'
self._progress = 0.0
ToolButton.__init__(self, **kwargs)
# GObject should do this, but something down the ToolButton chain of
# parents is not passing the kwargs to GObject
if 'xo_color' in kwargs:
self.props.xo_color = kwargs['xo_color']
if 'icon_name' in kwargs:
self.props.icon_name = kwargs['icon_name']
if 'direction' in kwargs:
self.props.direction = kwargs['direction']
self._updated()
@GObject.property
def xo_color(self):
'''
This property defines the stroke and fill of the icon, and is
the type :class:`sugar3.graphics.xocolor.XoColor`
'''
return self._xo_color
@xo_color.setter
def xo_color(self, new):
self._xo_color = new
self._updated()
@GObject.property
def icon_name(self):
'''
Icon name (same as with a :class:`sugar3.graphics.icon.Icon`), as the
type :class:`str`
'''
return self._icon_name
@icon_name.setter
def icon_name(self, new):
self._icon_name = new
self._updated()
@GObject.property
def direction(self):
'''
Direction for the icon to fill as it progresses, filling either,
* :class:`Gtk.Orientation.VERTICAL` - bottom to top
* :class:`Gtk.Orientation.HORIZONTAL` - user's text direction
'''
if self._direction == 'vertical':
return Gtk.Orientation.VERTICAL
else:
return Gtk.Orientation.HORIZONTAL
@direction.setter
def direction(self, new):
if new == Gtk.Orientation.VERTICAL:
self._direction = 'vertical'
else:
self._direction = 'horizontal'
self._updated()
def _updated(self):
self._icon = ProgressIcon(
self._icon_name,
style.STANDARD_ICON_SIZE,
self._xo_color.get_stroke_color(),
self._xo_color.get_fill_color(),
self._direction)
self._icon.update(self._progress)
self.set_icon_widget(self._icon)
self._icon.show()
def update(self, progress):
'''
Redraw the icon with a different percentage filled in
Args:
progress (float): a value from 0.0 to 1.0, where 1.0 fully
fills the icon and 0.0 results in only the stroke being
visible
'''
self._progress = progress
self._icon.update(progress)
self.queue_draw()
|