Salome HOME
Redesign SALOME documentation
[modules/gui.git] / doc / salome / gui / locale / fr / LC_MESSAGES / drag_and_drop.po
1 # SOME DESCRIPTIVE TITLE.
2 # Copyright (C)
3 # This file is distributed under the same license as the GUI package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, 2017.
5 #
6 #, fuzzy
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: GUI 8.4.0\n"
10 "Report-Msgid-Bugs-To: \n"
11 "POT-Creation-Date: 2017-12-14 15:16+0300\n"
12 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
13 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
14 "Language-Team: LANGUAGE <LL@li.org>\n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=utf-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18 "Generated-By: Babel 2.0\n"
19
20 # 9200d6a2d1844c9481302767e7661566
21 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:5
22 msgid "Implementing Drag and Drop functionality in SALOME module"
23 msgstr ""
24
25 # b9c1f0ead041494ebf746296d4668aa4
26 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:0
27 msgid "Table of Contents"
28 msgstr ""
29
30 # d3f4d8edbcea4ad8bcbf33ccd91e48a6
31 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:9
32 msgid ""
33 "**Drag and Drop** provides a simple visual mechanism to transfer "
34 "information between and within applications."
35 msgstr ""
36
37 # ecb0ca211c3c4bf69244e773643da3d4
38 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:12
39 msgid ""
40 "In some aspects Drag and drop operates similarly to the clipboard "
41 "copy/cut/paste mechanism."
42 msgstr ""
43
44 # 69fe06b44d4744dea55a3b93ad4581c0
45 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:15
46 msgid ""
47 "Since SALOME GUI is implemented on Qt, the drag and drop functionality "
48 "support is provided by means of the corresponding Qt mechanisms."
49 msgstr ""
50
51 # ca821ed8f6f740349bc7ac1f7da0316e
52 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:18
53 msgid ""
54 "Currently dragging and dropping of the items can be done within Object "
55 "browser only, however this functionality can be extended to other GUI "
56 "elements as well."
57 msgstr ""
58
59 # ad2feb0b721e4e09a4ccc300e4c23a78
60 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:24
61 msgid "Enabling drag and drop in SALOME module"
62 msgstr ""
63
64 # cd261b7b6164434193df4d9b53872acd
65 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:26
66 msgid ""
67 "The Drag and drop functionality is enabled by default in the Object "
68 "browser. However, to allow dragging of a data object or dropping data on "
69 "it, it is necessary to redefine **isDraggable()** and "
70 "**isDropAccepted()** methods of the corresponding class, a successor of "
71 "the **SUIT_DataObject**. These methods are defined in the base class "
72 "**SUIT_DataObject** and default implementation of both functions returns "
73 "**false**, which prevents dragging and dropping:"
74 msgstr ""
75
76 # 36fda16fb1274be1b22c0615dec21862
77 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:45
78 msgid ""
79 "If your data model is based on the **SUIT_DataObject** and "
80 "**SUIT_TreeModel**, just re-implement these functions in your successor "
81 "data object class and return **true** when it is needed (for example, "
82 "depending on the data object type, state, etc)."
83 msgstr ""
84
85 # 09b5c44e19e5480892ee2531656bfecb
86 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:49
87 msgid ""
88 "Another alternative is available if your module is directly inherited "
89 "from **LightApp_Module** or **SalomeApp_Module** class (as the majority "
90 "of existing SALOME modules). The class **LightApp_Module** (and thus "
91 "**SalomeApp_Module** also) already provides high-level API that can be "
92 "used for enabling drag and drop functionality."
93 msgstr ""
94
95 # 03e22c0bffef45798f6db41024442b63
96 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:54
97 msgid ""
98 "To enable dragging, redefine **isDraggable()** method of your module "
99 "class. In this method you can analyze the data object subject to the drag"
100 " operation and decide if it is necessary to enable or prevent its "
101 "dragging:"
102 msgstr ""
103
104 # 7b0b499d1be04f09b345b1f4dc41c1f2
105 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:71
106 msgid ""
107 "Note, that you should not invoke here method **isDragEnabled()** of your "
108 "data object class (in case if it inherits **LightApp_DataObject** or "
109 "**SalomeApp_DataObject**), unless you redefine methods **isDraggable()** "
110 "and **isDropAccepted()** in your data object class. The reason is that "
111 "the implementation of these methods in **LightApp_DataObject** class "
112 "redirects calls to the **LightApp_Module** - be careful to avoid entering"
113 " endless recursion loop."
114 msgstr ""
115
116 # d1ad6f043a0644baab90c8263486b29b
117 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:78
118 msgid ""
119 "To allow data dropping to an object (the object under the mouse cursor in"
120 " the Object browser during the drag operation) redefine "
121 "**isDropAccepted()** method of your module class:"
122 msgstr ""
123
124 # b0a027ba1eb0472c85de792798b6b3ae
125 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:95
126 msgid ""
127 "The caution about avoiding recursive loop mentioned above is also valid "
128 "for **isDropAccepted()** method."
129 msgstr ""
130
131 # dd17374552fa4090b7c523afe1003891
132 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:101
133 msgid "Handling data dropping"
134 msgstr ""
135
136 # 6ef963370b9b425b85518b84a0779bf1
137 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:103
138 msgid ""
139 "When dragging operation is completed (the data is dropped to an object) "
140 "the module owning the item on which the data is dropped is notified by "
141 "invoking its **dropObjects()** method:"
142 msgstr ""
143
144 # 8030f81706f045198257acf181a5e82b
145 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:115
146 msgid ""
147 "The default implementation does nothing. However, this method can be "
148 "redifined in the successor class and handle the operation properly. The "
149 "list of dropped data objects is passed via **what** parameter. The data "
150 "object on which the data is dropped is passed via **where** parameter. "
151 "The parameter **row** specifies in the children list the position of "
152 "object where data is dropped; if this parameter is equal to -1, the data "
153 "is dropped to the end of the children list. Performed drop action is "
154 "passed via **action** parameter; possible values are **Qt::CopyAction** "
155 "and **Qt::MoveAction** (other actions are currently unsupported)."
156 msgstr ""
157
158 # b7d1e488938b44898da6a1055ae1689b
159 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:124
160 msgid ""
161 "The method **dropObjects()** should analyze the parameters and apply the "
162 "corresponding actions for rearrangement of the data tree, copying or "
163 "moving the data items depending on the operation performed. For example:"
164 msgstr ""
165
166 # bedf284048f746cb831166b8a3c39df2
167 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:155
168 msgid ""
169 "In the above code the function **copyOrMove()** performs actual data tree"
170 " rearrangement."
171 msgstr ""
172
173 # 3cd2ffe9e3ac46e7ba0bcdcf4fa3bcc2
174 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:161
175 msgid "Drag and Drop in \"light\" modules"
176 msgstr ""
177
178 # 94e7ece95ee04d38bdf6b7ac0f17cfc0
179 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:163
180 msgid ""
181 "The data model of the **light** (not having CORBA engine) SALOME module "
182 "is usually based on the custom tree of data objects. The general approach"
183 " is to inherit a custom data object class from the "
184 "**LightApp_DataObject** and a custom data model from the "
185 "**LightApp_DataModel** class. The data model class is responsible for "
186 "building the appropriate presentation of the data tree in the Object "
187 "browser."
188 msgstr ""
189
190 # ca44d8e18ff94f42b2846cc60f67d477
191 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:170
192 msgid ""
193 "Thus, the implementation of the drag and drop functionality in a "
194 "**light** module (more precisely, the method **dropObjects()** as "
195 "described above), consists in copying data entities (by creating new "
196 "instances of the corresponding data object class) or moving existing data"
197 " objects to the new position in a tree. The Object browser will update "
198 "the tree representation automatically, as soon as "
199 "**updateObjectBrowser()** function is called."
200 msgstr ""
201
202 # 1d318a4887a34b2cbb7e12001811d719
203 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:180
204 msgid "Using UseCaseBuilder for Drag and Drop handling in \"full\" modules"
205 msgstr ""
206
207 # fdfc12e87b64442d9425ea353db7d2d7
208 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:182
209 msgid ""
210 "Drag and drop operation requires underlying data model to allow flexible "
211 "re-arrangement of the data entities inside the data tree. In a **full** "
212 "(CORBA engine based) SALOME module, which data model is usually based on "
213 "the hierarchy of **SALOMEDS::SObject** entities provided by the data "
214 "server functionality, re-arrangement of the data tree is not a trivial "
215 "task."
216 msgstr ""
217
218 # 1f82a0376c4043bda778a3c0447d7ee5
219 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:188
220 msgid ""
221 "However, SALOME data server (**SALOMEDS**) CORBA module proposes a "
222 "mechanism that can be used to customize data tree representation in a "
223 "simple and flexible way - :ref:`use_case_builder`."
224 msgstr ""
225
226 # 80f9647465a6412d91ea0ef85855913b
227 #: ../../../../../../SRC/GUI_SRC/doc/salome/gui/input/drag_and_drop.rst:192
228 msgid ""
229 "With use case builder, the **dropObjects()** function can be easily "
230 "implemented. For example:"
231 msgstr ""
232