File Coverage

blib/lib/UI/Various/toplevel.pm
Criterion Covered Total %
statement 23 24 95.8
branch n/a
condition n/a
subroutine 10 11 90.9
pod 4 4 100.0
total 37 39 94.8


line stmt bran cond sub pod time code
1             package UI::Various::toplevel;
2              
3             # Author, Copyright and License: see end of file
4              
5             =head1 NAME
6              
7             UI::Various::toplevel - abstract top-level widget of L
8              
9             =head1 SYNOPSIS
10              
11             # This module should never be used directly!
12             # It is used indirectly via the following ones:
13             use UI::Various::Window;
14             use UI::Various::Dialog;
15              
16             =head1 ABSTRACT
17              
18             This module is the common abstract container class for the top-level UI
19             elements C> and C>.
20              
21             =head1 DESCRIPTION
22              
23             Besides the common attributes inherited from C and
24             C the C widget knows the following
25             additional attributes:
26              
27             =head2 Attributes
28              
29             =over
30              
31             =cut
32              
33             #########################################################################
34              
35 14     14   1325 use v5.14;
  14         36  
36 14     14   53 use strictures;
  14         21  
  14         84  
37 14     14   1982 no indirect 'fatal';
  14         28  
  14         63  
38 14     14   682 no multidimensional;
  14         25  
  14         64  
39 14     14   420 use warnings 'once';
  14         20  
  14         650  
40              
41             our $VERSION = '0.23';
42              
43 14     14   67 use UI::Various::core;
  14         43  
  14         69  
44 14     14   2210 use UI::Various::container;
  14         28  
  14         2723  
45              
46             require Exporter;
47             our @ISA = qw(UI::Various::container);
48             our @EXPORT_OK = qw();
49              
50             #########################################################################
51              
52             =item height [rw]
53              
54             preferred (maximum) height of an application window / dialogue in
55             (approximately) characters, should not exceed L
56             Manager" |UI::Various::Main/max_height ro>
57              
58             =cut
59              
60             sub height($;$)
61             {
62 0     0 1 0 return access('height', undef, @_);
63             }
64              
65             # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
66              
67             =item max_height [ro, inherited]
68              
69             access to L
70             ro>
71              
72             =cut
73              
74             sub max_height($;$)
75             {
76 4     4 1 14 return UI::Various::widget::_inherited_access('max_height', undef, @_);
77             }
78              
79             # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
80              
81             =item max_width [ro, inherited]
82              
83             access to L
84             ro>
85              
86             =cut
87              
88             sub max_width($;$)
89             {
90 4     4 1 13 return UI::Various::widget::_inherited_access('max_width', undef, @_);
91             }
92              
93             # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
94              
95             =item width [rw]
96              
97             preferred (maximum) width of an application window / dialogue in
98             (approximately) characters, may not exceed L
99             Manager" |UI::Various::Main/max_width ro>
100              
101             =cut
102              
103             sub width($;$)
104             {
105 114     114 1 195 return access('width', undef, @_);
106             }
107              
108             #########################################################################
109              
110             1;
111              
112             #########################################################################
113             #########################################################################
114              
115             =back
116              
117             =head1 SEE ALSO
118              
119             L
120              
121             =head1 LICENSE
122              
123             Copyright (C) Thomas Dorner.
124              
125             This library is free software; you can redistribute it and/or modify it
126             under the same terms as Perl itself. See LICENSE file for more details.
127              
128             =head1 AUTHOR
129              
130             Thomas Dorner Edorner (at) cpan (dot) orgE
131              
132             =cut