Html_Page_Remote_Create()
Abstract
Creates an HTML page that is "remote". Remote pages serve as reference targets for links in other pages.
Syntax
Html_Page_Remote_Create (remote_url, options)
| Argument | Type | Description |
|---|---|---|
remote_url |
char * |
URL string for the target page of interest |
options |
int |
currently unsupported; reserved for future use |
Return Type
HtmlT_Page *
pointer to a page object; required by many other APIs in the HTML package
Header
html.h
Details
When setting the target of a link, that target must be a page that "exists" inside of the HTML package. Remote pages have not been created through the package, and therefore some way of linking to them is needed. This function is used to create a page object in such situations. Essentially, this function encapsulates a URL into an HtmlT_Page object. The target is simply a URL that is known a priori.