File: wx.lib.agw.foldpanelbar.FoldPanelItem.txt

package info (click to toggle)
wxpython4.0 4.0.4%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 211,112 kB
  • sloc: cpp: 888,355; python: 223,130; makefile: 52,087; ansic: 45,780; sh: 3,012; xml: 1,534; perl: 264
file content (226 lines) | stat: -rw-r--r-- 10,139 bytes parent folder | download
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
.. wxPython Phoenix documentation

   This file was generated by Phoenix's sphinx generator and associated
   tools, do not edit by hand.

   Copyright: (c) 2011-2018 by Total Control Software
   License:   wxWindows License

.. include:: headings.inc

.. currentmodule:: wx.lib.agw.foldpanelbar

.. highlight:: python



.. _wx.lib.agw.foldpanelbar.FoldPanelItem:

==========================================================================================================================================
|phoenix_title|  **wx.lib.agw.foldpanelbar.FoldPanelItem**
==========================================================================================================================================

This class is a child sibling of the :class:`FoldPanelBar` class. It will
contain a :class:`CaptionBar` class for receiving of events, and a the
rest of the area can be populated by a :class:`Panel` derived class.



|

|class_hierarchy| Class Hierarchy
=================================

.. raw:: html

   <div id="toggleBlock" onclick="return toggleVisibility(this)" class="closed" style="cursor:pointer;">
   <img id="toggleBlock-trigger" src="_static/images/closed.png"/>
   Inheritance diagram for class <strong>FoldPanelItem</strong>:
   </div>
   <div id="toggleBlock-summary" style="display:block;"></div>
   <div id="toggleBlock-content" style="display:none;">
   <p class="graphviz">
   <center><img src="_static/images/inheritance/wx.lib.agw.foldpanelbar.FoldPanelItem_inheritance.png" alt="Inheritance diagram of FoldPanelItem" usemap="#dummy" class="inheritance"/></center>
   </div>
   <script type="text/javascript">toggleVisibilityOnLoad(document.getElementById('toggleBlock'))</script>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="wx.Panel.html" title="wx.Panel" alt="" coords="95,315,171,344"/> <area shape="rect" id="node7" href="wx.lib.agw.foldpanelbar.FoldPanelItem.html" title="wx.lib.agw.foldpanelbar.FoldPanelItem" alt="" coords="4,392,261,421"/> <area shape="rect" id="node2" href="wx.Window.html" title="wx.Window" alt="" coords="89,237,177,267"/> <area shape="rect" id="node3" href="wx.Trackable.html" title="wx.Trackable" alt="" coords="25,5,127,35"/> <area shape="rect" id="node4" href="wx.EvtHandler.html" title="wx.EvtHandler" alt="" coords="77,83,188,112"/> <area shape="rect" id="node6" href="wx.WindowBase.html" title="wx.WindowBase" alt="" coords="73,160,193,189"/> <area shape="rect" id="node5" href="wx.Object.html" title="wx.Object" alt="" coords="151,5,232,35"/> </map> 
   </p>

|


|super_classes| Known Superclasses
==================================

:class:`wx.Panel`

|


|method_summary| Methods Summary
================================

================================================================================ ================================================================================
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.__init__`                          Default class constructor.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.AddSeparator`                      Adds a separator item to the list of items on this panel.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.AddWindow`                         Adds a window item to the list of items on this panel.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.ApplyCaptionStyle`                 Applies the style defined in `cbstyle` to the :class:`CaptionBar`.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.Collapse`                          Internal method.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.Expand`                            Internal method.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.GetCaptionLength`                  Returns height of caption only. This is for folding calculation purposes.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.GetCaptionStyle`                   Returns the current style of the captionbar in a :class:`CaptionBarStyle` class.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.GetItemPos`                        Returns item's position.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.GetPanelLength`                    Returns size of panel.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.IsExpanded`                        Returns expanded or collapsed status.  If the panel is
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.IsVertical`                        Returns whether the :class:`CaptionBar` has default orientation or not.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.OnPaint`                           Handles the ``wx.EVT_PAINT`` event for :class:`FoldPanelItem`.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.OnPressCaption`                    Handles the ``wx.EVT_CAPTIONBAR`` event for :class:`FoldPanelItem`.
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.Reposition`                        Repositions this :class:`FoldPanelItem` and reports the length occupied
:meth:`~wx.lib.agw.foldpanelbar.FoldPanelItem.ResizePanel`                       Resizes the panel.
================================================================================ ================================================================================


|


|api| Class API
===============


.. class:: FoldPanelItem(wx.Panel)

   This class is a child sibling of the :class:`FoldPanelBar` class. It will
   contain a :class:`CaptionBar` class for receiving of events, and a the
   rest of the area can be populated by a :class:`Panel` derived class.

   .. method:: __init__(self, parent, id=wx.ID_ANY, caption="", foldIcons=None, collapsed=False, cbstyle=None)

      Default class constructor.
      
      :param `parent`: the :class:`FoldPanelItem` parent window;
      :param `id`: an identifier for the control: a value of -1 is taken to mean a default;
      :param `caption`: the string to be displayed in :class:`CaptionBar`;
      :param `foldIcons`: an instance of :class:`wx.ImageList` containing the icons to display
       next to the caption text;
      :param `collapsed`: ``True`` if the :class:`CaptionBar` should start in the collapsed state,
       ``False`` otherwise;
      :param `cbstyle`: the :class:`CaptionBar` window style. Must be an instance of
       :class:`CaptionBarStyle`.


   .. method:: AddSeparator(self, colour=wx.BLACK, spacing=FPB_DEFAULT_SPACING, leftSpacing=FPB_DEFAULT_LEFTSPACING, rightSpacing=FPB_DEFAULT_RIGHTSPACING)

      Adds a separator item to the list of items on this panel.
      
      :param `colour`: the separator colour, an instance of :class:`wx.Colour`;
      :param `spacing`: the separator to be added can be slightly indented from
       left and right so it is more visibly placed in the fold panel. Use `spacing` > 0
       to give the control an y offset from the previous :class:`wx.Window` added;
      :param `leftSpacing`: give the added separator a slight indent from the left;
      :param `rightSpacing`: give the added separator a slight indent from the right.


   .. method:: AddWindow(self, window, flags=FPB_ALIGN_WIDTH, spacing=FPB_DEFAULT_SPACING, leftSpacing=FPB_DEFAULT_LEFTLINESPACING, rightSpacing=FPB_DEFAULT_RIGHTLINESPACING)

      Adds a window item to the list of items on this panel.
      
      :param `window`: an instance of :class:`wx.Window`;
      :param `flags`: can be one of the following bits:
      
       ====================== ======= ====================================
       Align Flag              Value  Description
       ====================== ======= ====================================
       ``FPB_ALIGN_WIDTH``          1 The :class:`wx.Window` to be added will be aligned to fit the width of the FoldPanel when it is resized. Very handy for sizer items, buttons and text boxes.
       ``FPB_ALIGN_LEFT``           0 Aligns left instead of fitting the width of the child window to be added. Use either this one or ``FPB_ALIGN_WIDTH``.
       ====================== ======= ====================================
      
      :param `spacing`: reserves a number of pixels before the window element;
      :param `leftSpacing`: an indent, in pixels;
      :param `rightSpacing`: a right spacing, only relevant when the style
       ``FPB_ALIGN_WIDTH`` is chosen.


   .. method:: ApplyCaptionStyle(self, cbstyle)

      Applies the style defined in `cbstyle` to the :class:`CaptionBar`.


   .. method:: Collapse(self)

      Internal method.
      
      This should not be called by the user, because it doesn't trigger the
      parent  to tell it that we are collapsed or expanded, it only changes
      visual state.


   .. method:: Expand(self)

      Internal method.
      
      This should not be called by the user, because it doesn't trigger the
      parent to tell it that we are collapsed or expanded, it only changes
      visual state.


   .. method:: GetCaptionLength(self)

      Returns height of caption only. This is for folding calculation purposes. 


   .. method:: GetCaptionStyle(self)

      Returns the current style of the captionbar in a :class:`CaptionBarStyle` class.
      
      This can be used to change and set back the changes.


   .. method:: GetItemPos(self)

      Returns item's position. 


   .. method:: GetPanelLength(self)

      Returns size of panel. 


   .. method:: IsExpanded(self)

      Returns expanded or collapsed status.  If the panel is
      expanded, ``True`` is returned.


   .. method:: IsVertical(self)

      Returns whether the :class:`CaptionBar` has default orientation or not.
      Default is vertical.


   .. method:: OnPaint(self, event)

      Handles the ``wx.EVT_PAINT`` event for :class:`FoldPanelItem`.
      
      :param `event`: a :class:`PaintEvent` event to be processed.


   .. method:: OnPressCaption(self, event)

      Handles the ``wx.EVT_CAPTIONBAR`` event for :class:`FoldPanelItem`.
      
      :param `event`: a :class:`CaptionBarEvent` event to be processed.


   .. method:: Reposition(self, pos)

      Repositions this :class:`FoldPanelItem` and reports the length occupied
      for the next :class:`FoldPanelItem` in the list.
      
      :param `pos`: the new item position.


   .. method:: ResizePanel(self)

      Resizes the panel.