Difference between revisions of "LMD NG - MiniHTML"

From LMD
Jump to: navigation, search
(Created page with "{{Head-StartRes}} == 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 o...")
 
Line 76: Line 76:
 
<pre class="brush:delphi">  
 
<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>
 
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>
 +
Additional sources can be:
 +
* connected imagelist. Use syntax: <code><img src="index:0"></code>
 +
* File: Use syntax: <code><img src="file:sample.png"></code>
 +
* Ressource: Use syntax: <code><img src="res:MyImageName"></code>
  
 
|-
 
|-

Revision as of 23:33, 30 January 2013

<< 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>

Additional sources can be:

  • connected imagelist. Use syntax: <img src="index:0">
  • File: Use syntax: <img src="file:sample.png">
  • Ressource: Use syntax: <img src="res:MyImageName">
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

[Top]

Color Names

[Top]

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 §   

[Top]