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
|
.. 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
.. _wx.ClipboardTextEvent:
==========================================================================================================================================
|phoenix_title| **wx.ClipboardTextEvent**
==========================================================================================================================================
This class represents the events generated by a control (typically a :ref:`wx.TextCtrl` but other windows can generate these events as well) when its content gets copied or cut to, or pasted from the clipboard.
There are three types of corresponding events ``wxEVT_TEXT_COPY`` , ``wxEVT_TEXT_CUT`` and ``wxEVT_TEXT_PASTE`` .
If any of these events is processed (without being skipped) by an event handler, the corresponding operation doesn't take place which allows to prevent the text from being copied from or pasted to a control. It is also possible to examine the clipboard contents in the ``PASTE`` event handler and transform it in some way before inserting in a control
Finally notice that a ``CUT`` event is always preceded by the ``wx.COPY`` event which makes it possible to only process the latter if it doesn't matter if the text was copied or cut.
.. _ClipboardTextEvent-events:
|events| Events Emitted by this Class
=====================================
Handlers bound for the following event types will receive a :ref:`wx.ClipboardTextEvent` parameter.
Event macros:
- EVT_TEXT_COPY: Some or all of the controls content was copied to the clipboard.
- EVT_TEXT_CUT: Some or all of the controls content was cut (i.e. copied and deleted).
- EVT_TEXT_PASTE: Clipboard content was pasted into the control.
.. note::
These events are currently only generated by :ref:`wx.TextCtrl` in wxGTK and wxOSX but are also generated by :ref:`wx.ComboBox` without ``wx.CB_READONLY`` style in wxMSW.
.. seealso:: :ref:`wx.Clipboard`
|
|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>ClipboardTextEvent</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.ClipboardTextEvent_inheritance.png" alt="Inheritance diagram of ClipboardTextEvent" 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.Event.html" title="wx.Event" alt="" coords="47,83,125,112"/> <area shape="rect" id="node3" href="wx.CommandEvent.html" title="wx.CommandEvent" alt="" coords="14,160,159,189"/> <area shape="rect" id="node2" href="wx.Object.html" title="wx.Object" alt="" coords="45,5,127,35"/> <area shape="rect" id="node4" href="wx.ClipboardTextEvent.html" title="wx.ClipboardTextEvent" alt="" coords="5,237,168,267"/> </map>
</p>
|
|method_summary| Methods Summary
================================
================================================================================ ================================================================================
:meth:`~wx.ClipboardTextEvent.__init__` Constructor.
================================================================================ ================================================================================
|
|api| Class API
===============
.. class:: wx.ClipboardTextEvent(CommandEvent)
**Possible constructors**::
ClipboardTextEvent(commandType=wxEVT_NULL, id=0)
This class represents the events generated by a control (typically a
TextCtrl but other windows can generate these events as well) when
its content gets copied or cut to, or pasted from the clipboard.
.. method:: __init__(self, commandType=wxEVT_NULL, id=0)
Constructor.
:param `commandType`:
:type `commandType`: wx.EventType
:param `id`:
:type `id`: int
|
