com.trolltech.qt.xml
Class QXmlAttributes

java.lang.Object
  extended by com.trolltech.qt.QSignalEmitter
      extended by com.trolltech.qt.QtJambiObject
          extended by com.trolltech.qt.xml.QXmlAttributes
All Implemented Interfaces:
QtJambiInterface

public class QXmlAttributes
extends QtJambiObject

The QXmlAttributes class provides XML attributes.

If attributes are reported by QXmlContentHandler::startElement() this class is used to pass the attribute values.

Use index to locate the position of an attribute in the list, count to retrieve the number of attributes, and clear to remove the attributes. New attributes can be added with append. Use type to get an attribute's type and value to get its value. The attribute's name is available from localName or qName, and its namespace URI from uri.


Nested Class Summary
 
Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter
QSignalEmitter.Signal0, QSignalEmitter.Signal1<A>, QSignalEmitter.Signal2<A,B>, QSignalEmitter.Signal3<A,B,C>, QSignalEmitter.Signal4<A,B,C,D>, QSignalEmitter.Signal5<A,B,C,D,E>, QSignalEmitter.Signal6<A,B,C,D,E,F>, QSignalEmitter.Signal7<A,B,C,D,E,F,G>, QSignalEmitter.Signal8<A,B,C,D,E,F,G,H>, QSignalEmitter.Signal9<A,B,C,D,E,F,G,H,I>
 
Constructor Summary
QXmlAttributes()
          Constructs an empty attribute list.
 
Method Summary
 void append(java.lang.String qName, java.lang.String uri, java.lang.String localPart, java.lang.String value)
          Appends a new attribute entry to the list of attributes.
 void clear()
          Clears the list of attributes.
 int count()
          Returns the number of attributes in the list.
static QXmlAttributes fromNativePointer(QNativePointer nativePointer)
          This function returns the QXmlAttributes instance pointed to by nativePointer
 int index(java.lang.String qName)
          Looks up the index of an attribute by the qualified name qName.
 int index(java.lang.String uri, java.lang.String localPart)
          Looks up the index of an attribute by a namespace name.
 int length()
          Returns the number of attributes in the list.
 java.lang.String localName(int index)
          Looks up an attribute's local name for the attribute at position index.
static QNativePointer nativePointerArray(QXmlAttributes[] array)
          This function returns a QNativePointer that is pointing to the specified QXmlAttributes array.
 java.lang.String qName(int index)
          Looks up an attribute's XML 1.0 qualified name for the attribute at position index.
 java.lang.String type(int index)
          Looks up an attribute's type for the attribute at position index.
 java.lang.String type(java.lang.String qName)
          Looks up an attribute's type for the qualified name qName.
 java.lang.String type(java.lang.String uri, java.lang.String localName)
          Looks up an attribute's type by namespace name.
 java.lang.String uri(int index)
          Looks up an attribute's namespace URI for the attribute at position index.
 java.lang.String value(int index)
          Returns an attribute's value for the attribute at position index.
 java.lang.String value(java.lang.String qName)
          Returns an attribute's value for the qualified name qName, or an empty string if no attribute exists for the name given.
 java.lang.String value(java.lang.String uri, java.lang.String localName)
          Returns an attribute's value by namespace name.
 
Methods inherited from class com.trolltech.qt.QtJambiObject
dispose, disposed, finalize, reassignNativeResources, tr, tr, tr
 
Methods inherited from class com.trolltech.qt.QSignalEmitter
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.trolltech.qt.QtJambiInterface
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership
 

Constructor Detail

QXmlAttributes

public QXmlAttributes()

Constructs an empty attribute list.

Method Detail

append

public final void append(java.lang.String qName,
                         java.lang.String uri,
                         java.lang.String localPart,
                         java.lang.String value)

Appends a new attribute entry to the list of attributes. The qualified name of the attribute is qName, the namespace URI is uri and the local name is localPart. The value of the attribute is value.

See Also:
qName, uri, localName, value

clear

public final void clear()

Clears the list of attributes.

See Also:
append

count

public final int count()

Returns the number of attributes in the list. This function is equivalent to length.


index

public final int index(java.lang.String uri,
                       java.lang.String localPart)

Looks up the index of an attribute by a namespace name.

uri specifies the namespace URI, or an empty string if the name has no namespace URI. localPart specifies the attribute's local name.

Returns the index of the attribute, or -1 if it wasn't found.

See Also:
Support via Features

index

public final int index(java.lang.String qName)

Looks up the index of an attribute by the qualified name qName.

Returns the index of the attribute or -1 if it wasn't found.

See Also:
Support via Features

length

public final int length()

Returns the number of attributes in the list.

See Also:
count

localName

public final java.lang.String localName(int index)

Looks up an attribute's local name for the attribute at position index. If no namespace processing is done, the local name is an empty string.

See Also:
Support via Features

qName

public final java.lang.String qName(int index)

Looks up an attribute's XML 1.0 qualified name for the attribute at position index.

See Also:
Support via Features

type

public final java.lang.String type(int index)

Looks up an attribute's type for the attribute at position index.

Currently only "CDATA" is returned.


type

public final java.lang.String type(java.lang.String qName)

Looks up an attribute's type for the qualified name qName.

Currently only "CDATA" is returned.


type

public final java.lang.String type(java.lang.String uri,
                                   java.lang.String localName)

Looks up an attribute's type by namespace name.

uri specifies the namespace URI and localName specifies the local name. If the name has no namespace URI, use an empty string for uri.

Currently only "CDATA" is returned.


uri

public final java.lang.String uri(int index)

Looks up an attribute's namespace URI for the attribute at position index. If no namespace processing is done or if the attribute has no namespace, the namespace URI is an empty string.

See Also:
Support via Features

value

public final java.lang.String value(java.lang.String uri,
                                    java.lang.String localName)

Returns an attribute's value by namespace name.

uri specifies the namespace URI, or an empty string if the name has no namespace URI. localName specifies the attribute's local name.


value

public final java.lang.String value(java.lang.String qName)

Returns an attribute's value for the qualified name qName, or an empty string if no attribute exists for the name given.

See Also:
Support via Features

value

public final java.lang.String value(int index)

Returns an attribute's value for the attribute at position index. The index must be a valid position (i.e., 0 <= index < count).


fromNativePointer

public static QXmlAttributes fromNativePointer(QNativePointer nativePointer)
This function returns the QXmlAttributes instance pointed to by nativePointer

Parameters:
nativePointer - the QNativePointer of which object should be returned.

nativePointerArray

public static QNativePointer nativePointerArray(QXmlAttributes[] array)
This function returns a QNativePointer that is pointing to the specified QXmlAttributes array.

Parameters:
array - the array that the returned pointer will point to.
Returns:
a QNativePointer that is pointing to the specified array.