Description
Sets the DOCTYPE declaration of this document.
Syntax
pbdom_document_name.SetDocType(pbdom_doctype pbdom_doctype_ref)
Argument |
Description |
---|---|
pbdom_document_name |
The name of a PBDOM_DOCUMENT object |
pbdom_doctype_ref |
A PBDOM_DOCTYPE object to be set as the DOCTYPE of this document |
Return value
PBDOM_DOCUMENT. The same PBDOM_DOCUMENT object with a modified DOCTYPE declaration.
Throws
EXCEPTION_INVALID_ARGUMENT -- The input PBDOM_DOCTYPE is invalid. This can happen if it has not been initialized properly or is a null object reference.
EXCEPTION_USE_OF_UNNAMED_PBDOM_OBJECT -- The input PBDOM_DOCTYPE is nameable and has not been given a user-defined name.
EXCEPTION_WRONG_DOCUMENT_ERROR -- The input PBDOM_DOCTYPE already has an owner document.
EXCEPTION_PBDOM_OBJECT_ALREADY_HAS_PARENT -- The input PBDOM_DOCTYPE is already the DOCTYPE of another document.
Usage
If this document already contains a DOCTYPE declaration, the new PBDOM_DOCTYPE replaces it. The DOCTYPE of a PBDOM_DOCUMENT object can be changed multiple times, and it is legal for a user to call the SetDocType method multiple times.
A DOM DOCTYPE object can have no owner document, or it can have an owner document but no parent node. A DOCTYPE that has an owner document as well as a parent node is the actual DOCTYPE of the owner document.