[Libreoffice-commits] help.git: source/text
Olivier Hallot (via logerrit)
logerrit at kemper.freedesktop.org
Fri Jun 25 14:01:36 UTC 2021
source/text/shared/00/00000005.xhp | 18 +++++++++++++++++-
source/text/shared/02/01170103.xhp | 10 ++++++----
2 files changed, 23 insertions(+), 5 deletions(-)
New commits:
commit a09c6d5edbbd00da7ff34685cf83bf9a6fd47af8
Author: Olivier Hallot <olivier.hallot at libreoffice.org>
AuthorDate: Fri Jun 25 10:52:15 2021 -0300
Commit: Olivier Hallot <olivier.hallot at libreoffice.org>
CommitDate: Fri Jun 25 16:01:15 2021 +0200
tdf#105089 explain "item status changed" and "focus"
Change-Id: I8b10f71e0de80f645edcd17bcae9ad5d27093a78
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/117897
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot at libreoffice.org>
diff --git a/source/text/shared/00/00000005.xhp b/source/text/shared/00/00000005.xhp
index 6e10b8d0f..22540d7f9 100644
--- a/source/text/shared/00/00000005.xhp
+++ b/source/text/shared/00/00000005.xhp
@@ -86,7 +86,7 @@
<h2 xml-lang="en-US" id="hd_id3150439">Direct and Style Formatting</h2>
<paragraph role="paragraph" id="par_id431619103899855">A style is a set of formatting attributes, grouped and identified by a name (the style name). When you apply a style to an object, the object is formatted with the set of attributes of the style. Several objects of same nature can have the same style. As consequence, when you change the set of formatting attributes of the style, all objects associated with the style also change their formatting attributes accordingly. Use styles to uniformly format a large set of paragraphs, cells, and objects and better manage the formatting of documents.</paragraph>
<paragraph xml-lang="en-US" id="par_id3159254" role="paragraph">When you do not use styles, and apply formatting attributes to parts of text directly, this is called Direct formatting (also called manual formatting). The formatting is applied only to the selected area of the document. If the document has several paragraphs, frames, or any other object, you apply direct formatting on each object. Direct formatting is available with the Format menu and with the Formatting toolbar.</paragraph>
- <paragraph role="paragraph" id="par_id971619105747398">A direct formatting attribute applied on a object overrides the corresponding attribute of the style applied to the object.</paragraph>
+ <paragraph role="paragraph" id="par_id971619105747398">A direct formatting attribute applied on a object overrides the corresponding attribute of the style applied to the object.</paragraph>
</section>
<section id="docking">
<bookmark xml-lang="en-US" branch="index" id="bm_id3155132"><bookmark_value>windows; docking definition</bookmark_value>
@@ -251,6 +251,22 @@
<paragraph xml-lang="en-US" id="par_id3152946" role="paragraph">If you choose to save relatively, the references to embedded graphics or other objects in your document will be saved relative to the location in the file system. In this case, it does not matter where the referenced directory structure is recorded. The files will be found regardless of location, as long as the reference remains on the same drive or volume. This is important if you want to make the document available to other computers that may have a completely different directory structure, drive or volume names. It is also recommended to save relatively if you want to create a directory structure on an Internet server.</paragraph>
<paragraph xml-lang="en-US" id="par_id3148927" role="paragraph">If you prefer absolute saving, all references to other files will also be defined as absolute, based on the respective drive, volume or root directory. The advantage is that the document containing the references can be moved to other directories or folders, and the references remain valid.</paragraph>
</section>
+ <section id="form_focus">
+ <h2 id="hd_id381624628286724">Focus</h2>
+ <paragraph role="paragraph" id="par_id61624628294382">In an form document, a control must receive focus from the user in order to become active and perform its tasks. For example, users must give focus to a text box in order to enter text into it.</paragraph>
+ <paragraph role="paragraph" id="par_id511624628298935">There are several ways to give focus to a control:</paragraph>
+ <list type="unordered">
+ <listitem>
+ <paragraph id="par_id301624628318973" role="listitem">Designate the control with a mouse or any pointing device.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id191624628327510" role="listitem">Navigate from one control to the next with the keyboard. The document's author may define a tabbing order that specifies the order in which controls will receive focus if the user navigates the document with the keyboard. Once selected, a control may be activated by some other key sequence.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id351624628336039" role="listitem">Select a control through an access key (sometimes called "keyboard shortcut" or "keyboard accelerator").</paragraph>
+ </listitem>
+ </list>
+ </section>
<section id="spin_button">
<h2 xml-lang="en-US" id="hd_id3152414">Spin button</h2>
<embed href="text/shared/00/00000001.xhp#spinbutton"/>
diff --git a/source/text/shared/02/01170103.xhp b/source/text/shared/02/01170103.xhp
index 4994301db..366b987ea 100644
--- a/source/text/shared/02/01170103.xhp
+++ b/source/text/shared/02/01170103.xhp
@@ -39,6 +39,8 @@
<embed href="text/shared/00/00040501.xhp#control_properties_events"/>
</section>
<paragraph xml-lang="en-US" id="par_id3149732" role="paragraph">Depending on the control, different events are available. Only the available events for the selected control and context are listed on the <emph>Events</emph> tab page.<br/>The following events are defined:</paragraph>
+
+
<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_EVT_APPROVEACTIONPERFORMED" id="bm_id3153252" localize="false"/>
<h2 id="hd_id3149191">Approve action<comment>renamed from Before commencing, issue 97356</comment></h2>
<paragraph xml-lang="en-US" id="par_id3153717" role="paragraph"><ahelp hid=".">This event takes place before an action is triggered by clicking the control.</ahelp> For example, clicking a "<emph>Submit</emph>" button initiates a send action; however, the actual "send" process is started only when the <emph>When initiating</emph> event occurs. The <emph>Approve action</emph> event allows you to kill the process. If the linked method sends back FALSE, <emph>When initiating</emph> will not be executed.</paragraph>
@@ -47,19 +49,19 @@
<paragraph xml-lang="en-US" id="par_id3145609" role="paragraph"><ahelp hid=".">The <emph>Execute action</emph> event occurs when an action is started.</ahelp> For example, if you have a "<emph>Submit</emph>" button in your form, the send process represents the action to be initiated.</paragraph>
<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_EVT_CHANGED" id="bm_id3154924" localize="false"/>
<h2 id="hd_id3156343">Changed</h2>
- <paragraph xml-lang="en-US" id="par_id3148755" role="paragraph"><ahelp hid=".">The <emph>Changed</emph> event takes place when the control loses the focus and the content of the control has changed since it lost the focus.</ahelp></paragraph>
+<paragraph xml-lang="en-US" id="par_id3148755" role="paragraph"><ahelp hid=".">The <emph>Changed</emph> event takes place when the control loses the <link href="text/shared/00/00000005.xhp#form_focus" name="focus">focus</link> and the content of the control has changed since it lost the focus.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_EVT_TEXTCHANGED" id="bm_id3147084" localize="false"/>
<h2 id="hd_id3153524">Text modified</h2>
<paragraph xml-lang="en-US" id="par_id3150495" role="paragraph"><ahelp hid=".">The <emph>Text modified</emph> event takes place if you enter or modify a text in an input field.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_EVT_ITEMSTATECHANGED" id="bm_id3154910" localize="false"/>
<h2 id="hd_id3154123">Item status changed</h2>
- <paragraph xml-lang="en-US" id="par_id3150870" role="paragraph"><ahelp hid="." visibility="hidden">The <emph>Item status changed</emph> event takes place if the status of the control field has changed.</ahelp> The <emph>Item status changed</emph> event takes place if the status of the control field has changed.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3150870" role="paragraph">The <emph>Item status changed</emph> event takes place if the status of the control field has changed, for example, from checked to unchecked.</paragraph>
<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_EVT_FOCUSGAINED" id="bm_id3158407" localize="false"/>
<h2 id="hd_id3151176">When receiving focus</h2>
- <paragraph xml-lang="en-US" id="par_id3154218" role="paragraph"><ahelp hid=".">The <emph>When receiving focus</emph> event takes place if a control field receives the focus.</ahelp></paragraph>
+ <paragraph xml-lang="en-US" id="par_id3154218" role="paragraph"><ahelp hid=".">The <emph>When receiving focus</emph> event takes place if a control field receives the <link href="text/shared/00/00000005.xhp#form_focus" name="focus">focus</link>.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_EVT_FOCUSLOST" id="bm_id3154684" localize="false"/>
<h2 id="hd_id3150447">When losing focus</h2>
- <paragraph xml-lang="en-US" id="par_id3159252" role="paragraph"><ahelp hid=".">The <emph>When losing focus</emph> event takes place if a control field loses the focus.</ahelp></paragraph>
+ <paragraph xml-lang="en-US" id="par_id3159252" role="paragraph"><ahelp hid=".">The <emph>When losing focus</emph> event takes place if a control field loses the <link href="text/shared/00/00000005.xhp#form_focus" name="focus">focus</link>.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_EVT_KEYTYPED" id="bm_id3145787" localize="false"/>
<h2 id="hd_id3147287">Key pressed</h2>
<paragraph xml-lang="en-US" id="par_id3152940" role="paragraph"><ahelp hid=".">The <emph>Key pressed</emph> event occurs when the user presses any key while the control has the focus.</ahelp> This event may be linked to a macro for checking entries.</paragraph>
More information about the Libreoffice-commits
mailing list