-
- All Known Implementing Classes:
- AbstractDocument.AbstractElement, AbstractDocument.BranchElement, AbstractDocument.LeafElement, DefaultStyledDocument.SectionElement, HTMLDocument.BlockElement, HTMLDocument.RunElement
public interface Element
Interface to describe a structural piece of a document. It is intended to capture the spirit of an SGML element.
-
-
Method Summary
Methods Modifier and Type Method and Description AttributeSet
getAttributes()
Fetches the collection of attributes this element contains.Document
getDocument()
Fetches the document associated with this element.Element
getElement(int index)
Fetches the child element at the given index.int
getElementCount()
Gets the number of child elements contained by this element.int
getElementIndex(int offset)
Gets the child element index closest to the given offset.int
getEndOffset()
Fetches the offset from the beginning of the document that this element ends at.String
getName()
Fetches the name of the element.Element
getParentElement()
Fetches the parent element.int
getStartOffset()
Fetches the offset from the beginning of the document that this element begins at.boolean
isLeaf()
Is this element a leaf element? An element that may have children, even if it currently has no children, would returnfalse
.
-
-
-
Method Detail
-
getDocument
Document getDocument()
Fetches the document associated with this element.- Returns:
- the document
-
getParentElement
Element getParentElement()
Fetches the parent element. If the element is a root level element returnsnull
.- Returns:
- the parent element
-
getName
String getName()
Fetches the name of the element. If the element is used to represent some type of structure, this would be the type name.- Returns:
- the element name
-
getAttributes
AttributeSet getAttributes()
Fetches the collection of attributes this element contains.- Returns:
- the attributes for the element
-
getStartOffset
int getStartOffset()
Fetches the offset from the beginning of the document that this element begins at. If this element has children, this will be the offset of the first child. As a document position, there is an implied forward bias.- Returns:
- the starting offset >= 0 and < getEndOffset();
- See Also:
Document
,AbstractDocument
-
getEndOffset
int getEndOffset()
Fetches the offset from the beginning of the document that this element ends at. If this element has children, this will be the end offset of the last child. As a document position, there is an implied backward bias.All the default
Document
implementations descend fromAbstractDocument
.AbstractDocument
models an implied break at the end of the document. As a result of this, it is possible for this to return a value greater than the length of the document.- Returns:
- the ending offset > getStartOffset() and <= getDocument().getLength() + 1
- See Also:
Document
,AbstractDocument
-
getElementIndex
int getElementIndex(int offset)
Gets the child element index closest to the given offset. The offset is specified relative to the beginning of the document. Returns-1
if theElement
is a leaf, otherwise returns the index of theElement
that best represents the given location. Returns0
if the location is less than the start offset. ReturnsgetElementCount() - 1
if the location is greater than or equal to the end offset.- Parameters:
offset
- the specified offset >= 0- Returns:
- the element index >= 0
-
getElementCount
int getElementCount()
Gets the number of child elements contained by this element. If this element is a leaf, a count of zero is returned.- Returns:
- the number of child elements >= 0
-
getElement
Element getElement(int index)
Fetches the child element at the given index.- Parameters:
index
- the specified index >= 0- Returns:
- the child element
-
isLeaf
boolean isLeaf()
Is this element a leaf element? An element that may have children, even if it currently has no children, would returnfalse
.- Returns:
- true if a leaf element else false
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/swing/text/element.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.