Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Methods](https://developer.android.com/reference/android/sax/Element#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/sax/Element#inhmethods)

# Element

*** ** * ** ***

` public class Element `   
` extends https://developer.android.com/reference/java/lang/Object ` ` `

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.sax.Element |

Known direct subclasses [RootElement](https://developer.android.com/reference/android/sax/RootElement) [RootElement](https://developer.android.com/reference/android/sax/RootElement) The root XML element.   

*** ** * ** ***

An XML element. Provides access to child elements and hooks to listen for events related to this element.
**See also:**

- `https://developer.android.com/reference/android/sax/RootElement`

## Summary

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/sax/Element` | ` https://developer.android.com/reference/android/sax/Element#getChild(java.lang.String)(https://developer.android.com/reference/java/lang/String localName) ` Gets the child element with the given name. |
| ` https://developer.android.com/reference/android/sax/Element` | ` https://developer.android.com/reference/android/sax/Element#getChild(java.lang.String,%20java.lang.String)(https://developer.android.com/reference/java/lang/String uri, https://developer.android.com/reference/java/lang/String localName) ` Gets the child element with the given name. |
| ` https://developer.android.com/reference/android/sax/Element` | ` https://developer.android.com/reference/android/sax/Element#requireChild(java.lang.String)(https://developer.android.com/reference/java/lang/String localName) ` Gets the child element with the given name. |
| ` https://developer.android.com/reference/android/sax/Element` | ` https://developer.android.com/reference/android/sax/Element#requireChild(java.lang.String,%20java.lang.String)(https://developer.android.com/reference/java/lang/String uri, https://developer.android.com/reference/java/lang/String localName) ` Gets the child element with the given name. |
| ` void` | ` https://developer.android.com/reference/android/sax/Element#setElementListener(android.sax.ElementListener)(https://developer.android.com/reference/android/sax/ElementListener elementListener) ` Sets start and end element listeners at the same time. |
| ` void` | ` https://developer.android.com/reference/android/sax/Element#setEndElementListener(android.sax.EndElementListener)(https://developer.android.com/reference/android/sax/EndElementListener endElementListener) ` Sets a listener for the end of this element. |
| ` void` | ` https://developer.android.com/reference/android/sax/Element#setEndTextElementListener(android.sax.EndTextElementListener)(https://developer.android.com/reference/android/sax/EndTextElementListener endTextElementListener) ` Sets a listener for the end of this text element. |
| ` void` | ` https://developer.android.com/reference/android/sax/Element#setStartElementListener(android.sax.StartElementListener)(https://developer.android.com/reference/android/sax/StartElementListener startElementListener) ` Sets a listener for the start of this element. |
| ` void` | ` https://developer.android.com/reference/android/sax/Element#setTextElementListener(android.sax.TextElementListener)(https://developer.android.com/reference/android/sax/TextElementListener elementListener) ` Sets start and end text element listeners at the same time. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/sax/Element#toString()() ` Returns a string representation of the object. |

### Inherited methods

From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `

Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `

Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class<?>` ` https://developer.android.com/reference/java/lang/Object#getClass()() `

Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `

Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `

Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `

Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `

Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.

## Public methods

### getChild

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Element getChild (String localName)
```

Gets the child element with the given name. Uses an empty string as the namespace.

<br />

| Parameters ||
|---|---|
| `localName` | `String` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/sax/Element` | <br /> |

### getChild

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Element getChild (String uri, 
                String localName)
```

Gets the child element with the given name.

<br />

| Parameters ||
|---|---|
| `uri` | `String` <br /> |
| `localName` | `String` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/sax/Element` | <br /> |

### requireChild

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Element requireChild (String localName)
```

Gets the child element with the given name. Uses an empty string as the namespace. We will throw a `https://developer.android.com/reference/org/xml/sax/SAXException` at parsing time if the specified child is missing. This helps you ensure that your listeners are called.

<br />

| Parameters ||
|---|---|
| `localName` | `String` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/sax/Element` | <br /> |

### requireChild

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Element requireChild (String uri, 
                String localName)
```

Gets the child element with the given name. We will throw a `https://developer.android.com/reference/org/xml/sax/SAXException` at parsing time if the specified child is missing. This helps you ensure that your listeners are called.

<br />

| Parameters ||
|---|---|
| `uri` | `String` <br /> |
| `localName` | `String` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/sax/Element` | <br /> |

### setElementListener

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public void setElementListener (ElementListener elementListener)
```

Sets start and end element listeners at the same time.

<br />

| Parameters ||
|---|---|
| `elementListener` | `ElementListener` <br /> |

### setEndElementListener

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public void setEndElementListener (EndElementListener endElementListener)
```

Sets a listener for the end of this element.

<br />

| Parameters ||
|---|---|
| `endElementListener` | `EndElementListener` <br /> |

### setEndTextElementListener

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public void setEndTextElementListener (EndTextElementListener endTextElementListener)
```

Sets a listener for the end of this text element.

<br />

| Parameters ||
|---|---|
| `endTextElementListener` | `EndTextElementListener` <br /> |

### setStartElementListener

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public void setStartElementListener (StartElementListener startElementListener)
```

Sets a listener for the start of this element.

<br />

| Parameters ||
|---|---|
| `startElementListener` | `StartElementListener` <br /> |

### setTextElementListener

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public void setTextElementListener (TextElementListener elementListener)
```

Sets start and end text element listeners at the same time.

<br />

| Parameters ||
|---|---|
| `elementListener` | `TextElementListener` <br /> |

### toString

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String toString ()
```

Returns a string representation of the object.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | a string representation of the object. <br /> |