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.hal...@libreoffice.org>
AuthorDate: Fri Jun 25 10:52:15 2021 -0300
Commit:     Olivier Hallot <olivier.hal...@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.hal...@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>
_______________________________________________
Libreoffice-commits mailing list
libreoffice-comm...@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-commits

Reply via email to