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
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
|
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<!--
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
-->
<meta>
<topic id="textshared0201170000xml" indexer="include">
<title id="tit" xml-lang="en-US">Form Controls</title>
<filename>/text/shared/02/01170000.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3154142"><bookmark_value>form controls;toolbars</bookmark_value>
<bookmark_value>inserting; form fields</bookmark_value>
<bookmark_value>form fields</bookmark_value>
<bookmark_value>command button creation</bookmark_value>
<bookmark_value>buttons; form functions</bookmark_value>
<bookmark_value>controls; inserting</bookmark_value>
<bookmark_value>push buttons;creating</bookmark_value>
<bookmark_value>radio button creation</bookmark_value>
<bookmark_value>check box creation</bookmark_value>
<bookmark_value>labels; form functions</bookmark_value>
<bookmark_value>fixed text; form functions</bookmark_value>
<bookmark_value>text boxes;form functions</bookmark_value>
<bookmark_value>list box creation</bookmark_value>
<bookmark_value>picklist creation</bookmark_value>
<bookmark_value>drop-down lists in form functions</bookmark_value>
<bookmark_value>combo box creation</bookmark_value>
<bookmark_value>selecting;controls</bookmark_value>
<bookmark_value>controls; select mode</bookmark_value>
</bookmark><comment>MW deleted "option field creation", changed "option button" to "push button" and "selections;" to "selecting;"</comment>
<bookmark xml-lang="en-US" branch="hid/.uno:Config" id="bm_id4029443" localize="false"/>
<section id="form_controls">
<h1 id="hd_id3154142"><link href="text/shared/02/01170000.xhp" name="Form Controls">Form Controls</link></h1>
<paragraph role="paragraph" id="par_id3151378" xml-lang="en-US"><variable id="formulartext"><ahelp hid=".uno:Config">The <emph>Form Controls</emph> toolbar or sub-menu contains tools that you need to create an interactive form.</ahelp></variable> You can use the toolbar or sub-menu to add controls to a form in a text, drawing, spreadsheet, presentation, or HTML document, for example a button that runs a macro.</paragraph>
</section>
<section id="howtoget">
<paragraph role="paragraph" id="par_id1027200809391346" xml-lang="en-US">Choose <menuitem>View - Toolbars - Form Controls</menuitem>.</paragraph>
<paragraph role="paragraph" id="par_id3147336" xml-lang="en-US">Icon on the <emph>Insert</emph> toolbar (you may need to enable this initially invisible icon):</paragraph>
<section id="syform_controls">
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3155341" xml-lang="en-US"><image id="img_id3150943" src="cmd/lc_choosecontrols.svg" width="1cm" height="1cm"><alt id="alt_id3150943" xml-lang="en-US">Icon Select</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US">Form Controls</paragraph>
</tablecell>
</tablerow>
</table>
</section>
</section>
<note id="par_idN10B21" xml-lang="en-US"><link href="text/shared/guide/xforms.xhp">XML Form documents</link> (XForms) use the same controls.</note>
<paragraph role="paragraph" id="par_id3152771" xml-lang="en-US">To create a form, open a document and use the Form Controls toolbar to add and define the form controls. If you want, you can also link the form to a database, so that you can use the controls to manipulate a database.</paragraph>
<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US">When you create a form in an HTML document, you can use the form to send data over the Internet.</paragraph>
<h2 id="par_idN10C39" xml-lang="en-US">To add a control to a document</h2>
<list type="ordered">
<listitem>
<paragraph role="paragraph" id="par_id3154918" xml-lang="en-US">On the <emph>Form Controls</emph> toolbar, click the icon of the control that you want to add.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_idN10C4D" xml-lang="en-US">Then click in the document, and drag to create the control.</paragraph>
<tip id="par_idN10C50" xml-lang="en-US">To create a square control, hold down the <keycode>Shift</keycode> key while you drag.</tip>
</listitem>
</list>
<tip id="par_id3154127" xml-lang="en-US">To add a field from the field list of a table or query to a form, drag a cell into the form. In a text document, you can also drag a column header to add a field to a form. To include a label for the field, hold down <switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline>+<keycode>Shift</keycode> when you drag a column head.</tip>
<h2 id="par_idN10C87" xml-lang="en-US">Modifying a Control</h2>
<list type="ordered">
<listitem>
<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US">Right-click the control and choose <menuitem>Control Properties</menuitem>. A dialog opens where you can define the properties of the control.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id3153363" xml-lang="en-US">To specify a accelerator key for a control, add a tilde (<emph>~</emph>) in front of the character in the label for the control.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id3152792" xml-lang="en-US">You can drag and drop controls from one document to another document. You can also copy and paste controls between documents. When you insert a control from another document, $[officename] analyzes the data source, content type, and content properties of the control so that the control fits the logical structure in the target document. For example, a control that displays contents from an address book continues to display the same contents after you copy the control to a different document. You can view these properties on the <emph>Data</emph> tab page of the <emph>Form properties</emph> dialog.</paragraph>
</listitem>
</list>
<section id="select">
<h2 id="hd_id3154411" xml-lang="en-US">Select<comment>controls and design bars</comment></h2>
<table id="tb_13945534">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3156106" xml-lang="en-US"><image id="img_id3153516" src="cmd/lc_selectobject.svg" width="1cm" height="1cm"><alt id="alt_id3153516" xml-lang="en-US">Icon Select</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3150470" xml-lang="en-US">This icon switches the mouse pointer to the select mode, or deactivates this mode. The select mode is used to select the controls of the current form.</paragraph>
</tablecell>
</tablerow>
</table>
<embed href="text/shared/02/01170500.xhp#designmodus"/>
<embed href="text/shared/00/00040501.xhp#sydesign"/>
<!--
<embed href="text/shared/02/01170100.xhp#control"/>
<embed href="text/shared/00/00040501.xhp#sycontrol_properties"/>
<embed href="text/shared/02/01170200.xhp#form_properties"/>
<embed href="text/shared/00/00040501.xhp#syform_properties"/>
-->
</section>
<section id="Section25">
<h2 id="par_idN11B57">Wizards On/Off<comment>Controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_idN11B65" xml-lang="en-US"><image id="img_id6128727" src="cmd/lc_usewizards.png" width="1cm" height="1cm"><alt id="alt_id6128727" xml-lang="en-US">Icon Toggle Form Control Wizards</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_idN11B76" xml-lang="en-US">Turns on and turns off the automatic form controls wizards.</paragraph>
<paragraph role="paragraph" id="par_id6403088" xml-lang="en-US">These wizards help you to enter the properties of list boxes, table controls, and other controls.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<bookmark xml-lang="en-US" branch="hid/.uno:FormDesignTools" id="bm_id6078501" localize="false"/>
<h2 id="par_idN10CF7">Form Design<comment>Controls bar</comment></h2>
<table id="tab_id651646965582972">
<tablerow>
<tablecell>
<paragraph id="par_id671646965582973" role="paragraph">
<image src="cmd/lc_formdesigntools.svg" id="img_id1001646965582975" width="1cm" height="1cm"><alt xml-lang="en-US" id="alt_id641646965582976">Icon Form Design Tools</alt></image>
</paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_idN10D0D" xml-lang="en-US"><ahelp hid=".">Opens the <link href="text/shared/main0226.xhp"><emph>Form Design</emph></link> toolbar.</ahelp></paragraph>
</tablecell>
</tablerow>
</table>
<section id="labelfield">
<bookmark xml-lang="en-US" branch="hid/.uno:Label" id="bm_id7047484" localize="false"/>
<h2 id="hd_id3145618">Label Field<comment>controls bar</comment></h2>
<table id="tbl_id3156712">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3145295" xml-lang="en-US"><image id="img_id3151017" src="cmd/sc_insertfixedtext.png" width="1cm" height="1cm"><alt id="alt_id3151017" xml-lang="en-US">Icon Label Field</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3148534" xml-lang="en-US"><ahelp hid=".uno:Label">Creates a field for displaying text.</ahelp> These labels are only for displaying predefined text. Entries cannot be made in these fields.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="textbox">
<bookmark xml-lang="en-US" branch="hid/.uno:Edit" id="bm_id7355178" localize="false"/>
<h2 id="hd_id3153794" xml-lang="en-US">Text Box<comment>controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3163665" xml-lang="en-US"><image id="img_id3153266" src="cmd/lc_edit.svg" width="1cm" height="1cm"><alt id="alt_id3153266" xml-lang="en-US">Icon Text Box</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3158444" xml-lang="en-US"><ahelp hid=".uno:Edit">Creates a text box.</ahelp> Text boxes are fields in which the user can enter text. In a form, text boxes display data or allow for new data input.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="checkbox">
<bookmark xml-lang="en-US" branch="hid/.uno:Checkbox" id="bm_id8176164" localize="false"/>
<h2 id="hd_id3146914" xml-lang="en-US">Check Box<comment>controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3148483" xml-lang="en-US"><image id="img_id3156380" src="cmd/lc_checkbox.svg" width="1cm" height="1cm"><alt id="alt_id3156380" xml-lang="en-US">Icon Check Box</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3153927" xml-lang="en-US"><ahelp hid=".uno:CheckBox">Creates a check box.</ahelp> Check boxes allow you to activate or deactivate a function in a form.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="optionbutton">
<bookmark xml-lang="en-US" branch="hid/.uno:Radiobutton" id="bm_id3862451" localize="false"/>
<h2 id="hd_id3157844">Option Button<comment>controls bar</comment></h2>
<table id="tbl_id3151318">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3152971" xml-lang="en-US"><image id="img_id3152999" src="cmd/lc_radiobutton.svg" width="1cm" height="1cm"><alt id="alt_id3152999" xml-lang="en-US">Icon Option Button</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3149123" xml-lang="en-US"><ahelp hid=".uno:RadioButton">Creates an option button.</ahelp> Option buttons enable the user to choose one of several options. Option buttons with the same functionality are given the same name (<link href="text/shared/02/01170101.xhp" name="Name"><emph>Name</emph></link> <emph>property</emph>). Normally, they are given a <link href="text/shared/02/01170000.xhp" name="group box">group box</link>.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="listbox">
<bookmark xml-lang="en-US" branch="hid/.uno:ListBox" id="bm_id7238352" localize="false"/>
<h2 id="hd_id3156064">List Box<comment>controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3154326" xml-lang="en-US"><image id="img_id3154135" src="cmd/lc_listbox.svg" width="1cm" height="1cm"><alt id="alt_id3154135" xml-lang="en-US">Icon List Box</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3166428" xml-lang="en-US"><ahelp hid=".uno:ListBox">Creates a list box.</ahelp> A list box lets users select an entry from a list. If the form is linked to a database and the database connection is active, the <link href="text/shared/02/01170900.xhp" name="List Box Wizard"><emph>List Box Wizard</emph></link> will automatically appear after the list box is inserted in the document. This wizard helps you create the list box.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="combobox">
<bookmark xml-lang="en-US" branch="hid/.uno:Combobox" id="bm_id5504530" localize="false"/>
<h2 id="hd_id3147171">Combo Box<comment>controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3149981" xml-lang="en-US"><image id="img_id3148817" src="cmd/lc_combobox.svg" width="1cm" height="1cm"><alt id="alt_id3148817" xml-lang="en-US">Icon Combo Box</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3149407" xml-lang="en-US"><ahelp hid=".uno:ComboBox">Creates a combo box.</ahelp> A combo box is a single-line list box with a drop-down list from which users choose an option. You can assign the "read-only" property to the combo box so that users cannot enter other entries than those found in the list. If the form is bound to a database and the database connection is active, the <link href="text/shared/02/01170900.xhp" name="Combo Box Wizard"><emph>Combo Box Wizard</emph></link> will automatically appear after you insert the combo box in the document.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="pushbutton">
<bookmark xml-lang="en-US" branch="hid/.uno:Pushbutton" id="bm_id6486131" localize="false"/>
<h2 id="hd_id3148774">Push Button<comment>controls bar</comment></h2>
<table id="tbl_id3154501">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3145801" xml-lang="en-US"><image id="img_id3151073" src="cmd/sc_pushbutton.svg" width="1cm" height="1cm"><alt id="alt_id3151073" xml-lang="en-US">Icon Push Button</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3147046" xml-lang="en-US"><ahelp hid=".uno:Pushbutton">Creates a push button.</ahelp> This function can be used to execute a command for a defined event, such as a mouse click.</paragraph>
<paragraph role="paragraph" id="par_id3154731" xml-lang="en-US">You can apply text and graphics to these buttons.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="imagebutton">
<bookmark xml-lang="en-US" branch="hid/.uno:Imagebutton" id="bm_id2102401" localize="false"/>
<h2 id="hd_id3153316">Image Button<comment>more controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3159622" xml-lang="en-US"><image id="img_id3154378" src="cmd/lc_imagebutton.svg" width="1cm" height="1cm"><alt id="alt_id3154378" xml-lang="en-US">Icon image button</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3148601" xml-lang="en-US"><ahelp hid=".uno:Imagebutton">Creates a button displayed as an image.</ahelp> Aside from the graphic representation, an image button has the same properties as a "normal" button.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="formattedfield">
<bookmark xml-lang="en-US" branch="hid/.uno:FormattedField" id="bm_id6606960" localize="false"/>
<h2 id="hd_id3151218" xml-lang="en-US">Formatted Field<comment>controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3154836" xml-lang="en-US"><image id="img_id3143277" src="cmd/lc_formattedfield.svg" width="1cm" height="1cm"><alt id="alt_id3143277" xml-lang="en-US">Icon Formatted Field</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3147547" xml-lang="en-US"><ahelp hid=".uno:FormattedField">Creates a formatted field.</ahelp> A formatted field is a text box in which you can define how the inputs and outputs are formatted, and which limiting values apply.</paragraph>
<paragraph role="paragraph" id="par_id3155346" xml-lang="en-US">A formatted field has <link href="text/shared/02/01170002.xhp" name="special control properties">special control properties</link> (choose <emph>Format - Control</emph>).</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="Section10">
<bookmark xml-lang="en-US" branch="hid/.uno:DateField" id="bm_id4810502" localize="false"/>
<h2 id="hd_id3156040">Date Field<comment>more controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3149423" xml-lang="en-US"><image id="img_id3150096" src="cmd/lc_datefield.svg" width="1cm" height="1cm"><alt id="alt_id3150096" xml-lang="en-US">Icon Date Field</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3151312" xml-lang="en-US"><ahelp hid=".uno:DateField">Creates a date field.</ahelp> If the form is linked to a database, the date values can be adopted from the database.</paragraph>
<paragraph role="paragraph" id="par_id3151302" xml-lang="en-US">If you assign the "Dropdown" property to the date field, the user can open a calendar to select a date under the date field. This also applies to a date field within a <emph>Table Control</emph> field.</paragraph>
<tip id="par_id3154395" xml-lang="en-US">Date fields can be easily edited by the user with the up arrow and down arrow keys. Depending on the cursor position, the day, month, or the year is can be increased or decreased using the arrow keys.</tip>
<paragraph role="paragraph" id="par_id3153112" xml-lang="en-US"><link href="text/shared/02/01170003.xhp" name="Specific Remarks on Date Fields">Specific Remarks on Date Fields</link>.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="Section8">
<bookmark xml-lang="en-US" branch="hid/.uno:NumericField" id="bm_id3301501" localize="false"/>
<h2 id="hd_id3154652">Numerical Field<comment>more controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3149396" xml-lang="en-US"><image id="img_id3153012" src="cmd/lc_insertnumericfield.png" width="1cm" height="1cm"><alt id="alt_id3153012" xml-lang="en-US">Icon Numerical Field</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3145601" xml-lang="en-US"><ahelp hid=".uno:NumericField">Creates a numerical field.</ahelp> If the form is linked to a database, the numerical values in the form can be adopted from the database.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="groupbox">
<bookmark xml-lang="en-US" branch="hid/.uno:Groupbox" id="bm_id3430892" localize="false"/>
<h2 id="hd_id3145147">Group Box<comment>more controls bar</comment></h2>
<table id="tbl_id3154020">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3159334" xml-lang="en-US"><image id="img_id3153790" src="cmd/lc_groupbox.svg" width="1cm" height="1cm"><alt id="alt_id3153790" xml-lang="en-US">Icon Group Box</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3154572" xml-lang="en-US"><ahelp hid=".uno:GroupBox">Creates a frame to visually group several controls.</ahelp> <emph>Group boxes</emph> allow you to group option buttons in a frame.</paragraph>
<paragraph role="paragraph" id="par_id3148394" xml-lang="en-US">If you insert a group frame into the document, the <link href="text/shared/autopi/01120000.xhp" name="Group Element Wizard"><emph>Group Element Wizard</emph></link> starts, which allows you to easily create an option group.</paragraph>
<paragraph role="paragraph" id="par_id3150567" xml-lang="en-US"><emph>Note:</emph> When you drag a group box over already existing controls and then want to select a control, you have to first open the context menu of the group box and choose <emph>Arrange - Send to Back</emph>. Then select the control while pressing <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline>.</paragraph>
<note id="par_id3145615"><emph>Group boxes</emph> are used only for a visual effect. A functional grouping of option fields can be made through the name definition: under the <link href="text/shared/02/01170101.xhp" name="Name"><emph>Name</emph></link> properties of all option fields, enter the same name in order to group them.</note>
</tablecell>
</tablerow>
</table>
</section>
<section id="Section9">
<bookmark xml-lang="en-US" branch="hid/.uno:TimeField" id="bm_id4739584" localize="false"/>
<h2 id="hd_id3152369">Time Field<comment>more controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3153687" xml-lang="en-US"><image id="img_id3155949" src="cmd/lc_timefield.svg" width="1cm" height="1cm"><alt id="alt_id3155949" xml-lang="en-US">Icon Time Field</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3155399" xml-lang="en-US"><ahelp hid=".uno:TimeField">Creates a time field.</ahelp> If the form is linked to a database, the time values for the form can be adopted from the database.</paragraph>
<tip id="par_id3154764" xml-lang="en-US">Time fields can be easily edited by the user with the up and down arrow keys. Depending on the cursor position, the hours, minutes, or the seconds are increased or decreased using the arrow keys.</tip>
</tablecell>
</tablerow>
</table>
</section>
<section id="Section6">
<bookmark xml-lang="en-US" branch="hid/.uno:CurrencyField" id="bm_id9766539" localize="false"/>
<h2 id="hd_id3153612">Currency Field<comment>more controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3145324" xml-lang="en-US"><image id="img_id3152866" src="cmd/lc_currencyfield.svg" width="1cm" height="1cm"><alt id="alt_id3152866" xml-lang="en-US">Icon Currency Field</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3145115" xml-lang="en-US"><ahelp hid=".uno:CurrencyField">Creates a currency field.</ahelp> If the form is linked to a database, the currency field contents for in the form can be adopted from the database.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="Section5">
<bookmark xml-lang="en-US" branch="hid/.uno:PatternField" id="bm_id1317017" localize="false"/>
<h2 id="hd_id3148825">Pattern Field<comment>more controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3149742" xml-lang="en-US"><image id="img_id3148924" src="cmd/lc_insertpatternfield.png" width="1cm" height="1cm"><alt id="alt_id3148924" xml-lang="en-US">Icon Pattern Field</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3150122" xml-lang="en-US"><ahelp hid=".uno:PatternField">Creates a pattern field.</ahelp> Pattern fields consist of an edit mask and a literal mask. The edit mask determines which data can be entered. The literal mask determines the contents of the pattern field when loading the form.</paragraph>
<note id="par_id3152947">Please note that pattern fields are not exported into HTML format.</note>
</tablecell>
</tablerow>
</table>
</section>
<section id="tablecontrol">
<bookmark xml-lang="en-US" branch="hid/.uno:Grid" id="bm_id74623" localize="false"/>
<h2 id="hd_id3157996">Table Control<comment>more controls bar</comment></h2>
<table id="tbl_id3153023">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3156402" xml-lang="en-US"><image id="img_id3146324" src="cmd/lc_grid.png" width="1cm" height="1cm"><alt id="alt_id3146324" xml-lang="en-US">Icon Table Control</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3154579" xml-lang="en-US"><ahelp hid=".">Creates a <emph>table control</emph> to display a database table.</ahelp> If you create a new table control, the <link href="text/shared/02/01170800.xhp" name="Table Element Wizard"><emph>Table Element Wizard</emph></link> appears.</paragraph>
<paragraph role="paragraph" id="par_id3154697" xml-lang="en-US"><link href="text/shared/02/01170004.xhp" name="Special Information about Table Controls">Special information about Table Controls</link>.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="navigationbar">
<bookmark xml-lang="en-US" branch="hid/.uno:NavigationBar" id="bm_id8951689" localize="false"/>
<h2 id="par_idN11B1E">Navigation bar<comment>more controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_idN11B2C" xml-lang="en-US"><image id="img_id5074922" src="cmd/lc_navigationbar.svg" width="1cm" height="1cm"><alt id="alt_id5074922" xml-lang="en-US">Icon Navigation bar</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_idN11B3D" xml-lang="en-US"><ahelp hid=".">Creates a <emph>Navigation</emph> bar.</ahelp></paragraph>
</tablecell>
</tablerow>
</table>
<paragraph role="paragraph" id="par_idN11DB1" xml-lang="en-US">The <emph>Navigation</emph> bar allows you to move through the records of a database or a database form. The controls on this <emph>Navigation</emph> bar work the same way as the controls on the default <link href="text/shared/main0213.xhp"><emph>Navigation</emph> bar</link> in $[officename].</paragraph>
</section>
<section id="imagecontrol">
<bookmark xml-lang="en-US" branch="hid/.uno:ImageControl" id="bm_id7383386" localize="false"/>
<h2 id="hd_id3159171">Image Control<comment>more controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3155869" xml-lang="en-US"><image id="img_id3152381" src="cmd/lc_objectcatalog.svg" width="1cm" height="1cm"><alt id="alt_id3152381" xml-lang="en-US">Icon Image Control</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3149596" xml-lang="en-US"><ahelp hid=".uno:ImageControl">Creates an image control. It can only be used to add images from a database.</ahelp> In the form document, double-click one of these controls to open the <emph>Insert Graphic</emph> dialog to insert the image. There is also a context menu (not in design mode) with commands for inserting and deleting the image.</paragraph>
<paragraph role="paragraph" id="par_id3150318" xml-lang="en-US">Images from a database can be displayed in a form, and new images can be inserted in the database as long as the image control is not write-protected. The control must refer to a database field of the image type. Therefore, enter the data field into the properties window on the <emph>Data</emph> tab page.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="fileselection">
<bookmark xml-lang="en-US" branch="hid/.uno:FileControl" id="bm_id1460134" localize="false"/>
<h2 id="hd_id3156186">File Selection<comment>more controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_id3150531" xml-lang="en-US"><image id="img_id3154344" src="cmd/lc_filecontrol.svg" width="1cm" height="1cm"><alt id="alt_id3154344" xml-lang="en-US">Icon File Selection</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_id3149438" xml-lang="en-US"><ahelp hid=".uno:FileControl">Creates a button that enables file selection.</ahelp></paragraph>
</tablecell>
</tablerow>
</table>
</section>
<section id="Section22">
<bookmark xml-lang="en-US" branch="hid/.uno:Spinbutton" id="bm_id8342120" localize="false"/>
<h2 id="par_idN11A56">Spin Button<comment>more controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_idN11A64" xml-lang="en-US"><image id="img_id7816400" src="cmd/lc_spinbutton.svg" width="1cm" height="1cm"><alt id="alt_id7816400" xml-lang="en-US">Icon Spin Button</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_idN11A75" xml-lang="en-US"><ahelp hid=".uno:SpinButton">Creates a spin button.</ahelp></paragraph>
</tablecell>
</tablerow>
</table>
<paragraph role="paragraph" id="par_id710776" xml-lang="en-US">If you add a spin button to a Calc spreadsheet, you can use the Data tab page to create a two-way link between the spin button and a cell. As a result, when you change the contents of a cell, the contents of the spin button are updated. Conversely, if you change the value of the spin button, the contents of the cell are updated.<comment>UFI: see spec doc spinbutton_form_control.sxw</comment></paragraph>
</section>
<section id="Section23">
<bookmark xml-lang="en-US" branch="hid/.uno:ScrollBar" id="bm_id633802" localize="false"/>
<h2 id="par_idN11ABC">Scrollbar<comment>more controls bar</comment></h2>
<table id="">
<tablerow>
<tablecell>
<paragraph role="paragraph" id="par_idN11ACA" xml-lang="en-US"><image id="img_id8203985" src="cmd/lc_scrollbar.svg" width="1cm" height="1cm"><alt id="alt_id8203985" xml-lang="en-US">Icon Scrollbar</alt></image></paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" id="par_idN11ADB" xml-lang="en-US"><ahelp hid=".uno:ScrollBar">Creates a scrollbar.</ahelp></paragraph>
</tablecell>
</tablerow>
</table>
<paragraph role="paragraph" id="par_idN11CA3" xml-lang="en-US">You can specify the following properties for a scrollbar:</paragraph>
<table id="">
<tablerow>
<tablecell>
<paragraph role="tablehead" id="par_idN11CDA" xml-lang="en-US">UI name</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablehead" id="par_idN11CE0" xml-lang="en-US">Semantics</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_idN11CE7" xml-lang="en-US">Scroll value min</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_idN11CED" xml-lang="en-US">Specifies the minimum height or the minimum width of a scrollbar.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_idN11CF4" xml-lang="en-US">Scroll value max</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_idN11CFA" xml-lang="en-US">Specifies the maximum height or the maximum width of a scrollbar.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D01" xml-lang="en-US">Default scroll value</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D07" xml-lang="en-US">Specifies the default value of a scrollbar, used when the form is reset.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D0E" xml-lang="en-US">Orientation</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D14" xml-lang="en-US">Specifies the orientation of a scrollbar, that is, horizontal or vertical.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D1B" xml-lang="en-US">Small change</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D21" xml-lang="en-US">Specifies the minimum amount by which you can scroll a scrollbar, for example, by clicking an arrow.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D28" xml-lang="en-US">Large change</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D2E" xml-lang="en-US">Specifies the amount that a large step scrolls a scrollbar, for example, when you click between the scrollbar thumb and a scrollbar arrow.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D35" xml-lang="en-US">Delay</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D3B" xml-lang="en-US">Specifies the delay in milliseconds between scrollbar trigger events. For example, the delay that occurs when you click an arrow button on the scrollbar and hold down the mouse button.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D42" xml-lang="en-US">Symbol color</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D48" xml-lang="en-US">Specifies the color of the arrows on the scrollbar.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D4F" xml-lang="en-US">Visible Size</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_idN11D55" xml-lang="en-US">Specifies the size of the scrollbar thumb in "value units". For example, a value of <emph>("Scroll value max." minus "Scroll value min.") / 2</emph> results in a scrollbar thumb that occupies half of the scrollbar.</paragraph>
<paragraph role="tablecontent" id="par_idN11D58" xml-lang="en-US">To make the width of the scrollbar equal to the height of the scrollbar, set the <emph>Visible Size</emph> to zero.</paragraph>
</tablecell>
</tablerow>
</table>
<paragraph role="paragraph" id="par_idN11D63" xml-lang="en-US">In a Calc spreadsheet, you can use the <emph>Data</emph> tab page to create a two-way link between a scrollbar and a cell.<comment>UFI: see spec doc scrollbar_form_control.sxw</comment></paragraph>
</section>
<section id="relatedtopics">
<paragraph id="hd_id3149436" role="paragraph"><link href="text/shared/02/01170001.xhp" name="Context Menu Commands">Context Menu Commands</link></paragraph>
</section>
</body>
</helpdocument>
|
