source/text/shared/optionen/01060900.xhp | 74 ++++++++++++++++++-------------
1 file changed, 45 insertions(+), 29 deletions(-)
New commits:
commit 8db831e3f0dce474924168d18e4f8d23fc29f731
Author: Olivier Hallot <olivier.hal...@libreoffice.org>
AuthorDate: Mon Apr 8 12:49:41 2024 -0300
Commit: Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Mon Apr 8 18:44:16 2024 +0200
tdf#160179 Recalculate row height at load times
+ refactor
Change-Id: I0a81e254a8c40487d6ca559860c02ec1f4f44912
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/165890
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hal...@libreoffice.org>
diff --git a/source/text/shared/optionen/01060900.xhp
b/source/text/shared/optionen/01060900.xhp
index ae6ca2244a..56cea987cb 100644
--- a/source/text/shared/optionen/01060900.xhp
+++ b/source/text/shared/optionen/01060900.xhp
@@ -20,13 +20,13 @@
<meta>
<topic id="textsharedoptionen01060900xml" indexer="include"
status="PUBLISH">
- <title id="tit" xml-lang="en-US">Formula</title>
+ <title id="tit">Formula</title>
<filename>/text/shared/optionen/01060900.xhp</filename>
</topic>
</meta>
<body>
<section id="formula">
- <bookmark xml-lang="en-US" branch="index" id="bm_id4249399">
+<bookmark branch="index" id="bm_id4249399">
<bookmark_value>formula options;formula syntax</bookmark_value>
<bookmark_value>formula options;separators</bookmark_value>
<bookmark_value>formula options;reference syntax in string
parameters</bookmark_value>
@@ -40,67 +40,83 @@
<bookmark_value>recalculating;formula options</bookmark_value>
<bookmark_value>recalculating;large spreadsheet files</bookmark_value>
<bookmark_value>loading;large spreadsheet files</bookmark_value>
+<bookmark_value>loading;optimal row height</bookmark_value>
+<bookmark_value>optimal row height;recalculation</bookmark_value>
</bookmark>
- <bookmark xml-lang="en-US"
branch="hid/modules/scalc/ui/optformula/OptFormula" id="bm_id3149095"
localize="false"/>
- <bookmark xml-lang="en-US"
branch="hid/modules/scalc/ui/optformula/@@nowidget@@" id="@@nowidget@@"
localize="false"/>
+ <bookmark branch="hid/modules/scalc/ui/optformula/OptFormula"
id="bm_id3149095" localize="false"/>
+ <bookmark branch="hid/modules/scalc/ui/optformula/@@nowidget@@"
id="@@nowidget@@" localize="false"/>
<h1 id="hd_id3145071"><link
href="text/shared/optionen/01060900.xhp">Formula</link></h1>
- <paragraph id="par_id3147576" role="paragraph" xml-lang="en-US"><ahelp
hid=".">Defines formula syntax options and loading options for %PRODUCTNAME
Calc.</ahelp></paragraph>
+ <paragraph id="par_id3147576" role="paragraph"><ahelp hid=".">Defines
formula syntax options and loading options for %PRODUCTNAME
Calc.</ahelp></paragraph>
</section>
<section id="howtoget">
<embed href="text/shared/00/00000406.xhp#exopfo"/>
</section>
<h2 id="hd_id3149399">Formula options</h2>
<h3 id="hd_id31493991">Formula syntax</h3>
- <paragraph id="par_id3155419" role="paragraph" xml-lang="en-US">There are
three options. Let's see it by example. In a sample spreadsheet there are two
worksheets, Sheet1 and Sheet2. In A1 cell of Sheet1 there is a reference to C4
cell of Sheet2.</paragraph>
+ <paragraph id="par_id3155419" role="paragraph">There are three options.
Let's see it by example. In a sample spreadsheet there are two worksheets,
Sheet1 and Sheet2. In A1 cell of Sheet1 there is a reference to C4 cell of
Sheet2.</paragraph>
<list type="unordered">
<listitem>
- <paragraph id="par_id3156155" role="listitem"
xml-lang="en-US"><emph>Calc A1</emph> - This is the default of %PRODUCTNAME
Calc. The reference will be <item type="input">=$Sheet2.C4</item></paragraph>
+ <paragraph id="par_id3156155" role="listitem"><emph>Calc A1</emph>
- This is the default of %PRODUCTNAME Calc. The reference will be <item
type="input">=$Sheet2.C4</item></paragraph>
</listitem>
<listitem>
- <paragraph id="par_id3147530" role="listitem"
xml-lang="en-US"><emph>Excel A1</emph> - This is the default of Microsoft
Excel. The reference will be <item type="input">=Sheet2!C4</item></paragraph>
+ <paragraph id="par_id3147530" role="listitem"><emph>Excel
A1</emph> - This is the default of Microsoft Excel. The reference will be <item
type="input">=Sheet2!C4</item></paragraph>
</listitem>
<listitem>
- <paragraph id="par_id3153061" role="listitem"
xml-lang="en-US"><emph>Excel R1C1</emph> - This is the relative row/column
addressing, known from Microsoft Excel. The reference will be <item
type="input">=Sheet2!R[3]C[2]</item></paragraph>
+ <paragraph id="par_id3153061" role="listitem"><emph>Excel
R1C1</emph> - This is the relative row/column addressing, known from Microsoft
Excel. The reference will be <item
type="input">=Sheet2!R[3]C[2]</item></paragraph>
</listitem></list>
<h3 id="hd_id31493992">Use English function names</h3>
- <paragraph id="par_id4155419" role="paragraph" xml-lang="en-US">In
%PRODUCTNAME Calc function names can be localized. By default, the check box is
off, which means the localized function names are used. Checking this check box
will swap localized function names with the English ones. This change takes
effect in all of the following areas: formula input and display, function
wizard, and formula tips. You can of course uncheck it to go back to the
localized function names.</paragraph>
+ <paragraph id="par_id4155419" role="paragraph">In %PRODUCTNAME Calc
function names can be localized. By default, the check box is off, which means
the localized function names are used. Checking this check box will swap
localized function names with the English ones. This change takes effect in all
of the following areas: formula input and display, function wizard, and formula
tips. You can of course uncheck it to go back to the localized function
names.</paragraph>
<h2 id="hd_id4149399">Separators</h2>
- <paragraph id="par_id5155419" role="paragraph" xml-lang="en-US">This
option group lets you configure separators in your formula expressions. This
comes in handy when, for instance, you want to separate your function
parameters by commas (,) instead of semicolons (;).</paragraph>
- <paragraph id="par_id6155419" role="paragraph" xml-lang="en-US">For
example, instead of <item type="input">=SUM(A1;B1;C1)</item> you can type <item
type="input">=SUM(A1,B1,C1)</item>.</paragraph>
- <paragraph id="par_id7155419" role="paragraph" xml-lang="en-US">Likewise,
you can also change the column and row separators for in-line arrays.
Previously, an in-line array used semicolons (;) as the column separators and
the pipe symbols (|) as the row separators, so a typical in-line array
expression looked like this for a 5 x 2 matrix array:</paragraph>
- <paragraph id="par_id8155419" role="paragraph" xml-lang="en-US"><item
type="input">={1;2;3;4;5|6;7;8;9;10}</item></paragraph>
- <paragraph id="par_id9155419" role="paragraph" xml-lang="en-US">By
changing the column separators to commas (,) and the row separators to
semicolons (;), the same expression will look like this:</paragraph>
- <paragraph id="par_id0155419" role="paragraph" xml-lang="en-US"><item
type="input">={1,2,3,4,5;6,7,8,9,10}</item></paragraph>
+ <paragraph id="par_id5155419" role="paragraph">This option group lets you
configure separators in your formula expressions. This comes in handy when, for
instance, you want to separate your function parameters by commas (,) instead
of semicolons (;).</paragraph>
+ <paragraph id="par_id6155419" role="paragraph">For example, instead of
<item type="input">=SUM(A1;B1;C1)</item> you can type <item
type="input">=SUM(A1,B1,C1)</item>.</paragraph>
+ <paragraph id="par_id7155419" role="paragraph">Likewise, you can also
change the column and row separators for in-line arrays. Previously, an in-line
array used semicolons (;) as the column separators and the pipe symbols (|) as
the row separators, so a typical in-line array expression looked like this for
a 5 x 2 matrix array:</paragraph>
+ <paragraph id="par_id8155419" role="paragraph"><item
type="input">={1;2;3;4;5|6;7;8;9;10}</item></paragraph>
+ <paragraph id="par_id9155419" role="paragraph">By changing the column
separators to commas (,) and the row separators to semicolons (;), the same
expression will look like this:</paragraph>
+ <paragraph id="par_id0155419" role="paragraph"><item
type="input">={1,2,3,4,5;6,7,8,9,10}</item></paragraph>
<embed
href="text/shared/optionen/detailedcalculation.xhp#detailed_calculation"/>
<h2 id="hd_id5149400">Recalculation on File Load</h2>
- <paragraph id="par_id2335549" role="paragraph"
xml-lang="en-US">Recalculating formulas can take significant time while loading
very large files.</paragraph>
-
+ <paragraph id="par_id2335549" role="paragraph">Recalculating formulas can
take significant time while loading very large files.</paragraph>
+ <bookmark branch="hid/modules/scalc/ui/optformula/ooxmlrecalc"
id="bm_id217525967776" localize="false"/>
<h3 id="par_id2115549">Excel 2007 and newer:</h3>
- <paragraph id="par_id2015549" role="paragraph" xml-lang="en-US">Loading a
large spreadsheet file can take a long time. If you don't need to update your
large spreadsheet data immediately, you can postpone the recalculation at a
better time. %PRODUCTNAME allows you to defer recalculation of Excel 2007 (and
above) spreadsheets to speedup loading time. </paragraph>
-
+ <paragraph id="par_id2015549" role="paragraph">Loading a large spreadsheet
file can take a long time. If you don't need to update your large spreadsheet
data immediately, you can postpone the recalculation at a better time.
%PRODUCTNAME allows you to defer recalculation of Excel 2007 (and above)
spreadsheets to speedup loading time. </paragraph>
+ <bookmark branch="hid/modules/scalc/ui/optformula/odfrecalc"
id="bm_id21752590967776" localize="false"/>
<h3 id="par_id2215549">ODF Spreadsheet (not saved by %PRODUCTNAME):</h3>
- <paragraph id="par_id2016549" role="paragraph" xml-lang="en-US">Recent
versions of %PRODUCTNAME caches spreadsheet formula results into its ODF file.
This feature helps %PRODUCTNAME to recalculate a large ODF spreadsheet saved by
%PRODUCTNAME faster. </paragraph>
- <paragraph id="par_id2017549" role="paragraph" xml-lang="en-US">For ODF
spreadsheets saved by other programs, where such cached formula results may not
exist, recalculation can be deferred to speedup file loading as with Excel 2007
files. </paragraph>
- <paragraph id="par_id2315549" role="paragraph" xml-lang="en-US">For the
entries above the following choices are possible:</paragraph>
+ <paragraph id="par_id2016549" role="paragraph">Recent versions of
%PRODUCTNAME caches spreadsheet formula results into its ODF file. This feature
helps %PRODUCTNAME to recalculate a large ODF spreadsheet saved by %PRODUCTNAME
faster. </paragraph>
+ <paragraph id="par_id2017549" role="paragraph">For ODF spreadsheets saved
by other programs, where such cached formula results may not exist,
recalculation can be deferred to speedup file loading as with Excel 2007 files.
</paragraph>
+ <paragraph id="par_id2315549" role="paragraph">For the entries above the
following choices are possible:</paragraph>
<list type="unordered">
<listitem>
- <paragraph id="par_id3256155" role="listitem"
xml-lang="en-US"><emph>Never recalculate</emph> - No formulas will be
recalculated on loading the file.</paragraph>
+ <paragraph id="par_id3256155" role="listitem"><emph>Never
recalculate</emph> - No formulas will be recalculated on loading the
file.</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id3247530" role="listitem"
xml-lang="en-US"><emph>Always recalculate</emph> - All formulas will be
recalculated on file load.</paragraph>
+ <paragraph id="par_id3247530" role="listitem"><emph>Always
recalculate</emph> - All formulas will be recalculated on file load.</paragraph>
</listitem>
<listitem>
- <paragraph id="par_id3253061" role="listitem"
xml-lang="en-US"><emph>Prompt user</emph> - Prompt user for action.</paragraph>
- </listitem></list>
+ <paragraph id="par_id3253061" role="listitem"><emph>Prompt
user</emph> - Prompt user for action.</paragraph>
+ </listitem>
+ </list>
<tip id="par_id2010549">%PRODUCTNAME saved ODF spreadsheets will honor
<emph>Never recalculate</emph> and <emph>Always recalculate</emph> options.
</tip>
-
+ <bookmark branch="hid/modules/scalc/ui/optformula/rowheightrecalc"
id="bm_id21712590967776" localize="false"/>
+ <h3 id="hd_id351712589455802">Optimal Row Height</h3>
+ <paragraph role="paragraph" id="par_id861712590713554">For large
spreadsheets documents, optimal row height calculation depends on the cell
contents formatting and also on the result of the conditional formatted
formulas. This setting helps to shorten load times by controlling the optimal
row height calculation.</paragraph>
+ <list type="unordered">
+ <listitem>
+ <paragraph id="par_id301712590444434" role="listitem"><emph>Never
recalculate</emph> - No row height will be recalculated on loading the
file.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id171712590450298" role="listitem"><emph>Always
recalculate</emph> - All row height will be recalculated on file
load.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id91712590453754" role="listitem"><emph>Prompt
user</emph> - Prompt user for action.</paragraph>
+ </listitem>
+ </list>
<section id="relatedtopics">
- <paragraph id="par_id200920171902249043" role="paragraph"
xml-lang="en-US"><link href="text/scalc/01/04060107.xhp">Array
formulas</link></paragraph>
+ <paragraph id="par_id200920171902249043" role="paragraph"><link
href="text/scalc/01/04060107.xhp">Array formulas</link></paragraph>
</section>
</body>
</helpdocument>
