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
|
# Copyright (c) 2008-2009 Simon Busch
#
# This file is part of python-elementary.
#
# python-elementary 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, either version 3 of the License, or
# (at your option) any later version.
#
# python-elementary 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 python-elementary. If not, see <http://www.gnu.org/licenses/>.
#
cdef public class Label(LayoutClass) [object PyElementaryLabel, type PyElementaryLabel_Type]:
"""Widget to display text, with simple html-like markup.
The Label widget B{doesn't} allow text to overflow its boundaries, if the
text doesn't fit the geometry of the label it will be ellipsized or be
cut. Elementary provides several styles for this widget:
- default - No animation
- marker - Centers the text in the label and makes it bold by default
- slide_long - The entire text appears from the right of the screen and
slides until it disappears in the left of the screen(reappearing on the
right again).
- slide_short - The text appears in the left of the label and slides to
the right to show the overflow. When all of the text has been shown the
position is reset.
- slide_bounce - The text appears in the left of the label and slides to
the right to show the overflow. When all of the text has been shown the
animation reverses, moving the text to the left.
Custom themes can of course invent new markup tags and style them any way
they like.
This widget emits the following signals, besides the ones sent from
L{Layout}:
- C{"language,changed"}: The program's language changed.
"""
def __init__(self, evasObject parent):
Object.__init__(self, parent.evas)
self._set_obj(elm_label_add(parent.obj))
def line_wrap_set(self, Elm_Wrap_Type wrap):
"""Set the wrapping behavior of the label
By default no wrapping is done. Possible values for C{wrap} are:
- ELM_WRAP_NONE - No wrapping
- ELM_WRAP_CHAR - wrap between characters
- ELM_WRAP_WORD - wrap between words
- ELM_WRAP_MIXED - Word wrap, and if that fails, char wrap
@param wrap: To wrap text or not
@type wrap: Elm_Wrap_Type
"""
elm_label_line_wrap_set(self.obj, wrap)
def line_wrap_get(self):
"""Get the wrapping behavior of the label
@see: L{line_wrap_set()}
@return: Wrap type
@rtype: Elm_Wrap_Type
"""
return elm_label_line_wrap_get(self.obj)
property line_wrap:
"""The wrapping behavior of the label
By default no wrapping is done. Possible values for C{wrap} are:
- ELM_WRAP_NONE - No wrapping
- ELM_WRAP_CHAR - wrap between characters
- ELM_WRAP_WORD - wrap between words
- ELM_WRAP_MIXED - Word wrap, and if that fails, char wrap
@type: Elm_Wrap_Type
"""
def __get__(self):
return elm_label_line_wrap_get(self.obj)
def __set__(self, wrap):
elm_label_line_wrap_set(self.obj, wrap)
def wrap_width_set(self, int w):
"""Set wrap width of the label
This function sets the maximum width size hint of the label.
@warning: This is only relevant if the label is inside a container.
@param w: The wrap width in pixels at a minimum where words need to wrap
@type w: int
"""
elm_label_wrap_width_set(self.obj, w)
def wrap_width_get(self):
"""Get wrap width of the label
@see: L{wrap_width_set()}
@return: The wrap width in pixels at a minimum where words need to wrap
@rtype: int
"""
return elm_label_wrap_width_get(self.obj)
property wrap_width:
"""Wrap width of the label
This is the maximum width size hint of the label.
@warning: This is only relevant if the label is inside a container.
@type: int
"""
def __get__(self):
return elm_label_wrap_width_get(self.obj)
def __set__(self, w):
elm_label_wrap_width_set(self.obj, w)
def ellipsis_set(self, bool ellipsis):
"""Set the ellipsis behavior of the label
If set to True and the text doesn't fit in the label an ellipsis("...")
will be shown at the end of the widget.
@warning: This doesn't work with slide(L{slide_set()}) or if the
chosen wrap method was ELM_WRAP_WORD.
@param ellipsis: To ellipsis text or not
@type ellipsis: bool
"""
elm_label_ellipsis_set(self.obj, ellipsis)
def ellipsis_get(self):
"""Get the ellipsis behavior of the label
@see: L{ellipsis_set()}
@return: If True, an ellipsis will be shown at the end of the label area.
"""
return elm_label_ellipsis_get(self.obj)
property ellipsis:
"""The ellipsis behavior of the label
If set to True and the text doesn't fit in the label an ellipsis("...")
will be shown at the end of the widget.
@warning: This doesn't work with slide(L{slide}) or if the
chosen wrap method was ELM_WRAP_WORD.
@type: bool
"""
def __get__(self):
return elm_label_ellipsis_get(self.obj)
def __set__(self, ellipsis):
elm_label_ellipsis_set(self.obj, ellipsis)
def slide_set(self, bool slide):
"""Set the sliding effect of the label widget.
If set to True, the text of the label will slide/scroll through the length of
label.
@warning: This only works with the themes "slide_short", "slide_long" and
"slide_bounce".
@param slide: If True, sliding effect will be shown
@type slide: bool
"""
elm_label_slide_set(self.obj, slide)
def slide_get(self):
"""Get whether sliding effect is shown or not.
@see: L{slide_set()}
@return: If True, sliding effect is shown.
@rtype: bool
"""
return elm_label_slide_get(self.obj)
property slide:
"""The sliding effect of the label widget.
If set to True, the text of the label will slide/scroll through the length of
label.
@warning: This only works with the themes "slide_short", "slide_long" and
"slide_bounce".
@type: bool
"""
def __get__(self):
return elm_label_slide_get(self.obj)
def __set__(self, slide):
elm_label_slide_set(self.obj, slide)
def slide_duration_set(self, duration):
"""Set the slide duration (speed) of the label
@param duration: The duration in seconds in moving text from slide begin position
to slide end position
@type duration: float
"""
elm_label_slide_duration_set(self.obj, duration)
def slide_duration_get(self):
"""Get the slide duration(speed) of the label
@see: L{slide_duration_set()}
@return: The duration time in moving text from slide begin position to slide end position
@rtype: float
"""
return elm_label_slide_duration_get(self.obj)
property slide_duration:
"""The duration time in moving text from slide begin position to slide end position
@type: float
"""
def __get__(self):
return elm_label_slide_duration_get(self.obj)
def __set__(self, duration):
elm_label_slide_duration_set(self.obj, duration)
def callback_language_changed_add(self, func, *args, **kwargs):
"""The program's language changed."""
self._callback_add("language,changed", func, *args, **kwargs)
def callback_language_changed_del(self, func):
self._callback_del("language,changed", func)
_elm_widget_type_register("label", Label)
cdef extern from "Elementary.h": # hack to force type to be known
cdef PyTypeObject PyElementaryLabel_Type # hack to install metaclass
_install_metaclass(&PyElementaryLabel_Type, ElementaryObjectMeta)
|
