GdomeAttr

Name

GdomeAttr -- Interface Attr implementation.

Synopsis



struct      GdomeAttr;
void        gdome_a_ref                     (GdomeAttr *self,
                                             GdomeException *exc);
void        gdome_a_unref                   (GdomeAttr *self,
                                             GdomeException *exc);
gpointer    gdome_a_query_interface         (GdomeAttr *self,
                                             const char *interface,
                                             GdomeException *exc);
GdomeDOMString* gdome_a_name                (GdomeAttr *self,
                                             GdomeException *exc);
GdomeElement* gdome_a_ownerElement          (GdomeAttr *self,
                                             GdomeException *exc);
GdomeBoolean gdome_a_specified              (GdomeAttr *self,
                                             GdomeException *exc);
GdomeDOMString* gdome_a_value               (GdomeAttr *self,
                                             GdomeException *exc);
void        gdome_a_set_value               (GdomeAttr *self,
                                             GdomeDOMString *value,
                                             GdomeException *exc);
GdomeDOMString* gdome_a_nodeName            (GdomeAttr *self,
                                             GdomeException *exc);
GdomeDOMString* gdome_a_nodeValue           (GdomeAttr *self,
                                             GdomeException *exc);
void        gdome_a_set_nodeValue           (GdomeAttr *self,
                                             GdomeDOMString *nodeValue,
                                             GdomeException *exc);
unsigned short gdome_a_nodeType             (GdomeAttr *self,
                                             GdomeException *exc);
GdomeNode*  gdome_a_parentNode              (GdomeAttr *self,
                                             GdomeException *exc);
GdomeNodeList* gdome_a_childNodes           (GdomeAttr *self,
                                             GdomeException *exc);
GdomeNode*  gdome_a_firstChild              (GdomeAttr *self,
                                             GdomeException *exc);
GdomeNode*  gdome_a_lastChild               (GdomeAttr *self,
                                             GdomeException *exc);
GdomeNode*  gdome_a_previousSibling         (GdomeAttr *self,
                                             GdomeException *exc);
GdomeNode*  gdome_a_nextSibling             (GdomeAttr *self,
                                             GdomeException *exc);
GdomeNamedNodeMap* gdome_a_attributes       (GdomeAttr *self,
                                             GdomeException *exc);
GdomeDocument* gdome_a_ownerDocument        (GdomeAttr *self,
                                             GdomeException *exc);
GdomeNode*  gdome_a_insertBefore            (GdomeAttr *self,
                                             GdomeNode *newChild,
                                             GdomeNode *refChild,
                                             GdomeException *exc);
GdomeNode*  gdome_a_replaceChild            (GdomeAttr *self,
                                             GdomeNode *newChild,
                                             GdomeNode *oldChild,
                                             GdomeException *exc);
GdomeNode*  gdome_a_removeChild             (GdomeAttr *self,
                                             GdomeNode *oldChild,
                                             GdomeException *exc);
GdomeNode*  gdome_a_appendChild             (GdomeAttr *self,
                                             GdomeNode *newChild,
                                             GdomeException *exc);
GdomeBoolean gdome_a_hasChildNodes          (GdomeAttr *self,
                                             GdomeException *exc);
GdomeNode*  gdome_a_cloneNode               (GdomeAttr *self,
                                             GdomeBoolean deep,
                                             GdomeException *exc);
void        gdome_a_normalize               (GdomeAttr *self,
                                             GdomeException *exc);
GdomeBoolean gdome_a_isSupported            (GdomeAttr *self,
                                             GdomeDOMString *feature,
                                             GdomeDOMString *version,
                                             GdomeException *exc);
GdomeDOMString* gdome_a_namespaceURI        (GdomeAttr *self,
                                             GdomeException *exc);
GdomeDOMString* gdome_a_prefix              (GdomeAttr *self,
                                             GdomeException *exc);
void        gdome_a_set_prefix              (GdomeAttr *self,
                                             GdomeDOMString *prefix,
                                             GdomeException *exc);
GdomeDOMString* gdome_a_localName           (GdomeAttr *self,
                                             GdomeException *exc);
GdomeBoolean gdome_a_hasAttributes          (GdomeAttr *self,
                                             GdomeException *exc);
void        gdome_a_addEventListener        (GdomeAttr *self,
                                             GdomeDOMString *type,
                                             GdomeEventListener *listener,
                                             GdomeBoolean useCapture,
                                             GdomeException *exc);
void        gdome_a_removeEventListener     (GdomeAttr *self,
                                             GdomeDOMString *type,
                                             GdomeEventListener *listener,
                                             GdomeBoolean useCapture,
                                             GdomeException *exc);
GdomeBoolean gdome_a_dispatchEvent          (GdomeAttr *self,
                                             GdomeEvent *evt,
                                             GdomeException *exc);
void        gdome_a_subTreeDispatchEvent    (GdomeAttr *self,
                                             GdomeEvent *evt,
                                             GdomeException *exc);
GdomeBoolean gdome_a_canAppend              (GdomeAttr *self,
                                             GdomeNode *newChild,
                                             GdomeException *exc);

Description

The GdomeAttr interface represents an attribute in an GdomeElement object. Typically the allowable values for the attribute are defined in a document type definition.

GdomeAttr objects inherit the GdomeNode interface, but since they are not actually child nodes of the element they describe, the DOM does not consider them part of the document tree. Thus, the methods gdome_a_parentNode(), gdome_a_previousSibling(), and gdome_a_nextSibling(), have a NULL value for GdomeAttr objects. The DOM takes the view that attributes are properties of elements rather than having a separate identity from the elements they are associated with. Furthermore, GdomeAttr nodes may not be immediate children of a GdomeDocumentFragment. However, they can be associated with GdomeElement nodes contained within a GdomeDocumentFragment. In short, users of the DOM need to be aware that GdomeAttr nodes have some things in common with other objects inheriting the GdomeNode interface, but they also are quite distinct.

The attribute's effective value is determined as follows: if this attribute has been explicitly assigned any value, that value is the attribute's effective value; otherwise, if there is a declaration for this attribute, and that declaration includes a default value, then that default value is the attribute's effective value; otherwise, the attribute does not exist on this element in the structure model until it has been explicitly added.

Note: Note that the gdome_a_nodeValue() method on the GdomeAttr instance can also be used to retrieve the string version of the attribute's value(s).

In XML, where the value of an attribute can contain entity references, the child nodes of the GdomeAttr node may be either GdomeText or GdomeEntityReference nodes (when these are in use; see the description of GdomeEntity for discussion). Because the DOM Core is not aware of attribute types, it treats all attribute values as simple strings, even if the DTD or schema declares them as having tokenized types.

Details

struct GdomeAttr

struct GdomeAttr {
	gpointer user_data;
};


gdome_a_ref ()

void        gdome_a_ref                     (GdomeAttr *self,
                                             GdomeException *exc);

Increase the reference count of the specified Node.

self : Node Object ref
exc : Exception Object ref


gdome_a_unref ()

void        gdome_a_unref                   (GdomeAttr *self,
                                             GdomeException *exc);

Decrease the reference count of the specified Node. Free the Node structure if the Node will have zero reference.

self : Node Object ref
exc : Exception Object ref


gdome_a_query_interface ()

gpointer    gdome_a_query_interface         (GdomeAttr *self,
                                             const char *interface,
                                             GdomeException *exc);

self : Node Object ref
interface : interface needed
exc : Exception Object ref
Returns : a reference to this object that implements the interface needed, or NULL if the interface is not supported by this Object.


gdome_a_name ()

GdomeDOMString* gdome_a_name                (GdomeAttr *self,
                                             GdomeException *exc);

self : Attr Object ref
exc : Exception Object ref
Returns : the qualified name of this attribute.


gdome_a_ownerElement ()

GdomeElement* gdome_a_ownerElement          (GdomeAttr *self,
                                             GdomeException *exc);

self : Attr Object ref
exc : Exception Object ref
Returns : the Element node this attribute is attached to or NULL if this attribute is not in use.


gdome_a_specified ()

GdomeBoolean gdome_a_specified              (GdomeAttr *self,
                                             GdomeException *exc);

NOT IMPLEMENTED

self : Attr Object ref
exc : Exception Object ref
Returns : TRUE


gdome_a_value ()

GdomeDOMString* gdome_a_value               (GdomeAttr *self,
                                             GdomeException *exc);

self : Attr Object ref
exc : Exception Object ref
Returns : the value of this attribute.


gdome_a_set_value ()

void        gdome_a_set_value               (GdomeAttr *self,
                                             GdomeDOMString *value,
                                             GdomeException *exc);

Sets the value of this attribute.

GDOME_NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

self : Attr Object ref
value : The new value to set
exc : Exception Object ref


gdome_a_nodeName ()

GdomeDOMString* gdome_a_nodeName            (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : the name of this node, depending on its type.


gdome_a_nodeValue ()

GdomeDOMString* gdome_a_nodeValue           (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : the value of this node, depending on its type.


gdome_a_set_nodeValue ()

void        gdome_a_set_nodeValue           (GdomeAttr *self,
                                             GdomeDOMString *nodeValue,
                                             GdomeException *exc);

Sets The value of this node, depending on its type.

GDOME_NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

self : Node Object ref
nodeValue : The new value for this node.
exc : Exception Object ref


gdome_a_nodeType ()

unsigned short gdome_a_nodeType             (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : an integer bigger than 0 representing the type of the underlying object or 0 on error.


gdome_a_parentNode ()

GdomeNode*  gdome_a_parentNode              (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : the parent of this node. All nodes, except Attr, Document, DocumentFragment, Entity, and Notation may have a parent. However, if a node has just been created and not yet added to the tree, or if it has been removed from the tree, this is NULL.


gdome_a_childNodes ()

GdomeNodeList* gdome_a_childNodes           (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : a NodeList that contains all children of this node. If there are no children, this is a NodeList containing no nodes. Note that attributes are not considered to be children of element nodes - use gdome_n_attributes to obtain the attributes.


gdome_a_firstChild ()

GdomeNode*  gdome_a_firstChild              (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : the first child of this node. If there is no such node, this returns NULL.


gdome_a_lastChild ()

GdomeNode*  gdome_a_lastChild               (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : the last child of this node. If there is no such node, this returns NULL.


gdome_a_previousSibling ()

GdomeNode*  gdome_a_previousSibling         (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : the node immediately preceding this node. If there is no such node, this returns NULL.


gdome_a_nextSibling ()

GdomeNode*  gdome_a_nextSibling             (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : the node immediately following this node. If there is no such node, this returns NULL.


gdome_a_attributes ()

GdomeNamedNodeMap* gdome_a_attributes       (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : a NamedNodeMap containing the attributes of this node (if it is an Element) or NULL otherwise.


gdome_a_ownerDocument ()

GdomeDocument* gdome_a_ownerDocument        (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Objects ref
exc : Exception Object ref
Returns : the documment object associated with this node. This is also the Document object used to create new nodes. When this node is a Document or a DocumentType which is not used with any Document yet, this is NULL.


gdome_a_insertBefore ()

GdomeNode*  gdome_a_insertBefore            (GdomeAttr *self,
                                             GdomeNode *newChild,
                                             GdomeNode *refChild,
                                             GdomeException *exc);

Inserts the node newChild before the existing child node refChild. If refChild is NULL, insert newChild at the end of the list of children. If newChild is a DocumentFragment node, all of its children are inserted, in the same order, before refChild. If the newChild is already in the tree, it is first removed.

GDOME_HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type of the newChild node, or if the node to insert is one of this node's ancestors or this node itself. GDOME_WRONG_DOCUMENT_ERR: Raised if newChild was created from a different document than the one that created this node. GDOME_NOT_FOUND_ERR: Raised if refChild is not a child of this node. GDOME_NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

self : Node Object ref
newChild : The new node to put in the child list
refChild : the reference node, i.e., the node before which the new node must be inserted.
exc : Exception Object ref
Returns : the node being inserted.


gdome_a_replaceChild ()

GdomeNode*  gdome_a_replaceChild            (GdomeAttr *self,
                                             GdomeNode *newChild,
                                             GdomeNode *oldChild,
                                             GdomeException *exc);

Replaces the child node oldChild with newChild in the list of children, and returns the oldChild node. If newChild is a DocumentFragment object, oldChild is replaced by all of the DocumentFragment children, which are inserted in the same order. If the newChild is already in the tree, it is first removed.

GDOME_HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type of the newChild node, or if the node to put in is one of this node's ancestors or this node itself. GDOME_WRONG_DOCUMENT_ERR: Raised if newChild was created from a different document than the one that created this node. GDOME_NOT_FOUND_ERR: Raised if oldChild is not a child of this node. GDOME_NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

self : Node Object ref
newChild : The new node to put in the child list
oldChild : The node being replaced in the list
exc : Exception Object ref
Returns : the node replaced.


gdome_a_removeChild ()

GdomeNode*  gdome_a_removeChild             (GdomeAttr *self,
                                             GdomeNode *oldChild,
                                             GdomeException *exc);

Removes the child node indicated by oldChild from the list of children, and returns it.

GDOME_NOT_FOUND_ERR: Raised if oldChild is not a child of this node. GDOME_NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

self : Node Object ref
oldChild : The node being removed
exc : Exception Object ref
Returns : the node removed.


gdome_a_appendChild ()

GdomeNode*  gdome_a_appendChild             (GdomeAttr *self,
                                             GdomeNode *newChild,
                                             GdomeException *exc);

Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed. If it is a DocumentFragment node, the entire contents of the document fragment are moved into the child list of this node

GDOME_HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type of the newChild node, or if the node to append is one of this node's ancestors or this node itself. GDOME_WRONG_DOCUMENT_ERR: Raised if newChild was created from a different document than the one that created this node. GDOME_NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

self : Node Object ref
newChild : The node to add
exc : Exception Object ref
Returns : the node added.


gdome_a_hasChildNodes ()

GdomeBoolean gdome_a_hasChildNodes          (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : TRUE if this node has any children, FALSE otherwise.


gdome_a_cloneNode ()

GdomeNode*  gdome_a_cloneNode               (GdomeAttr *self,
                                             GdomeBoolean deep,
                                             GdomeException *exc);

Makes a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent; (parentNode is NULL). GDOME_DOCUMENT_TYPE_NODE, GDOME_NOTATION_NODE and GDOME_ENTITY_NODE nodes are not supported.

GDOME_NOT_SUPPORTED_ERR: Raised if the type of node being cloned is not supported.

self : Node Object ref
deep : If true, recursively clone the subtree under the specified node; if false, clone only the node itself (and its attributes, if it is an Element).
exc : Exception Object ref
Returns : the duplicate node.


gdome_a_normalize ()

void        gdome_a_normalize               (GdomeAttr *self,
                                             GdomeException *exc);

Puts all Text nodes in the full depth of the sub-tree underneath this Node, including attribute nodes, into a "normal" form where only structure (e.g., elements, comments, processing instructions, CDATA sections, and entity references) separates Text nodes, i.e., there are neither adjacent Text nodes nor empty Text nodes.

self : Node Object ref
exc : Exception Object ref


gdome_a_isSupported ()

GdomeBoolean gdome_a_isSupported            (GdomeAttr *self,
                                             GdomeDOMString *feature,
                                             GdomeDOMString *version,
                                             GdomeException *exc);

Tests whether the DOM implementation implements a specific feature and that feature is supported by this node.

self : Node Object ref
feature : The name of the feature to test.
version : This is the version number of the feature to test. In Level 2, version 1, this is the string "2.0". If the version is not specified, supporting any version of the feature will cause the method to return TRUE.
exc : Exception Object ref
Returns : TRUE if the specified feature is supported on this node, FALSE otherwise.


gdome_a_namespaceURI ()

GdomeDOMString* gdome_a_namespaceURI        (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Objects ref
exc : Exception Object ref
Returns : the namespace URI of this node, or NULL if it is unspecified. For nodes of any type other than GDOME_ELEMENT_NODE and GDOME_ATTRIBUTE_NODE and nodes created with a DOM Level 1 method, this is always NULL.


gdome_a_prefix ()

GdomeDOMString* gdome_a_prefix              (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Objects ref
exc : Exception Object ref
Returns : the namespace prefix of this node, or NULL if it is unspecified. For nodes of any type other than GDOME_ELEMENT_NODE and GDOME_ATTRIBUTE_NODE and nodes created with a DOM Level 1 method, this is always NULL.


gdome_a_set_prefix ()

void        gdome_a_set_prefix              (GdomeAttr *self,
                                             GdomeDOMString *prefix,
                                             GdomeException *exc);

Sets a new nemaspace prefix for this node.

GDOME_NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. GDOME_NAMESPACE_ERR: Raised if the specified prefix is malformed per the Namespaces in XML specification, if the namespaceURI of this node is NULL, if the specified prefix is "xml" and the namespaceURI of this node is different from "http://www.w3.org/XML/1998/namespace", if this node is an attribute and the specified prefix is "xmlns" and the namespaceURI of this node is different from "http://www.w3.org/2000/xmlns/", or if this node is an attribute and the qualifiedName of this node is "xmlns".

self : Node Object ref
prefix : The new prefix for this node.
exc : Exception Object ref


gdome_a_localName ()

GdomeDOMString* gdome_a_localName           (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Objects ref
exc : Exception Object ref
Returns : the local part of the qualified name of this node. For nodes of any type other than GDOME_ELEMENT_NODE and GDOME_ATTRIBUTE_NODE and nodes created with a DOM Level 1 method, this is always NULL.


gdome_a_hasAttributes ()

GdomeBoolean gdome_a_hasAttributes          (GdomeAttr *self,
                                             GdomeException *exc);

self : Node Object ref
exc : Exception Object ref
Returns : TRUE if this node has any attributes, FALSE otherwise.


gdome_a_addEventListener ()

void        gdome_a_addEventListener        (GdomeAttr *self,
                                             GdomeDOMString *type,
                                             GdomeEventListener *listener,
                                             GdomeBoolean useCapture,
                                             GdomeException *exc);

This method allows the registration of event listeners on the event target. If an EventListener is added to an EventTarget while it is processing an event, it will not be triggered by the current actions but may be triggered during a later stage of event flow, such as the bubbling phase. If multiple identical EventListeners are registered on the same EventTarget with the same parameters the duplicate instances are discarded. They do not cause the EventListener to be called twice and since they are discarded they do not need to be removed with the removeEventListener method.

self : Node Object ref
type : the event type for which the user is registering
listener : the listener parameter takes an interface implemented by the user which contains the methods to be called when the event occurs.
useCapture : if TRUE, useCapture indicates that the user wishes to initiate capture. After initiating capture, all events of the specified type will be dispatched to the registered EventListener before being dispatched to any EventTargets beneath them in the tree. Events which are bubbling upward through the tree will not trigger an EventListener designated to use capture.
exc : Exception Object ref


gdome_a_removeEventListener ()

void        gdome_a_removeEventListener     (GdomeAttr *self,
                                             GdomeDOMString *type,
                                             GdomeEventListener *listener,
                                             GdomeBoolean useCapture,
                                             GdomeException *exc);

This method allows the removal of event listeners from the event target. If an EventListener is removed from an EventTarget while it is processing an event, it will not be triggered by the current actions. EventListeners can never be invoked after being removed. Calling removeEventListener with arguments which do not identify any currently registered EventListener on the EventTarget has no effect.

self : Node Object ref
type : Specifies the event type of the EventListener being removed.
listener : The EventListener parameter indicates the EventListener to be removed.
useCapture : Specifies whether the EventListener being removed was registered as a capturing listener or not. If a listener was registered twice, one with capture and one without, each must be removed separately. Removal of a capturing listener does not affect a non-capturing version of the same listener, and vice versa.
exc : Exception Object ref


gdome_a_dispatchEvent ()

GdomeBoolean gdome_a_dispatchEvent          (GdomeAttr *self,
                                             GdomeEvent *evt,
                                             GdomeException *exc);

This method allows the dispatch of events into the implementations event model. Events dispatched in this manner will have the same capturing and bubbling behavior as events dispatched directly by the implementation. The target of the event is the EventTarget on which dispatchEvent is called.

GDOME_UNSPECIFIED_EVENT_TYPE_ERR: Raised if the Event's type was not specified by initializing the event before dispatchEvent was called. Specification of the Event's type as NULL or an empty string will also trigger this exception.

self : Node Object ref
evt : Specifies the event type, behavior, and contextual information to be used in processing the event.
exc : Exception Object ref
Returns : if preventDefault was called the value is FALSE, else the value is TRUE.


gdome_a_subTreeDispatchEvent ()

void        gdome_a_subTreeDispatchEvent    (GdomeAttr *self,
                                             GdomeEvent *evt,
                                             GdomeException *exc);

This method allows the dispatch of events into the implementations event model. Events dispatched in this manner will have the same capturing and bubbling behavior as events dispatched directly by the implementation. The target of the event is any nodes in the subtree of the EventTarget on which dispatchEvent is called.

GDOME_UNSPECIFIED_EVENT_TYPE_ERR: Raised if the Event's type was not specified by initializing the event before dispatchEvent was called. Specification of the Event's type as NULL or an empty string will also trigger this exception.

self : Node Object ref
evt : Specifies the event type, behavior, and contextual information to be used in processing the event.
exc : Exception Object ref


gdome_a_canAppend ()

GdomeBoolean gdome_a_canAppend              (GdomeAttr *self,
                                             GdomeNode *newChild,
                                             GdomeException *exc);

Tests if a newChild can be added in the child list of this node.

self : Node Object ref
newChild : The Node Object ref of the node to test
exc : Exception Object ref
Returns : TRUE if newChild can be added, FALSE otherwise.