File: wx.lib.filebrowsebutton.FileBrowseButtonWithHistory.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 (171 lines) | stat: -rw-r--r-- 7,207 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
.. 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.filebrowsebutton

.. highlight:: python



.. _wx.lib.filebrowsebutton.FileBrowseButtonWithHistory:

==========================================================================================================================================
|phoenix_title|  **wx.lib.filebrowsebutton.FileBrowseButtonWithHistory**
==========================================================================================================================================

with following additions:
    __init__(..., history=None)

        history -- optional list of paths for initial history drop-down
            (must be passed by name, not a positional argument)
            If history is callable it will must return a list used
            for the history drop-down

        changeCallback -- as for FileBrowseButton, but with a work-around
            for win32 systems which don't appear to create wx.EVT_COMBOBOX
            events properly.  There is a (slight) chance that this work-around
            will cause some systems to create two events for each Combobox
            selection. If you discover this condition, please report it!

        As for a FileBrowseButton.__init__ otherwise.

    GetHistoryControl()
        Return reference to the control which implements interfaces
        required for manipulating the history list.  See GetHistoryControl
        documentation for description of what that interface is.

    GetHistory()
        Return current history list

    SetHistory( value=(), selectionIndex = None )
        Set current history list, if selectionIndex is not None, select that index

    



|

|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>FileBrowseButtonWithHistory</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.filebrowsebutton.FileBrowseButtonWithHistory_inheritance.png" alt="Inheritance diagram of FileBrowseButtonWithHistory" 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="142,315,217,344"/> <area shape="rect" id="node7" href="wx.lib.filebrowsebutton.FileBrowseButton.html" title="wx.lib.filebrowsebutton.FileBrowseButton" alt="" coords="41,392,319,421"/> <area shape="rect" id="node2" href="wx.Window.html" title="wx.Window" alt="" coords="135,237,224,267"/> <area shape="rect" id="node3" href="wx.Trackable.html" title="wx.Trackable" alt="" coords="72,5,173,35"/> <area shape="rect" id="node4" href="wx.EvtHandler.html" title="wx.EvtHandler" alt="" coords="124,83,235,112"/> <area shape="rect" id="node8" href="wx.WindowBase.html" title="wx.WindowBase" alt="" coords="119,160,240,189"/> <area shape="rect" id="node5" href="wx.Object.html" title="wx.Object" alt="" coords="197,5,279,35"/> <area shape="rect" id="node6" href="wx.lib.filebrowsebutton.FileBrowseButtonWithHistory.html" title="wx.lib.filebrowsebutton.FileBrowseButtonWithHistory" alt="" coords="5,469,355,499"/> </map> 
   </p>

|


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

:class:`wx.lib.filebrowsebutton.FileBrowseButton`

|


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

================================================================================ ================================================================================
:meth:`~wx.lib.filebrowsebutton.FileBrowseButtonWithHistory.__init__`            
:meth:`~wx.lib.filebrowsebutton.FileBrowseButtonWithHistory.createTextControl`   Create the text control
:meth:`~wx.lib.filebrowsebutton.FileBrowseButtonWithHistory.GetHistory`          Return the current history list
:meth:`~wx.lib.filebrowsebutton.FileBrowseButtonWithHistory.GetHistoryControl`   Return a pointer to the control which provides (at least)
:meth:`~wx.lib.filebrowsebutton.FileBrowseButtonWithHistory.OnSetFocus`          When the history scroll is selected, update the history
:meth:`~wx.lib.filebrowsebutton.FileBrowseButtonWithHistory.SetHistory`          Set the current history list
================================================================================ ================================================================================


|


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


.. class:: FileBrowseButtonWithHistory( FileBrowseButton )

   with following additions:
       __init__(..., history=None)
   
           history -- optional list of paths for initial history drop-down
               (must be passed by name, not a positional argument)
               If history is callable it will must return a list used
               for the history drop-down
   
           changeCallback -- as for FileBrowseButton, but with a work-around
               for win32 systems which don't appear to create wx.EVT_COMBOBOX
               events properly.  There is a (slight) chance that this work-around
               will cause some systems to create two events for each Combobox
               selection. If you discover this condition, please report it!
   
           As for a FileBrowseButton.__init__ otherwise.
   
       GetHistoryControl()
           Return reference to the control which implements interfaces
           required for manipulating the history list.  See GetHistoryControl
           documentation for description of what that interface is.
   
       GetHistory()
           Return current history list
   
       SetHistory( value=(), selectionIndex = None )
           Set current history list, if selectionIndex is not None, select that index
   
       

   .. method:: __init__( self, \*arguments, \*\*namedarguments)


   .. method:: createTextControl( self)

      Create the text control


   .. method:: GetHistory( self )

      Return the current history list


   .. method:: GetHistoryControl( self )

      Return a pointer to the control which provides (at least)
      the following methods for manipulating the history list:
      
          Append( item ) -- add item
          Clear() -- clear all items
          Delete( index ) -- 0-based index to delete from list
          SetSelection( index ) -- 0-based index to select in list
      
      Semantics of the methods follow those for the wxComboBox control


   .. method:: OnSetFocus(self, event)

      When the history scroll is selected, update the history


   .. method:: SetHistory( self, value=(), selectionIndex = None, control=None )

      Set the current history list