1cdf0e10cSrcweir<?xml version="1.0" encoding="UTF-8"?>
2cdf0e10cSrcweir<helpdocument version="1.0">
3cdf0e10cSrcweir
4*226a8927SAndrew Rist<!--***********************************************************
5*226a8927SAndrew Rist *
6*226a8927SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one
7*226a8927SAndrew Rist * or more contributor license agreements.  See the NOTICE file
8*226a8927SAndrew Rist * distributed with this work for additional information
9*226a8927SAndrew Rist * regarding copyright ownership.  The ASF licenses this file
10*226a8927SAndrew Rist * to you under the Apache License, Version 2.0 (the
11*226a8927SAndrew Rist * "License"); you may not use this file except in compliance
12*226a8927SAndrew Rist * with the License.  You may obtain a copy of the License at
13*226a8927SAndrew Rist *
14*226a8927SAndrew Rist *   http://www.apache.org/licenses/LICENSE-2.0
15*226a8927SAndrew Rist *
16*226a8927SAndrew Rist * Unless required by applicable law or agreed to in writing,
17*226a8927SAndrew Rist * software distributed under the License is distributed on an
18*226a8927SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
19*226a8927SAndrew Rist * KIND, either express or implied.  See the License for the
20*226a8927SAndrew Rist * specific language governing permissions and limitations
21*226a8927SAndrew Rist * under the License.
22*226a8927SAndrew Rist *
23*226a8927SAndrew Rist ***********************************************************-->
24*226a8927SAndrew Rist
25*226a8927SAndrew Rist
26cdf0e10cSrcweir
27cdf0e10cSrcweir
28cdf0e10cSrcweir<meta>
29cdf0e10cSrcweir      <topic id="textsharedguideformfieldsxml" indexer="include" status="PUBLISH">
30cdf0e10cSrcweir         <title xml-lang="en-US" id="tit">Inserting and Editing Buttons</title>
31cdf0e10cSrcweir         <filename>/text/shared/guide/formfields.xhp</filename>
32cdf0e10cSrcweir      </topic>
33cdf0e10cSrcweir   </meta>
34cdf0e10cSrcweir   <body>
35cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="index" id="bm_id3149798"><bookmark_value>command buttons, see push buttons</bookmark_value>
36cdf0e10cSrcweir      <bookmark_value>controls;adding to documents</bookmark_value>
37cdf0e10cSrcweir      <bookmark_value>inserting;push buttons</bookmark_value>
38cdf0e10cSrcweir      <bookmark_value>keys;adding push buttons</bookmark_value>
39cdf0e10cSrcweir      <bookmark_value>buttons;adding push buttons</bookmark_value>
40cdf0e10cSrcweir      <bookmark_value>press buttons, see push buttons</bookmark_value>
41cdf0e10cSrcweir      <bookmark_value>push buttons;adding to documents</bookmark_value>
42cdf0e10cSrcweir</bookmark><comment>MW changed "adding;" to "inserting;"</comment>
43cdf0e10cSrcweir<paragraph xml-lang="en-US" id="hd_id3149798" role="heading" level="1" l10n="U" oldref="5"><variable id="formfields"><link href="text/shared/guide/formfields.xhp" name="Inserting and Editing Buttons">Adding a Command Button to a Document</link>
44cdf0e10cSrcweir</variable></paragraph>
45cdf0e10cSrcweir      <paragraph xml-lang="en-US" id="par_idN10731" role="paragraph" l10n="CHG">You can use the Form Controls toolbar to add checkboxes, buttons, tables showing data records, and other controls to a document.</paragraph>
46cdf0e10cSrcweir      <paragraph xml-lang="en-US" id="par_idN1077F" role="heading" level="2" l10n="NEW">To Add a Button to a Document </paragraph>
47cdf0e10cSrcweir      <list type="ordered">
48cdf0e10cSrcweir         <listitem>
49cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_id3154751" role="listitem" l10n="CHG" oldref="6">Choose <item type="menuitem">View - Toolbars - Form Controls</item>.</paragraph>
50cdf0e10cSrcweir         </listitem>
51cdf0e10cSrcweir         <listitem>
52cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_id3145345" role="listitem" l10n="CHG" oldref="7">On the Form Controls toolbar, click the <emph>Push Button</emph> icon.</paragraph>
53cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_idN107A4" role="listitem" l10n="NEW">The mouse pointer changes to a cross-hair.</paragraph>
54cdf0e10cSrcweir         </listitem>
55cdf0e10cSrcweir         <listitem>
56cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_id3159233" role="listitem" l10n="U" oldref="8">In the document, drag to draw the button.</paragraph>
57cdf0e10cSrcweir         </listitem>
58cdf0e10cSrcweir         <listitem>
59cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_idN107B2" role="listitem" l10n="NEW">Right-click the button and choose <emph>Control</emph>.</paragraph>
60cdf0e10cSrcweir         </listitem>
61cdf0e10cSrcweir         <listitem>
62cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_idN107CD" role="listitem" l10n="NEW">Specify the properties of the button.</paragraph>
63cdf0e10cSrcweir         </listitem>
64cdf0e10cSrcweir         <listitem>
65cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_id3154923" role="listitem" l10n="CHG" oldref="11">To change the button label, click the <emph>General</emph> tab, and edit the text in the <emph>Label</emph> box.</paragraph>
66cdf0e10cSrcweir         </listitem>
67cdf0e10cSrcweir         <listitem>
68cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_id3147303" role="listitem" l10n="U" oldref="12">To attach a macro to the button, click the <emph>Events</emph> tab, and click the <emph>... </emph>button beside the button action that you want to run the macro. In the <emph>Assign Macro</emph> dialog, locate the macro that you want to use, and then click <emph>OK</emph>.<comment>UFI: see #i34509#</comment></paragraph>
69cdf0e10cSrcweir         </listitem>
70cdf0e10cSrcweir         <listitem>
71cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_idN10814" role="listitem" l10n="NEW">Close the <emph>Properties</emph> dialog.</paragraph>
72cdf0e10cSrcweir         </listitem>
73cdf0e10cSrcweir         <listitem>
74cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_id3147350" role="listitem" l10n="CHG" oldref="76">(Optional) Specify the properties of the form that the button belongs to.</paragraph>
75cdf0e10cSrcweir         </listitem>
76cdf0e10cSrcweir         <listitem>
77cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_idN10828" role="listitem" l10n="NEW">Right-click the button and choose <emph>Form</emph>.</paragraph>
78cdf0e10cSrcweir         </listitem>
79cdf0e10cSrcweir         <listitem>
80cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_idN1082F" role="listitem" l10n="NEW">The <emph>Form Properties</emph> dialog opens.</paragraph>
81cdf0e10cSrcweir         </listitem>
82cdf0e10cSrcweir         <listitem>
83cdf0e10cSrcweir            <paragraph xml-lang="en-US" id="par_idN10837" role="listitem" l10n="NEW">Specify the properties for the form and then close the dialog.</paragraph>
84cdf0e10cSrcweir         </listitem>
85cdf0e10cSrcweir      </list>
86cdf0e10cSrcweir      <section id="relatedtopics">
87cdf0e10cSrcweir         <embed href="text/shared/guide/data_addressbook.xhp#data_addressbook"/>
88cdf0e10cSrcweir      </section>
89cdf0e10cSrcweir   </body>
90cdf0e10cSrcweir</helpdocument>