1<?xml version="1.0" encoding="UTF-8"?>
2<fpdoc-descriptions>
3  <package name="SynEdit">
4    <descr>
5      <p>Related Topics:</p>
6      <p>
7        <link id="SynEditTextBase.TextBuffer and Views">TextBuffer and Views  (Virtual Text Representation)</link>
8      </p>
9    </descr>
10    <module name="SynEdit">
11      <element name="TCustomSynEdit.BeginUpdate">
12        <short>Disables updates of internal data strucures, in order to speed up contineous updates. Also disables painting</short>
13        <descr>BeginUpdate disables the updating of many internal values and structures.
14
15If an application want's to apply several changes at once to SynEdit, it should call BeginUpdate. This will speed up the process, as SynEdit only needs to calculate those values once, when all vhanges are applied.
16
17The application must make sure to call EndUpdate once for each time it called BeginUpdate.
18
19While in a BeginUpdate/EndUpdate block SynEdit will not repaint. Any paint request received, will be delayed untill the Endupdate is executed.
20
21SynEdit will trigger OnChangeUpdating, if the update state changes. This is for the most outer calls to Begin/EndUpdate, but not for nested calls.
22
23Some items not updated wile in a Begin/EndUpdate block:
24* Highlight info
25* Fold info
26* CaretPos (will be updated on EndUpdate, to the last caret pos that was requested)
27* Trailing spaces (if trimming is enabled)
28* delay of certain events, like OnStatusChange
29
30This means for example, that setting the caret pos temporarily to a position outside the visible area, will not force an update of the topline, while in update state.
31
32It also allows one to insert code like the begin and end of a multiline comment "(*" / "*)" as 2 separate changes, without folded code below the new comment being affected (even the code would temporarily become a comment, and not have any keywords (begin/end) on which to fold)
33
34</descr>
35      </element>
36      <element name="TCustomSynEdit.EndUpdate">
37        <short>Enable updates  internal data strucures, and applies all changes since BeginUpdate</short>
38      </element>
39      <element name="TCustomSynEdit.MouseOptions">
40        <short>Controls the behaviour of the mouse (mouse-clicks)</short>
41        <seealso>
42          <link id="#SynEdit.SynEdit.TSynEdit.Options">Options</link>
43        </seealso>
44      </element>
45      <element name="TCustomSynEdit.Options">
46        <short>General options to change the SynEdits behaviour</short>
47        <descr>
48          <p>
49            <u>About old/deprecated values for controlling the mouse:</u>
50          </p>
51          <p>They have been moved to <link id="#SynEdit.SynEdit.TSynEdit.MouseOptions">MouseOptions</link>
52          </p>
53          <p>If a new value is set to Options, then MouseOptions are updated only if any of them changed compared to their previous  value in this property (Options), otherwise their value in MouseOptions is kept.
54</p>
55          <p>If MouseOptions is assigned a new value, it will forward clearing any flag that it receives, but not forward setting any flags.
56</p>
57          <p>This means:
58<ul>
59              <li>As long as you only use Options both properties are kept in sync.</li>
60              <li>If you use MouseOptions instead, then you should leave the old flags in this property cleared. Which will allow you to set/change all other flags in this property, without interfering with MouseOptions.</li>
61            </ul>
62          </p>
63        </descr>
64        <seealso>
65          <link id="#SynEdit.SynEdit.TSynEdit.Options2">Options2</link>
66          <link id="#SynEdit.SynEdit.TSynEdit.MouseOptions">MouseOptions</link>
67        </seealso>
68      </element>
69      <element name="TCustomSynEdit.Options2">
70        <seealso>
71          <link id="#SynEdit.SynEdit.TSynEdit.Options">Options</link>
72        </seealso>
73        <short>More general options to change the SynEdits behaviour</short>
74      </element>
75    <element name="TCustomSynEdit.RowColumnToPixels"><short>Converts row, column to pixel on client area</short><descr>The pixel is the leftmost, upmost pixel of the character rectangular area.
76For example row, colum 1,1 translates to 0,0 on client area if there is no gutter, no borderwidth, no scrolling etc.</descr>
77      </element>
78    </module>
79  </package>
80</fpdoc-descriptions>
81