1Prima::Label(3)       User Contributed Perl Documentation      Prima::Label(3)
2
3
4

NAME

6       Prima::Label - static text widget
7

DESCRIPTION

9       The class is designed for display of text, and assumes no user
10       interaction. The text output capabilities include wrapping, horizontal
11       and vertical alignment, and automatic widget resizing to match text
12       extension. If text contains a tilde-escaped ( hot ) character, the
13       label can explicitly focus the specified widget upon press of the
14       character key, what feature is useful for dialog design.
15

SYNOPSIS

17               use Prima qw(Label InputLine Application);
18               my $w = Prima::MainWindow->new;
19               $w->insert( 'Prima::Label',
20                       text      => 'Enter ~name:',
21                       focusLink => 'InputLine1',
22                       alignment => ta::Center,
23                       pack => { fill => 'x', side => 'top', pad => 10 },
24               );
25               $w->insert(
26                       'Prima::InputLine',
27                       text => '',
28                       pack => { fill => 'x', side => 'top', pad => 10 },
29               );
30               run Prima;
31

API

33   Properties
34       alignment INTEGER
35           One of the following "ta::XXX" constants:
36
37                   ta::Left
38                   ta::Center
39                   ta::Right
40
41           Selects the horizontal text alignment.
42
43           Default value: "ta::Left"
44
45       autoHeight BOOLEAN
46           If 1, the widget height is automatically changed as text extensions
47           change.
48
49           Default value: 0
50
51       autoWidth BOOLEAN
52           If 1, the widget width is automatically changed as text extensions
53           change.
54
55           Default value: 1
56
57       focusLink WIDGET
58           Points to a widget or a widget name (has to be a sibling widget),
59           which is explicitly focused when the user presses the combination
60           of a hot key with the "Alt" key.
61
62           Prima::Label does not provide a separate property to access the hot
63           key value, however it can be read from the "{accel}" variable.
64
65           Default value: "undef".
66
67       hotKey CHAR
68           A key that the label will react to if pressed, even when out of
69           focus.
70
71       showAccelChar BOOLEAN
72           If 0, the tilde ( ~ ) character is collapsed from the text, and the
73           hot character is underlined. When the user presses combination of
74           the escaped character with the "Alt" key, the "focusLink" widget is
75           explicitly focused.
76
77           If 1, the text is showed as is, and no hot character is underlined.
78           Key combinations with "Alt" key are not recognized. See also:
79           "hotKey".
80
81           Default value: 0
82
83       showPartial BOOLEAN
84           Used to determine if the last line of text should be drawn if it
85           can not be vertically fit in the widget interior. If 1, the last
86           line is shown even if not visible in full. If 0, only full lines
87           are drawn.
88
89           Default value: 1
90
91       textDirection BOOLEAN
92           If set, indicates RTL text direction.
93
94       wordWrap BOOLEAN
95           If 1, the text is wrapped if it can not be horizontally fit in the
96           widget interior.
97
98           If 0, the text is not wrapped unless new line characters are
99           present in the text.
100
101           New line characters signal line wrapping with no respect to
102           "wordWrap" property value.
103
104           Default value: 0
105
106       valignment INTEGER
107           One of the following "ta::XXX" constants:
108
109                   ta::Top
110                   ta::Middle or ta::Center
111                   ta::Bottom
112
113           Selects the vertical text alignment.
114
115           NB: "ta::Middle" value is not equal to "ta::Center"'s, however the
116           both constants produce equal effect here.
117
118           Default value: "ta::Top"
119

AUTHOR

121       Dmitry Karasik, <dmitry@karasik.eu.org>.
122

SEE ALSO

124       Prima, Prima::Widget, examples/label.pl
125
126
127
128perl v5.32.1                      2021-01-27                   Prima::Label(3)
Impressum