Currently viewing: GipsySoft » Front Page» QHTM

QHTM - Supported HTML Tags

[Implementation Notes] [Enhancements] [Defaults] [Tags]

QHTM Support and Restrictions

Most of the restrictions are related to either speed or complexity. In most cases they will not trouble you at all. If any of the restrictions or unsupported features bother you then drop me a line and I am sure we can work something out.

Image file formats supported are BMP, PNG, MNG, JPEG, PCX and GIF, if you use GIF you will a licence from Unisys. If you have the source code to QHTM to can compile versions without the extra image file formats or indeed you can add your own.

QHTM displays tables, and tables (or entire documents) within tables etc..

There is no scripting or dynamic HTML. It does not have column or row spanning, if you want this effect then tables within tables should work as desired

Implementation Notes

Links starting with '#' are deemed to be internal to the current document and will not attempt to link to a separate document. Any other links will go through a callback and/or will open a new browser window.

None of the usual stuff in the header of the HTML needs to be present, this includes the HTML and BODY tag. This means a valid HTML document as far as QHTM is concerned can be as little as "Hello my name is <b>QHTM</b>". Having no need of the usual HTML preamble makes using the control substantially easier. HTML files saved in this format are still usable from within the usual set of browsers as long as the correct file name extension is used. QHTM Will ignore most of the HTML header section anyhow.

Enhancements

Extensions to HTML provided by QHTM are few, where they are present they usually serve to make life easier. They don't interfere with standard HTML so if you don't use them they do nothing!

Defaults

The defaults are important because it will allow us to put less code into the actual HTML files, and therefore have to store/download less. All defaults can be overridden in the HTML documents.
Font is Tahoma.
Size is 3
foreground colour is black.
Background colour is the same as the dialog background ( ::GetSysColor( COLOR_3DFACE ) )
Image alignment is top
HR alignment is left.
Paragraph alignment is left
Table alignment is left

 

Character Sets

QHTM supports the following character sets:

  • windows-1250
  • windows-1251
  • windows-1252
  • windows-1253
  • windows-1254
  • windows-1255
  • windows-1256
  • windows-1257
  • gb2312
  • windows-OEM

[TOP]

Tags

BODY

The tag is not required.

Attributes
BGCOLOR
Sets the background colour of a page.
LINK
Sets default colour of links
ALINK
Sets default colour link with the mouse over it
MARGINLEFT
QHTM Extension. Sets left margin used in the control.
MARGINTOP
QHTM Extension. Sets top margin used in the control.
MARGINRIGHT
QHTM Extension. Sets right margin used in the control.
MARGINBOTTOM
QHTM Extension. Sets bottom margin used in the control.
BACKGROUND
Sets the background image to be used

FONT

Attributes
FACE
Fully supported
COLOR
Fully supported
BGCOLOR
QHTM extension that allows you to set the background colour of text
SIZE
Fully supported. QHTM Extension - can have numbers specifying a point size e.g. "10pt"

B

Fully supported

STRONG

Fully supported - Same as B

U

Fully supported

I

Fully supported

EM

Fully supported - Interpreted the same as italic.

STRIKE

Fully supported

DEL

Fully supported - Treated the same as STRIKE

PRE

Fully supported

XMP

Fully supported - Treated the same as PRE

SUP

Fully supported

SUB

Fully supported

TT

Fully supported - renders in fixed pitch font

[TOP]

CENTER

- No attributes, fully supported

DIV

Attributes
ALIGN
Fully supported

P

The end tag is not needed.

Attributes
ALIGN
Fully supported

H1

Create a new paragraph, font size 7, 2-line space before and after, bold, centre alignment

H2

Create a new paragraph, font size 5, 2-line space before and after, bold, left alignment

H3

Create a new paragraph, font size 3, 2-line space before and after, italic, left alignment

H4

Create a new paragraph, font size 3, 1-line space before and after, bold, left alignment

H5

Create a new paragraph, font size 3, 1-line space before and after, italic, left alignment

H6

Create a new paragraph, font size 2, 2-line space before and after, bold, left alignment

LI

Supported whilst in lists.

Attributes
VALUE
The index for this item.

OL

Ordered lists are supported

Attributes
TYPE
Type can be "A", "a" , "I" or "I"
COMPACT
Reduces the indentation of the items

UL

Unordered lists are supported

Attributes
TYPE
Type can be "circle", "square" or "disc"

DL

Definition list - fully supported

DT

Definition list term - fully supported

DD

Definition list definition - fully supported

BR

Forced line break - fully supported

[TOP]

IMG

Attributes
SRC
Fully supported. If an image name starts with RES: then it is deemed to exist in resources associated with loading that page.
WIDTH
Fully supported
HEIGHT
Fully supported
ALIGN
Default is bottom. Left, right top and middle are fully supported. Left and right alignments mean text flows around the image.
TRANSPARENT-COLOR
QHTM extension that forces any image to use the colour specified as transparent.

FORM

Pretty much everything in FORM and FORM input fields is supported. If you find something that isn't supported let me know and I'll take a look.

[TOP]

TABLE

Attributes
WIDTH
Width is supported both as pixels and as a percentage of the remaining margin space.
ALIGN
Table alignment is supported but the behaviour of text that wraps around the table if the table is right or left aligned is not fully supported.
VALIGN
QHTM Extension - Top, middle and bottom supported, applies to the entire table.
BORDER
Fully supported.
BGCOLOR
Fully supported.
BORDERCOLOR
Fully supported.
BORDERCOLORLIGHT
Fully supported.
BORDERCOLORDARK
Fully supported.
CELLPADDING
Fully supported.
CELLSPACING
Fully supported.

 

[TOP]

TR

Currently all cells are top aligned.

Attributes
VALIGN
Top, middle and bottom supported, if set overrides the value set in the TABLE tag.

[TOP]

TD

Attributes
WIDTH
Supported as either pixels or a percentage of the table width.
BGCOLOR
Fully supported.
BORDERCOLOR
Fully supported.
BORDERCOLORLIGHT
Fully supported.
BORDERCOLORDARK
Fully supported.
VALIGN
Top, middle and bottom supported, if set overrides the value set in the TABLE tag.
ALIGN
Left, center, right.

[TOP]

HR

Attributes
WIDTH
Supports either pixels or percent.
SIZE
Pixels, default to 3
NOSHADE
Fully supported.
ALIGN
Left, right and center fully supported
COLOR
Fully supported

[TOP]

A

Both named sections and hyperlinks can be used, this document uses names to specify the destination of a link within this page. External links can also be used. QHTM will use a callback when a user selects a hyperlink.

Attributes
NAME
Fully supported.
HREF
Fully supported.
'#' is an internal link and QHTM handles these without calling back to your application.
TITLE
Fully supported. This includes adding HTML into the tip.