xref: /trunk/main/helpcontent2/source/text/scalc/01/text2columns.xhp (revision 4fd23d01256f61259ae75e149e713e494a0f0033)
1cdf0e10cSrcweir<?xml version="1.0" encoding="UTF-8"?>
2cdf0e10cSrcweir
352ac0773SAndrew Rist<!--***********************************************************
4cdf0e10cSrcweir *
552ac0773SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one
652ac0773SAndrew Rist * or more contributor license agreements.  See the NOTICE file
752ac0773SAndrew Rist * distributed with this work for additional information
852ac0773SAndrew Rist * regarding copyright ownership.  The ASF licenses this file
952ac0773SAndrew Rist * to you under the Apache License, Version 2.0 (the
1052ac0773SAndrew Rist * "License"); you may not use this file except in compliance
1152ac0773SAndrew Rist * with the License.  You may obtain a copy of the License at
12cdf0e10cSrcweir *
1352ac0773SAndrew Rist *   http://www.apache.org/licenses/LICENSE-2.0
14cdf0e10cSrcweir *
1552ac0773SAndrew Rist * Unless required by applicable law or agreed to in writing,
1652ac0773SAndrew Rist * software distributed under the License is distributed on an
1752ac0773SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
1852ac0773SAndrew Rist * KIND, either express or implied.  See the License for the
1952ac0773SAndrew Rist * specific language governing permissions and limitations
2052ac0773SAndrew Rist * under the License.
21cdf0e10cSrcweir *
2252ac0773SAndrew Rist ***********************************************************-->
2352ac0773SAndrew Rist
24bfb37b88Smseidel<helpdocument version="1.0">
25cdf0e10cSrcweir<meta>
26cdf0e10cSrcweir<topic id="textscalc01text2columnsxml" indexer="include">
27cdf0e10cSrcweir<title xml-lang="en-US" id="tit">Text to Columns</title>
28cdf0e10cSrcweir<filename>/text/scalc/01/text2columns.xhp</filename>
29cdf0e10cSrcweir</topic>
30cdf0e10cSrcweir</meta>
31cdf0e10cSrcweir<body>
32bfb37b88Smseidel<bookmark xml-lang="en-US" branch="index" id="bm_id8004394">
33bfb37b88Smseidel<bookmark_value>text to columns</bookmark_value>
34cdf0e10cSrcweir</bookmark>
35cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/.uno:TextToColumns" id="bm_id1029200802260951" localize="false"/>
36cdf0e10cSrcweir<paragraph xml-lang="en-US" id="hd_id2300180" role="heading" level="1" l10n="NEW"><link href="text/scalc/01/text2columns.xhp">Text to Columns</link></paragraph>
37*4fd23d01Smseidel<paragraph xml-lang="en-US" id="par_id655232" role="paragraph" l10n="NEW"><variable id="text2columns">Opens the Text to Columns dialog, where you enter settings to expand the contents of selected cells to multiple cells.</variable></paragraph>
38cdf0e10cSrcweir<section id="howtoget">
39cdf0e10cSrcweir<embed href="text/scalc/00/00000412.xhp#text2columns"/>
40cdf0e10cSrcweir</section>
41cdf0e10cSrcweir<paragraph xml-lang="en-US" id="hd_id9599597" role="heading" level="2" l10n="NEW">To expand cell contents to multiple cells</paragraph>
42cdf0e10cSrcweir<paragraph xml-lang="en-US" id="par_id2021546" role="paragraph" l10n="NEW">You can expand cells that contain comma separated values (CSV) into multiple cells in the same row.</paragraph>
43cdf0e10cSrcweir<paragraph xml-lang="en-US" id="par_id2623981" role="paragraph" l10n="NEW">For example, cell A1 contains the comma separated values <item type="literal">1,2,3,4</item>, and cell A2 contains the text <item type="literal">A,B,C,D</item>.</paragraph>
44cdf0e10cSrcweir<list type="ordered">
45cdf0e10cSrcweir<listitem>
46cdf0e10cSrcweir<paragraph xml-lang="en-US" id="par_id7242042" role="paragraph" l10n="NEW">Select the cell or cells that you want to expand.</paragraph>
47cdf0e10cSrcweir</listitem>
48cdf0e10cSrcweir<listitem>
49cdf0e10cSrcweir<paragraph xml-lang="en-US" id="par_id6999420" role="paragraph" l10n="NEW">Choose <emph>Data - Text to Columns</emph>.</paragraph>
50cdf0e10cSrcweir<paragraph xml-lang="en-US" id="par_id6334116" role="paragraph" l10n="NEW">You see the Text to Columns dialog.</paragraph>
51cdf0e10cSrcweir</listitem>
52cdf0e10cSrcweir<listitem>
53cdf0e10cSrcweir<paragraph xml-lang="en-US" id="par_id9276406" role="paragraph" l10n="NEW">Select the separator options. The preview shows how the current cell contents will be transformed into multiple cells.</paragraph>
54cdf0e10cSrcweir</listitem>
55cdf0e10cSrcweir</list>
56cdf0e10cSrcweir<paragraph xml-lang="en-US" id="par_id8523819" role="paragraph" l10n="NEW">You can select a fixed width and then click the ruler on the preview to set cell breakup positions.</paragraph>
57cdf0e10cSrcweir<paragraph xml-lang="en-US" id="par_id1517380" role="paragraph" l10n="NEW">You can select or enter separator characters to define the positions of breaking points. The separator characters are removed from the resulting cell contents.</paragraph>
58cdf0e10cSrcweir<paragraph xml-lang="en-US" id="par_id7110812" role="paragraph" l10n="CHG">In the example, you select the comma as a delimiter character. Cells A1 and A2 will be expanded to four columns each. A1 contains 1, B1 contains 2, and so on.</paragraph>
59cdf0e10cSrcweir<section id="relatedtopics">
60cdf0e10cSrcweir<embed href="text/scalc/guide/csv_files.xhp#csv_files"/>
61cdf0e10cSrcweir<embed href="text/scalc/guide/csv_formula.xhp#csv_formula"/>
62cdf0e10cSrcweir</section>
63cdf0e10cSrcweir</body>
64cdf0e10cSrcweir</helpdocument>
65