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.