Property Get/Set HTML As String
Generates HTML code of the object. There are a number of limitations on this property the main being that unsupported rich text objects, like embedded views or OLE objects does not get converted and are simply ignored.
In some cases the generated HTML allow more features than standard HTML generated by Domino. The examples are background image in the cell and correctly displaying section as collapsed.
In general the negative sides are:
2. rtLibrary does not generate full HTML page from document - it does not render a document with a particular form, but simply generates HTML from particular item. One solution could be to render document to rich text item, then use rtLibrary to convert this item to HTML. Nevertheless the resulting HTML will be static.
The positive side (apart from a few extra features in comparison with standard Domino rendering) is:
The HTML property is Read/Write. If assigned HTML property is not empty, it is used instead of standard output. It means we can easily customize the result of rendering for particular elements without a need to do it all manually. Like we can assign this property to any object that is unsupported or we want to obtain a different HTML than standard one:
OLE object is unsupported by rtLibrary, however we can find the graphical element inside and create a URL referencing it directly.
Or we can manipulate urls generated by links. The standard way is to use db replica id, view and document universal id to construct the URL (all this is contained in any notelink, so is a natural way to do that). However we may want to use name of the view or document key to do that. rtHotLink class allows access to the document unid, we can use to retrieve the document itself and and obtain the data (like title or category) that allows us to build meaningfully named url.
In case some part of HTML is generated by formula - computed text, computed values of images, targets, urls, the formula is evaluated in context of the last document manipulated. If the item is directly retrieved from a document, it is the document where it is retrieved from, if a whole container or some part gets written to another document (or item) the context document for that part becomes the new document. Additionally all formulas that are contained in rtLabel objects (cell background image name, caption of image, link target, etc.) can have assigned a specific document to use as an evaluation context.