<?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="textsharedguidepaintbrushxml" indexer="include">
    <title xml-lang="en-US" id="tit">Copying Attributes With the Clone Formatting Tool</title>
    <filename>/text/shared/guide/paintbrush.xhp</filename>
  </topic>
</meta>

<body>  
  <section id="paintbrush">
   <bookmark xml-lang="en-US" branch="index" id="bm_id380260">
     <bookmark_value>Format Paintbrush</bookmark_value>
      <bookmark_value>clone formatting</bookmark_value>
      <bookmark_value>formatting;copying</bookmark_value>
      <bookmark_value>copying;formatting</bookmark_value>
      <bookmark_value>Paintbrush</bookmark_value>
  </bookmark>
  <h1 id="par_idN1053A"><variable id="formatpaintbrush"><link href="text/shared/guide/paintbrush.xhp">Copying Formatting With the Clone Formatting Tool</link></variable></h1>
  </section>
  <paragraph xml-lang="en-US" id="par_idN10655" role="paragraph">Use the <link href="text/shared/02/paintbrush.xhp"><emph>Clone Formatting</emph></link> tool to copy formatting from a text selection or from an object and apply the formatting to another text selection or object.</paragraph>
  <list type="ordered">
    <listitem>
      <paragraph xml-lang="en-US" id="par_idN106DD" role="paragraph">Select the text or object whose formatting you want to copy.</paragraph>
    </listitem>
    <listitem>
       <paragraph xml-lang="en-US" id="par_idN10667" role="paragraph">On the <link href="text/shared/main0201.xhp"><emph>Standard Bar</emph></link>, click the <emph>Clone Formatting</emph> icon. The mouse cursor will change to a paint bucket.</paragraph>
    </listitem>
    <listitem>
      <paragraph xml-lang="en-US" id="par_idN1066E" role="paragraph">Select or click the text or object that you want to apply the formatting to.</paragraph>
    </listitem>
  </list>
  <tip id="par_id291629997756899">If you want to apply the formatting to more than one selection, double-click the <emph>Clone Formatting</emph> icon <image id="img_id209967" src="cmd/sc_formatpaintbrush.png" width="0.1665in" height="0.1665in"><alt id="alt_id209967">Icon</alt></image>. After you apply all the formatting, click the icon again.</tip>
  <paragraph id="par_idN10716" role="paragraph">By default only the character formatting is copied ; to include paragraph formatting, hold down <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline> when you click. To copy only the paragraph formatting, hold down <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift when you click.</paragraph>
  <warning id="par_id1001629997571404">In Calc, the Clone Formatting tool only copies formatting applied using the <menuitem>Format - Cells</menuitem> dialog or other equivalent methods. Therefore, any formatting applied directly to characters by selecting text inside a cell and then going to the <menuitem>Format - Character</menuitem> dialog will not be copied using the Clone Formatting tool.</warning>
  <paragraph xml-lang="en-US" id="par_idN10672" role="paragraph">The <emph>paragraph</emph> formats are the formats applied to the whole paragraph. The <emph>character</emph> formats are those applied to a portion of the paragraph. For example, if you apply the bold format to a whole paragraph the bold format is a <emph>paragraph</emph> format. Then if you unbold a portion of this paragraph, the bold format is still a <emph>paragraph</emph> format but the portion you unbold has a "not bold" <emph>character</emph> format.</paragraph>
  <paragraph xml-lang="en-US" id="par_idN10671" role="paragraph">The following table describes the formatting attributes that the <emph>Clone Formatting</emph> tool can copy:</paragraph>
      <table id="tbl_id599688">
         <tablerow>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN10691" role="tablehead">Type of Selection</paragraph>
            </tablecell>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN10697" role="tablehead">Comment</paragraph>
            </tablecell>
         </tablerow>
         <tablerow>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN1069E" role="tablecontent">Nothing selected, but cursor is inside a text passage</paragraph>
            </tablecell>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106A4" role="tablecontent">Copies the formatting of the current paragraph and the character formatting of the next character in the text flow direction.</paragraph>
            </tablecell>
         </tablerow>
         <tablerow>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106AB" role="tablecontent">Text is selected</paragraph>
            </tablecell>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106B1" role="tablecontent">Copies the formatting of the last selected character and of the paragraph that contains the character.</paragraph>
            </tablecell>
         </tablerow>
         <tablerow>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106B8" role="tablecontent">Frame is selected</paragraph>
            </tablecell>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106BE" role="tablecontent">Copies the frame attributes that are defined in <item type="menuitem">Format - Frame and Object - Properties</item> dialog. The contents, size, position, linking, hyperlinks, and macros in the frame are not copied.</paragraph>
            </tablecell>
         </tablerow>
         <tablerow>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106C5" role="tablecontent">Object is selected</paragraph>
            </tablecell>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106CB" role="tablecontent">Copies the object formatting that is defined in the <item type="menuitem">Format - Graphics</item> or <item type="menuitem">Format - Drawing Object</item> dialogs. The contents, size, position, hyperlinks, and macros in the object are not copied.</paragraph>
            </tablecell>
         </tablerow>
         <tablerow>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106D2" role="tablecontent">Form control is selected</paragraph>
            </tablecell>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106D8" role="tablecontent">Not supported</paragraph>
            </tablecell>
         </tablerow>
         <tablerow>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106DF" role="tablecontent">Drawing object is selected</paragraph>
            </tablecell>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106E5" role="tablecontent">Copies all formatting attributes. In Impress and Draw, the text contents of the object is also copied.</paragraph>
            </tablecell>
         </tablerow>
         <tablerow>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106EC" role="tablecontent">Text within Calc cells is selected</paragraph>
            </tablecell>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106F2" role="tablecontent">Not supported</paragraph>
            </tablecell>
         </tablerow>
         <tablerow>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106F9" role="tablecontent">Writer table or cells are selected</paragraph>
            </tablecell>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN106FF" role="tablecontent">Copies the formatting that is specified in Table, Text Flow, Borders, and Background tab pages in the <item type="menuitem">Format - Table</item> dialog. The paragraph and character formatting are also copied.</paragraph>
            </tablecell>
         </tablerow>
         <tablerow>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN10706" role="tablecontent">Calc table or cells are selected</paragraph>
            </tablecell>
            <tablecell>
               <paragraph xml-lang="en-US" id="par_idN1070C" role="tablecontent">Copies cell formatting specified using the <menuitem>Format - Cells</menuitem> dialog.</paragraph>
            </tablecell>
         </tablerow>
         <tablerow>
            <tablecell>
               <paragraph id="par_id791717184075742" role="tablecontent">Text within Impress table is selected</paragraph>
            </tablecell>
            <tablecell>
               <paragraph id="par_id211717184260731" role="tablecontent">Copies formatting attributes that apply to all characters in the cell. Formatting can only be copied within the same table.</paragraph>
            </tablecell>
         </tablerow>
         <tablerow>
            <tablecell>
               <paragraph id="par_id10821388499239" role="tablecontent">Impress table or cells are selected</paragraph>
            </tablecell>
            <tablecell>
               <paragraph id="par_id23538680114944" role="tablecontent">Not supported</paragraph>
            </tablecell>
         </tablerow>
      </table>
      <section id="relatedtopics">
         <embed href="text/shared/02/paintbrush.xhp#paintbrush_h1"/>
      </section>
   </body>
</helpdocument>
