diff --git a/docs/xml/lazutils/graphtype.xml b/docs/xml/lazutils/graphtype.xml index b5d5ea3146..0469371891 100644 --- a/docs/xml/lazutils/graphtype.xml +++ b/docs/xml/lazutils/graphtype.xml @@ -505,14 +505,14 @@ Init for an unmasked 24 bit RGB image (LSB Blue).

Init_BPP24_B8G8R8_BIO_TTB - initiator for specified format

-
+
 { pf24bit:
   Format=ricfRGBA HasPalette=false Depth=24 PaletteColorCount=0
   BitOrder=riboBitsInOrder ByteOrder=DefaultByteOrder
   LineOrder=riloTopToBottom
   BitsPerPixel=24 LineEnd=rileDWordBoundary
   RedPrec=8 RedShift=16 GreenPrec=8 GreenShift=8 BluePrec=8 BlueShift=0
-}
+}
@@ -520,7 +520,7 @@ Init for a masked 24 bit RGB image (LSB Blue).

Init_BPP24_B8G8R8_M1_BIO_TTB - initiator for specified format

-
+  
   { pf24bit:
     Format=ricfRGBA HasPalette=false Depth=24 PaletteColorCount=0
     BitOrder=riboBitsInOrder ByteOrder=DefaultByteOrder
@@ -528,7 +528,7 @@
     BitsPerPixel=24 LineEnd=rileDWordBoundary
     RedPrec=8 RedShift=16 GreenPrec=8 GreenShift=8 BluePrec=8 BlueShift=0
     Masked
-  }
+ }
@@ -537,7 +537,7 @@

Init_BPP32_B8G8R8_BIO_TTB - initiator for specified format

-
+  
   { pf32bit:
     Format=ricfRGBA HasPalette=false Depth=24 PaletteColorCount=0
     BitOrder=riboBitsInOrder ByteOrder=DefaultByteOrder
@@ -546,7 +546,7 @@
     RedPrec=8 RedShift=16 GreenPrec=8 GreenShift=8 BluePrec=8 BlueShift=0
     No alpha
     No mask
-  }
+ }
@@ -554,7 +554,7 @@

Init_BPP32_B8G8R8_M1_BIO_TTB - initiator for specified format

-
+  
   { pf32bit:
     Format=ricfRGBA HasPalette=false Depth=24 PaletteColorCount=0
     BitOrder=riboBitsInOrder ByteOrder=DefaultByteOrder
@@ -563,7 +563,7 @@
     RedPrec=8 RedShift=16 GreenPrec=8 GreenShift=8 BluePrec=8 BlueShift=0
     no alpha
     with mask
-  }
+ }
@@ -572,7 +572,7 @@

Init_BPP32_B8G8R8A8_BIO_TTB - initiator for specified format

-
+  
   { pf32bit:
     Format=ricfRGBA HasPalette=false Depth=32 PaletteColorCount=0
     BitOrder=riboBitsInOrder ByteOrder=DefaultByteOrder
@@ -581,7 +581,7 @@
     RedPrec=8 RedShift=16 GreenPrec=8 GreenShift=8 BluePrec=8 BlueShift=0
     alpha
     no mask
-  }
+ }
@@ -590,7 +590,7 @@

Init_BPP32_B8G8R8A8_M1_BIO_TTB - initiator for specified format

-
+  
   { pf32bit:
     Format=ricfRGBA HasPalette=false Depth=32 PaletteColorCount=0
     BitOrder=riboBitsInOrder ByteOrder=DefaultByteOrder
@@ -599,7 +599,7 @@
     RedPrec=8 RedShift=16 GreenPrec=8 GreenShift=8 BluePrec=8 BlueShift=0
     alpha
     masked
-  }
+ }
diff --git a/docs/xml/lazutils/laz2_xmlread.xml b/docs/xml/lazutils/laz2_xmlread.xml index b476021f35..c49cd8484f 100644 --- a/docs/xml/lazutils/laz2_xmlread.xml +++ b/docs/xml/lazutils/laz2_xmlread.xml @@ -587,9 +587,9 @@

PublicID is a String property that represent the Public Identifier for content in the XML input source. PublicID contains a value in the following format:

-
+
   [Prefix]//[OwnerID]//[TextClass] [TextDescription]//[Language]//[DisplayVersion]
-
+

Where the components have the following values and meanings:

@@ -634,9 +634,9 @@

For example, the PublicID for DocBook version 5 is:

-
-  -//OASIS//DTD DocBook V5.0//EN
-          
+ +-//OASIS//DTD DocBook V5.0//EN +

Use SystemID to get the URI (or URL) for the resource.

diff --git a/docs/xml/lazutils/laz2_xmlutils.xml b/docs/xml/lazutils/laz2_xmlutils.xml index 27004c47c2..9ea3578c85 100644 --- a/docs/xml/lazutils/laz2_xmlutils.xml +++ b/docs/xml/lazutils/laz2_xmlutils.xml @@ -149,11 +149,11 @@

IsValidXmlEncoding is a Boolean function used to determine if the value specified in Value is a valid XML encoding name. The encoding name is used in the XML declaration for a document. For instance:

-
<?xml encoding='UTF-8'?>
+ <?xml encoding='UTF-8'?>

or:

-
<?xml encoding='EUC-JP'?>
+ <?xml encoding='EUC-JP'?> diff --git a/docs/xml/lazutils/lazstringutils.xml b/docs/xml/lazutils/lazstringutils.xml index c205d0fa95..748a1fac4c 100644 --- a/docs/xml/lazutils/lazstringutils.xml +++ b/docs/xml/lazutils/lazstringutils.xml @@ -499,7 +499,7 @@

BeautifyLineXY is a String function used to combine the values in the Filename, Line, X and Y arguments into a formatted message. The message is in the form:

-
examplefile.pas (123, 1) The error message goes here.
+examplefile.pas (123, 1) The error message goes here.

Filename contains a file name used at the start of the formatted message.

diff --git a/docs/xml/lazutils/lazutf16.xml b/docs/xml/lazutils/lazutf16.xml index 6e4e50a084..6efb2be610 100644 --- a/docs/xml/lazutils/lazutf16.xml +++ b/docs/xml/lazutils/lazutf16.xml @@ -206,14 +206,15 @@ Based on the specification defined by the Unicode consortium, at: http://unicode.org/faq/utf_bom.html#utf16-7

-
+

Q: Are there any 16-bit values that are invalid? - +

+

A: Unpaired surrogates are invalid in UTFs. These include any value in the range D800 to DBFF not followed by a value in the range DC00 to DFFF, or any value in the range DC00 to DFFF not preceded by a value in the range D800 to DBFF. [AF] -

+

Use ANextChar = #0 to indicate that there is no next char.

diff --git a/docs/xml/lcl/controls.xml b/docs/xml/lcl/controls.xml index c5017a4c73..4cf7590203 100644 --- a/docs/xml/lcl/controls.xml +++ b/docs/xml/lcl/controls.xml @@ -4615,12 +4615,12 @@

Class holding the reference sides of the anchors of a TControl. Every TControl has four AnchorSides: AnchorSide[akLeft], AnchorSide[akRight], AnchorSide[akTop] and AnchorSide[akBottom]. Normally if Anchors contain akLeft, and the Parent is resized, the LCL tries to keep the distance between the left side of the control and the right side of its parent client area. With AnchorSide[akLeft] you can define a different reference side. The kept distance is defined by the BorderSpacing. For example:

-
-       +-----+  +-----+
-       |  B  |  |  C  |
-       |     |  +-----+
-       +-----+
-          
+ ++-----+ +-----+ +| B | | C | +| | +-----+ ++-----+ +

If you want to have the top of B the same as the top of C use

@@ -4642,13 +4642,13 @@

Another example:

-
-                  +-------+
-            +---+ |       |
-            | A | |   B   |
-            +---+ |       |
-                  +-------+
-          
+ + +-------+ ++---+ | | +| A | | B | ++---+ | | + +-------+ +

Centering A relative to B:

@@ -16129,78 +16129,106 @@ if MyControl.CanSetFocus then

Docking means here: Combining several windows to one. A window can here be a TCustomForm or a floating control (undocked) or a TDockForm. A window can be docked to another to the left, right, top, bottom or "into". The docking source window will be resized, to fit to the docking target window.

-
-    Example1: Docking "A" (source window) left to "B" (target window)
+          

+ Example1: Docking "A" (source window) left to "B" (target window) +

+ ++---+ +----+ +| A | -> | B | ++---+ | | + +----+ + +

+ Result: A new docktree will be created. Height of "A" will be resized to the height of "B". A splitter will be inserted between "A" and "B". And all three are children of the newly created TLazDockForm of the newly created TDockTree. +

+ ++------------+ +|+---+|+----+| +|| A ||| B || +|| ||| || +|+---+|+----+| ++------------+ + + +

+ Analog for docking "C" left to "A": +

+ ++------------------+ +|+---+|+---+|+----+| +|| C ||| A ||| B || +|| ||| ||| || +|+---+|+---+|+----+| ++------------------+ + +

+ Example2: Docking A into B +

+ + +-----+ ++---+ | | +| A | ---+-> B | ++---+ | | + +-----+ + +

+ Result: A new docktree will be created. "A" will be resized to the size of "B". Both will be put into a TLazDockPages control which is the child of the newly created TDockTree. +

+ ++-------+ +|[B][A] | +|+-----+| +|| || +|| A || +|| || +|+-----+| ++-------+ + +

+ Every DockZone has siblings and children. Siblings can either be: +

+ +

+ InsertControl - undock a control and dock it into the dock site. + For example, to dock Form1 left to a Form2: +

+ InsertControl(Form1,alLeft,Form2); +

+ To dock into a TDockPage, use: +

+ Align=alCustom; +

+ PositionDockRect - calculates where a control would be placed, if it would + be docked via InsertControl. +

+

+ RemoveControl - removes a control from the dock site. +

- +---+ +----+ - | A | -> | B | - +---+ | | - +----+ - Result: A new docktree will be created. Height of "A" will be resized to - the height of "B". - A splitter will be inserted between "A" and "B". - And all three are children of the newly created TLazDockForm of the - newly created TDockTree. - - +------------+ - |+---+|+----+| - || A ||| B || - || ||| || - |+---+|+----+| - +------------+ - - If "A" or "B" were floating controls, the floating dock sites are freed. - If "A" or "B" were forms, their decorations (title bars and borders) are - replaced by docked decorations. - If "A" had a TDockTree, it is freed and its child dockzones are merged to - the docktree of "B". Analog for docking "C" left to "A": - - +------------------+ - |+---+|+---+|+----+| - || C ||| A ||| B || - || ||| ||| || - |+---+|+---+|+----+| - +------------------+ - - - Example2: Docking A into B - +-----+ - +---+ | | - | A | ---+-> B | - +---+ | | - +-----+ - - Result: A new docktree will be created. "A" will be resized to the size - of "B". Both will be put into a TLazDockPages control which is the - child of the newly created TDockTree. - - +-------+ - |[B][A] | - |+-----+| - || || - || A || - || || - |+-----+| - +-------+ - - Every DockZone has siblings and children. Siblings can either be - - horizontally (left to right, splitter), - - vertically (top to bottom, splitter) - - or upon each other (as notebook pages). - - InsertControl - undock control and dock it into the dock site. For example - dock Form1 left to a Form2: - InsertControl(Form1,alLeft,Form2); - To dock "into", into a TDockPage, use Align=alCustom. - PositionDockRect - calculates where a control would be placed, if it would - be docked via InsertControl. - RemoveControl - removes a control from the dock site. - - GetControlBounds - TODO for Delphi compatibility - ResetBounds - TODO for Delphi compatibility - SetReplacingControl - TODO for Delphi compatibility - PaintSite - TODO for Delphi compatibility -
+

+ GetControlBounds - TODO: for Delphi compatibility. +

+

+ ResetBounds - TODO: for Delphi compatibility. +

+

+ SetReplacingControl - TODO: for Delphi compatibility. +

+

+ PaintSite - TODO: for Delphi compatibility. +

@@ -16236,7 +16264,7 @@ if MyControl.CanSetFocus then - Returns the control and the part of the dockzone at the given coordinates + Returns the control and the part of the dockzone at the given coordinates. @@ -16659,7 +16687,7 @@ AControl.Align := AnchorAlign[alRight]; // contains [akRight, akTop, akBottom] - Gets the control at the specified screen position + Gets the control at the specified screen position.

@@ -16831,7 +16859,7 @@ AControl.Align := AnchorAlign[alRight]; // contains [akRight, akTop, akBottom] CancelDrag is a procedure used to cancel an active drag operation. CancelDrag calls the DragStop method in the currently active DragManager.

- Please note: No actions are performed in the routine when DragManager has been assigned (contains Nil), or when DrageManager returns False from the IsDragging method. + No actions are performed in the routine when DragManager has been assigned (contains Nil), or when DragManager returns False from its IsDragging method.
@@ -16843,7 +16871,7 @@ AControl.Align := AnchorAlign[alRight]; // contains [akRight, akTop, akBottom] - Set the mouse capture to AWinControl or its child at the given coordinates + Set the mouse capture to AWinControl or its child at the given coordinates. @@ -16860,7 +16888,7 @@ AControl.Align := AnchorAlign[alRight]; // contains [akRight, akTop, akBottom] - Returns the current capturing TControl instance + Returns the current capturing TControl instance.

@@ -16889,7 +16917,7 @@ AControl.Align := AnchorAlign[alRight]; // contains [akRight, akTop, akBottom] - Returns a string for the name of the cursor as identified by an integer constant + Returns a string for the name of the cursor as identified by an integer constant. Calls CursorToIdent to find correct entry in look-up table. @@ -16907,7 +16935,7 @@ AControl.Align := AnchorAlign[alRight]; // contains [akRight, akTop, akBottom] - StringToCursor - returns the cursor value corresponding to the name supplied + StringToCursor - returns the cursor value corresponding to the name supplied.

@@ -16936,7 +16964,7 @@ AControl.Align := AnchorAlign[alRight]; // contains [akRight, akTop, akBottom] - Uses look-up table to find cursor identifier corresponding to integer cursor constant + Uses look-up table to find cursor identifier corresponding to integer cursor constant. @@ -16953,7 +16981,7 @@ AControl.Align := AnchorAlign[alRight]; // contains [akRight, akTop, akBottom] - Searches the Cursor name table for the given cursor name; returns True if found + Searches the Cursor name table for the given cursor name; returns True if found. If found, the cursor value (handle) is returned in Cursor. @@ -16971,7 +16999,7 @@ AControl.Align := AnchorAlign[alRight]; // contains [akRight, akTop, akBottom] - Checks whether the handle for a windowed control (or a parent control) is transparent + Checks whether the handle for a windowed control (or a parent control) is transparent.

@@ -17228,7 +17256,7 @@ AControl.Align := AnchorAlign[alRight]; // contains [akRight, akTop, akBottom] - Register the components provided by this unit or package, so that they can be instantiated + Register the components provided by this unit or package, so that they can be instantiated.

@@ -17245,7 +17273,7 @@ AControl.Align := AnchorAlign[alRight]; // contains [akRight, akTop, akBottom] - AutoSize - boolean property that permits the size of a control to be adjusted automatically + AutoSize - boolean property that permits the size of a control to be adjusted automatically.

@@ -17519,10 +17547,10 @@ BoundsRect.Left:=3; // WRONG: common newbie mistake Example1 If you want to have the top of B the same as the top of C: - +-----+ +-----+ - | B | | C | - | | +-----+ - +-----+ ++-----+ +-----+ +| B | | C | +| | +-----+ ++-----+ use B.AnchorSide[akTop].Control:=C; diff --git a/docs/xml/lcl/filectrl.xml b/docs/xml/lcl/filectrl.xml index 02994701e7..6cac15796d 100644 --- a/docs/xml/lcl/filectrl.xml +++ b/docs/xml/lcl/filectrl.xml @@ -786,8 +786,8 @@

When AAddDescription = True and AAddFilter = False, the following values would be stored in AStrings:

-
Text files (*.txt *.pas)
-Binaries (*.exe)
+Text files (*.txt *.pas) +Binaries (*.exe)

Adapted from the converter initially created for QtWSDialogs.pas.

diff --git a/docs/xml/lcl/shellctrls.xml b/docs/xml/lcl/shellctrls.xml index dd3d7cb1f8..5d09432430 100644 --- a/docs/xml/lcl/shellctrls.xml +++ b/docs/xml/lcl/shellctrls.xml @@ -1275,7 +1275,7 @@

Mask is a String property used to supply a mask which determines the file system objects displayed in the shell control. Mask can contain one or more mask values delimited by the Semicolon (';') character. For example:

-
*.exe; br*.com; c??.*
+ *.exe; br*.com; c??.*

Changing the value in Mask causes the Clear method to be called for the shell control. In addition, the Items property calls its Clear method to remove entries stored in the property. The PopulateWithRoot method is called to re-populate the shell control using the new mask value.

@@ -1693,15 +1693,15 @@

For TObjectTypes, a string is built to represents the set type using the format:

-
[otFolders,otNonFolders,otHidden]
+ [otFolders,otNonFolders,otHidden]

For TMaskCaseSensitivity, a string version of the enumeration value is used as the return value. For example:

- + 'mcsPlatformDefault' 'mcsCaseInsensitive' 'mcsCaseSensitive' - +