Difference between revisions of "LMD VCL - MiniHTML"

From LMD
Jump to: navigation, search
Line 11: Line 11:
 
|-
 
|-
 
| Bold
 
| Bold
−
| <b>, </b>
+
| <code>&lt;b&gt;, &lt;/b&gt;</code>
 
| '''bold'''
 
| '''bold'''
 
|-
 
|-
 
| Italic
 
| Italic
−
| &lt;i&gt;, &lt;/i&gt;
+
| <code>&lt;i&gt;, &lt;/i&gt;</code>
 
| ''italic''
 
| ''italic''
 
|-
 
|-
 
| Underline
 
| Underline
−
| &lt;u&gt;, &lt;/u&gt;
+
| <code>&lt;u&gt;, &lt;/u&gt;</code>
 
| <u>underline</u>
 
| <u>underline</u>
 
|-
 
|-
Line 73: Line 73:
 
| &lt;img src="image" [width="w"] [height="h"]&gt;
 
| &lt;img src="image" [width="w"] [height="h"]&gt;
 
| The ''src'' parameter value is passed to the OnImageNeeded event handler. You can specify the width and height of the image rectangle if needed. By default the width and height are taken from the image you provide in event handler, but you can stretch image on drawing by specifying width and height explicitly.<br>
 
| The ''src'' parameter value is passed to the OnImageNeeded event handler. You can specify the width and height of the image rectangle if needed. By default the width and height are taken from the image you provide in event handler, but you can stretch image on drawing by specifying width and height explicitly.<br>
−
The simplest OnImageNeeded event handlers:<br><br><code>procedure TForm1.LMDHTMLLabel1ImageNeeded(Sender: TObject; SourceName: TLMDString; var Image: TPicture);<br>begin<br>&nbsp;&nbsp;Image.LoadFromFile(SourceName);<br>end;<br><br>procedure TForm1.LMDHTMLLabel1ImageNeeded(Sender: TObject; SourceName: TLMDString; var Image: TPicture);<br>begin<br>&nbsp;&nbsp;ImageList1.GetBitmap(strtoint(SourceName), Image.Bitmap);<br>end;<br></code>
+
The simplest OnImageNeeded event handlers:<br><br>
 +
<pre class="brush:delphi">  
 +
procedure TForm1.LMDHTMLLabel1ImageNeeded(Sender: TObject; SourceName: TLMDString; var Image: TPicture);<br>begin<br>&nbsp;&nbsp;Image.LoadFromFile(SourceName);<br>end;<br><br>procedure TForm1.LMDHTMLLabel1ImageNeeded(Sender: TObject; SourceName: TLMDString; var Image: TPicture);<br>begin<br>&nbsp;&nbsp;ImageList1.GetBitmap(strtoint(SourceName), Image.Bitmap);<br>end;<br></pre>
  
 
|-
 
|-
Line 79: Line 81:
 
| &lt;~~myVariable&gt;
 
| &lt;~~myVariable&gt;
 
| The ''aVarName'', ''aVarValue'' parameters are passed to the OnVariableNeeded event handler, which defines what value substitutes the tag<br>
 
| The ''aVarName'', ''aVarValue'' parameters are passed to the OnVariableNeeded event handler, which defines what value substitutes the tag<br>
−
<br><br><code>
+
<pre class="brush:delphi">  
−
procedure TForm2.LMDHTMLLabel1VariableNeeded(Sender: TObject; const aVarName: TLMDString; var aVarValue: TLMDString);<br>begin<br>  aVarValue := '1111';<br>end;<br></code>
+
procedure TForm2.LMDHTMLLabel1VariableNeeded(Sender: TObject; const aVarName: TLMDString; var aVarValue: TLMDString);
 +
begin
 +
  aVarValue := '1111';
 +
end;
 +
</pre>
 
|-
 
|-
 
| Embedded controls
 
| Embedded controls

Revision as of 05:54, 22 October 2012

<< Back to Getting started or Product Resources page

[edit]

Supported subset of HTML tags

NG HTMLPack and certain controls of other NG Packs (e.g. DialogPack) integrate a Mini HTML engine which supports a subset of HTML tags. Following HTML tags can be used:

Tag Syntax Comments & samples
Bold <b>, </b> bold
Italic <i>, </i> italic
Underline <u>, </u> underline
Strikeout <strikeout>, </strikeout> or <s>, </s> striked out
Paragraph <p [align="left|right|center"]> Use align parameter to specify the alignment of the text in the paragraph. Default value for align is "left".
Subscript <sub>, </sub> Subscript text is drawn with smaller font and with baseline moved down.
Superscript <sup>, </sup> Superscript text is drawn with smaller font and with baseline moved up.
Unordered list of elements <ul><li>item</li>...</ul>
  • item 1
  • item 2
Ordered list of elements <ol><li>item</li>...</ol>
  1. item 1
  2. item 2
Horizontal divider <hr [width="width"]> If no value for width attribute is specified, then it will take maximum available value.
Line break <br>  
Font <font [name="fontname"] [size="x|+x|-x|x px"] [color={"#rrggbb"|"color name"}] [bgcolor={"#rrggbb"|"color name"}]>text</font> You can specify the name of the font name, size (absolute size or increase, decrease of size)

and font background color. Color must be a valid hexadecimal value in common HTML format, valid VCL color identifier (clWhite, clBtnFace for example) or valid HTML color identifier (red, black, btnshadow for example. You can use background synonym for bgcolor attribute.
Note: If size value is greater than 0 and less than 10 and there is no plus or minus sign, then it means standard font increase relative to default size. Example:
<font name="Arial" size=2>
<font name="Arial" size=3>
<font name="Arial" size=4>
In order to specify exact font size in pixels, use size="N px" form of the size attribute.

Hyperlink <a href="link">link text</a> Link parameter value is passed to OnLinkClick event handler, present in some controls (not all controls support clicking on the URLs.
Embedded image <img src="image" [width="w"] [height="h"]> The src parameter value is passed to the OnImageNeeded event handler. You can specify the width and height of the image rectangle if needed. By default the width and height are taken from the image you provide in event handler, but you can stretch image on drawing by specifying width and height explicitly.

The simplest OnImageNeeded event handlers:

 
procedure TForm1.LMDHTMLLabel1ImageNeeded(Sender: TObject; SourceName: TLMDString; var Image: TPicture);<br>begin<br>  Image.LoadFromFile(SourceName);<br>end;<br><br>procedure TForm1.LMDHTMLLabel1ImageNeeded(Sender: TObject; SourceName: TLMDString; var Image: TPicture);<br>begin<br>  ImageList1.GetBitmap(strtoint(SourceName), Image.Bitmap);<br>end;<br>
Variables <~~myVariable> The aVarName, aVarValue parameters are passed to the OnVariableNeeded event handler, which defines what value substitutes the tag
 
procedure TForm2.LMDHTMLLabel1VariableNeeded(Sender: TObject; const aVarName: TLMDString; var aVarValue: TLMDString);
begin
  aVarValue := '1111';
end;
Embedded controls <control vclclass= width= height= name=> Allows embedding of any control into HTML text

Supported special symbols

&Aacute Á &cent ¢ &Iacute Í &oacute ó &sup1 ¹
&aacute á &copy © &iacute í &Ocirc Ô &sup2 ²
&Acirc  &curren ¤ &Icirc Î &ocirc ô &sup3 ³
&acirc â &deg ° &icirc î &Ograve Ò &szlig ß
&acute ´ &divide ÷ &iexcl ¡ &ograve ò &THORN Þ
&AElig Æ &Eacute É &Igrave Ì &ordf ª &times ×
&aelig æ &eacute é &igrave ì &ordm º &trade ™
&Agrave À &Ecirc Ê &iquest ¿ &Oslash Ø &UacuteÚ
&agrave à &ecirc ê &Iuml Ï &oslash ø &uacuteú
&amp & &Egrave È &iuml ï &Otilde Õ &Ucirc Û
&Aring Å &egrave è &laquo « &otilde õ &UgraveÙ
&aring å &ETH Ð &lt < &Ouml Ö &ugraveù
&Atilde à &eth ð &macr ¯ &ouml ö &uml ¨
&atilde ã &Euml Ë &micro µ &para &Uuml Ü
&Auml Ä &euml ë &middot · &plusmn ± &YacuteÝ
&auml ä &euro € &nbsp   &pound £ &yen ¥
&brvbar ¦ &frac12 ½ &not ¬ &quot "   
&Ccedil Ç &frac14 ¼ &Ntilde Ñ &raquo »   
&ccedil ç &frac34 ¾ &ntilde ñ &reg ®   
&cedil ¸ &gt > &Oacute Ó &sect §   
Retrieved from "https://wiki.lmd.de/index.php?title=LMD_VCL_-_MiniHTML&oldid=3219"