From 3c40190b5fd082435c47dfa0ea6d6133ce9f4d3b Mon Sep 17 00:00:00 2001 From: Olivier Hallot Date: Tue, 12 Dec 2023 20:17:22 -0300 Subject: tdf#155876 UI cmds Calc-Sheet menu (30) + Sheet menu for Calc: clear cells, references, fill + refactoring Change-Id: I0c0c10af4a9983e893907aa5c0a491b5814dae22 Reviewed-on: https://gerrit.libreoffice.org/c/help/+/160657 Tested-by: Jenkins Reviewed-by: Olivier Hallot (cherry picked from commit 4953ea62c3603c2c3f66faf67dac67ba987476c9) Reviewed-on: https://gerrit.libreoffice.org/c/help/+/160638 --- AllLangHelp_scalc.mk | 1 + source/text/scalc/00/00000402.xhp | 25 +++++- source/text/scalc/00/sheet_menu.xhp | 6 ++ source/text/scalc/01/02140000.xhp | 113 ++++++++++++------------ source/text/scalc/01/02150000.xhp | 64 ++++++-------- source/text/scalc/01/ToggleRelative.xhp | 32 +++++++ source/text/scalc/guide/relativ_absolut_ref.xhp | 26 +++--- source/text/scalc/main0116.xhp | 4 +- 8 files changed, 163 insertions(+), 108 deletions(-) create mode 100644 source/text/scalc/01/ToggleRelative.xhp diff --git a/AllLangHelp_scalc.mk b/AllLangHelp_scalc.mk index e599fb8d9b..6fd3c5f682 100644 --- a/AllLangHelp_scalc.mk +++ b/AllLangHelp_scalc.mk @@ -323,6 +323,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,scalc,\ helpcontent2/source/text/scalc/01/TableSelectAll \ helpcontent2/source/text/scalc/01/text2columns \ helpcontent2/source/text/scalc/01/ToggleFormula \ + helpcontent2/source/text/scalc/01/ToggleRelative \ helpcontent2/source/text/scalc/01/ToggleSheetGrid \ helpcontent2/source/text/scalc/01/SelectUnprotectedCells \ helpcontent2/source/text/scalc/01/SelectVisibleColumns \ diff --git a/source/text/scalc/00/00000402.xhp b/source/text/scalc/00/00000402.xhp index 3c71881376..f587341b42 100644 --- a/source/text/scalc/00/00000402.xhp +++ b/source/text/scalc/00/00000402.xhp @@ -161,7 +161,11 @@ F2 -Choose Sheet - Fill Cells. +
+ + Choose Sheet - Fill Cells. +
+ Choose Sheet - Fill Cells - Down. Choose Sheet - Fill Cells - Right. Choose Sheet - Fill Cells - Up. @@ -170,8 +174,23 @@ Choose Sheet - Fill Cells - Series.
-Choose Sheet - Clear Cells. -Backspace + + Choose Sheet - Clear Cells. + + Choose Clear Contents. + + + + + Icon Clear Cells + + + Clear Cells + + +
+ + Backspace
diff --git a/source/text/scalc/00/sheet_menu.xhp b/source/text/scalc/00/sheet_menu.xhp index 7c3f16c683..ca278f7fbf 100644 --- a/source/text/scalc/00/sheet_menu.xhp +++ b/source/text/scalc/00/sheet_menu.xhp @@ -33,6 +33,12 @@ Choose Sheet.
+
+ + Choose Sheet - Cycle Cell Reference Types. + + F4 +
Hide sheet
diff --git a/source/text/scalc/01/02140000.xhp b/source/text/scalc/01/02140000.xhp index b34f0e9a08..2c93bcc03c 100644 --- a/source/text/scalc/01/02140000.xhp +++ b/source/text/scalc/01/02140000.xhp @@ -1,66 +1,63 @@ - - - - - + + + - Fill + Fill /text/scalc/01/02140000.xhp -
- -filling;selection lists - selection lists;filling cells -MW inserted 2 index entries -

Fill

- Automatically fills cells with content. -
-
- -
- The $[officename] Calc context menus have additional options for filling the cells. - - - - -

Sheet

- -

Series

- - -Filling cells using context menus: - - - - Call the context menu when positioned in a cell and choose Selection List. - - - -A list box containing all text found in the current column is displayed. The text is sorted alphabetically and multiple entries are listed only once. - - - Click one of the listed entries to copy it to the cell. - - - + + filling;selection lists + selection lists;filling cells + MW inserted 2 index entries +
+

Fill Cells

+ Automatically fills cells with content. +
+
+ +
+ + + + +

Sheet

+ +

Series

+ + + Filling cells using context menus: + + + + Call the context menu when positioned in a cell and choose Selection List. + + + + A list box containing all text found in the current column is displayed. The text is sorted alphabetically and multiple entries are listed only once. + + + Click one of the listed entries to copy it to the cell. + + +
diff --git a/source/text/scalc/01/02150000.xhp b/source/text/scalc/01/02150000.xhp index 7123a47657..4274401607 100644 --- a/source/text/scalc/01/02150000.xhp +++ b/source/text/scalc/01/02150000.xhp @@ -1,7 +1,4 @@ - - - - - - + -Deleting Contents +Deleting Contents /text/scalc/01/02150000.xhp -
-deleting; cell contents +deleting; cell contents cells; deleting contents spreadsheets; deleting cell contents cell contents; deleting - - - -

Deleting Contents

-Specifies the contents to be deleted from the active cell or from a selected cell range. - If several sheets are selected, all selected sheets will be affected. + + + +
+

Clear Cells

+Specifies the contents to be deleted from the active cell or from a selected cell range. If several sheets are selected, all selected sheets will be affected.
-This dialog is also called by pressing Backspace after the cell cursor has been activated on the sheet. -Pressing Delete deletes content without calling the dialog or changing formats. -Use Cut on the Standard bar to delete contents and formats without the dialog. +This dialog is also called by pressing Backspace after the cell cursor has been activated on the sheet. +Pressing Delete deletes content without calling the dialog or changing formats. +Use Cut on the Standard bar to delete contents and formats without the dialog.

Selection

-This area lists the options for deleting contents. -

Delete All

-Deletes all content from the selected cell range. -

Texti50439

-Deletes text only. Formats, formulas, numbers and dates are not affected. -

Numbers

-Deletes numbers only. Formats and formulas remain unchanged. -

Date & time

-Deletes date and time values. Formats, text, numbers and formulas remain unchanged. -

Formulas

-Deletes formulas. Text, numbers, formats, dates and times remain unchanged. -

Comments

-Deletes comments added to cells. All other elements remain unchanged. -

Formats

-Deletes format attributes applied to cells. All cell content remains unchanged. -

Objects

-Deletes objects. All cell content remains unchanged. +This area lists the options for deleting contents. +

Delete All

+Deletes all content from the selected cell range. +

Texti50439

+Deletes text only. Formats, formulas, numbers and dates are not affected. +

Numbers

+Deletes numbers only. Formats and formulas remain unchanged. +

Date & time

+Deletes date and time values. Formats, text, numbers and formulas remain unchanged. +

Formulas

+Deletes formulas. Text, numbers, formats, dates and times remain unchanged. +

Comments

+Deletes comments added to cells. All other elements remain unchanged. +

Formats

+Deletes format attributes applied to cells. All cell content remains unchanged. +

Objects

+Deletes objects. All cell content remains unchanged. diff --git a/source/text/scalc/01/ToggleRelative.xhp b/source/text/scalc/01/ToggleRelative.xhp new file mode 100644 index 0000000000..dd07a043a1 --- /dev/null +++ b/source/text/scalc/01/ToggleRelative.xhp @@ -0,0 +1,32 @@ + + + + + + + Toggle Relative Adressing + /text/scalc/01/ToggleRelative.xhp + + + + +
+

Cycle Cell Reference Types

+ Cycles between absolute and relative addressing of cell reference in the formula. +
+
+ +
+ +
+ +
+ +
diff --git a/source/text/scalc/guide/relativ_absolut_ref.xhp b/source/text/scalc/guide/relativ_absolut_ref.xhp index fd14ade9e5..e302c97141 100644 --- a/source/text/scalc/guide/relativ_absolut_ref.xhp +++ b/source/text/scalc/guide/relativ_absolut_ref.xhp @@ -19,7 +19,7 @@ -Addresses and References, Absolute and Relative +Addresses and References, Absolute and Relative /text/scalc/guide/relativ_absolut_ref.xhp @@ -27,7 +27,7 @@ -addressing; relative and absolute +addressing; relative and absolute references; absolute/relative absolute addresses in spreadsheets relative addresses @@ -49,17 +49,21 @@

Relative Addressing

-The cell in column A, row 1 is addressed as A1. You can address a range of adjacent cells by first entering the coordinates of the upper left cell of the area, then a colon followed by the coordinates of the lower right cell. For example, the square formed by the first four cells in the upper left corner is addressed as A1:B2. -By addressing an area in this way, you are making a relative reference to A1:B2. Relative here means that the reference to this area will be adjusted automatically when you copy the formulas. +The cell in column A, row 1 is addressed as A1. You can address a range of adjacent cells by first entering the coordinates of the upper left cell of the area, then a colon followed by the coordinates of the lower right cell. For example, the square formed by the first four cells in the upper left corner is addressed as A1:B2. +By addressing an area in this way, you are making a relative reference to A1:B2. Relative here means that the reference to this area will be adjusted automatically when you copy the formulas.

Absolute Addressing

-Absolute referencing is the opposite of relative addressing. A dollar sign is placed before each letter and number in an absolute reference, for example, $A$1:$B$2. -$[officename] can convert the current reference, in which the cursor is positioned in the input line, from relative to absolute and vice versa by pressing F4. If you start with a relative address such as A1, the first time you press this key combination, both row and column are set to absolute references ($A$1). The second time, only the row (A$1), and the third time, only the column ($A1). If you press the key combination once more, both column and row references are switched back to relative (A1) -$[officename] Calc shows the references to a formula. If, for example, you click the formula =SUM(A1:C5;D15:D24) in a cell, the two referenced areas in the sheet will be highlighted in color. For example, the formula component "A1:C5" may be in blue and the cell range in question bordered in the same shade of blue. The next formula component "D15:D24" can be marked in red in the same way. +Absolute referencing is the opposite of relative addressing. A dollar sign is placed before each letter and number in an absolute reference, for example, $A$1:$B$2. + +
+ $[officename] can convert the current reference, in which the cursor is positioned in the input line, from relative to absolute and vice versa by pressing F4. If you start with a relative address such as A1, the first time you press this key combination, both row and column are set to absolute references ($A$1). The second time, only the row (A$1), and the third time, only the column ($A1). If you press the key combination once more, both column and row references are switched back to relative (A1) +
+ +$[officename] Calc shows the references to a formula. If, for example, you click the formula =SUM(A1:C5;D15:D24) in a cell, the two referenced areas in the sheet will be highlighted in color. For example, the formula component "A1:C5" may be in blue and the cell range in question bordered in the same shade of blue. The next formula component "D15:D24" can be marked in red in the same way.

When to Use Relative and Absolute References

-What distinguishes a relative reference? Assume you want to calculate in cell E1 the sum of the cells in range A1:B2. The formula to enter into E1 would be: =SUM(A1:B2). If you later decide to insert a new column in front of column A, the elements you want to add would then be in B1:C2 and the formula would be in F1, not in E1. After inserting the new column, you would therefore have to check and correct all formulas in the sheet, and possibly in other sheets. -Fortunately, $[officename] does this work for you. After having inserted a new column A, the formula =SUM(A1:B2) will be automatically updated to =SUM(B1:C2). Row numbers will also be automatically adjusted when a new row 1 is inserted. Absolute and relative references are always adjusted in $[officename] Calc whenever the referenced area is moved. But be careful if you are copying a formula since in that case only the relative references will be adjusted, not the absolute references. -Absolute references are used when a calculation refers to one specific cell in your sheet. If a formula that refers to exactly this cell is copied relatively to a cell below the original cell, the reference will also be moved down if you did not define the cell coordinates as absolute. -Aside from when new rows and columns are inserted, references can also change when an existing formula referring to particular cells is copied to another area of the sheet. Assume you entered the formula =SUM(A1:A9) in row 10. If you want to calculate the sum for the adjacent column to the right, simply copy this formula to the cell to the right. The copy of the formula in column B will be automatically adjusted to =SUM(B1:B9). +What distinguishes a relative reference? Assume you want to calculate in cell E1 the sum of the cells in range A1:B2. The formula to enter into E1 would be: =SUM(A1:B2). If you later decide to insert a new column in front of column A, the elements you want to add would then be in B1:C2 and the formula would be in F1, not in E1. After inserting the new column, you would therefore have to check and correct all formulas in the sheet, and possibly in other sheets. +Fortunately, $[officename] does this work for you. After having inserted a new column A, the formula =SUM(A1:B2) will be automatically updated to =SUM(B1:C2). Row numbers will also be automatically adjusted when a new row 1 is inserted. Absolute and relative references are always adjusted in $[officename] Calc whenever the referenced area is moved. But be careful if you are copying a formula since in that case only the relative references will be adjusted, not the absolute references. +Absolute references are used when a calculation refers to one specific cell in your sheet. If a formula that refers to exactly this cell is copied relatively to a cell below the original cell, the reference will also be moved down if you did not define the cell coordinates as absolute. +Aside from when new rows and columns are inserted, references can also change when an existing formula referring to particular cells is copied to another area of the sheet. Assume you entered the formula =SUM(A1:A9) in row 10. If you want to calculate the sum for the adjacent column to the right, simply copy this formula to the cell to the right. The copy of the formula in column B will be automatically adjusted to =SUM(B1:B9).
mw changed link target from "address_byname" to "value_with_name"
diff --git a/source/text/scalc/main0116.xhp b/source/text/scalc/main0116.xhp index e2f9f1815a..9e525c979e 100644 --- a/source/text/scalc/main0116.xhp +++ b/source/text/scalc/main0116.xhp @@ -48,8 +48,10 @@ - + + +

Move or Copy Sheet

-- cgit