Geen cache-versie.

Caching uitgeschakeld. Standaardinstelling voor deze pagina:ingeschakeld (code LNG204)
Als het scherm te langzaam is, kunt u de gebruikersmodus uitschakelen om de cacheversie te bekijken.
java.text

Class AttributedString


  • public class AttributedString
    extends Object
    An AttributedString holds text and related attribute information. It may be used as the actual data storage in some cases where a text reader wants to access attributed text through the AttributedCharacterIterator interface.

    An attribute is a key/value pair, identified by the key. No two attributes on a given character can have the same key.

    The values for an attribute are immutable, or must not be mutated by clients or storage. They are always passed by reference, and not cloned.

    Since:
    1.2
    See Also:
    AttributedCharacterIterator, Annotation
    • Constructor Detail

      • AttributedString

        public AttributedString(String text)
        Constructs an AttributedString instance with the given text.
        Parameters:
        text - The text for this attributed string.
        Throws:
        NullPointerException - if text is null.
      • AttributedString

        public AttributedString(String text,
                        Map<? extends AttributedCharacterIterator.Attribute,?> attributes)
        Constructs an AttributedString instance with the given text and attributes.
        Parameters:
        text - The text for this attributed string.
        attributes - The attributes that apply to the entire string.
        Throws:
        NullPointerException - if text or attributes is null.
        IllegalArgumentException - if the text has length 0 and the attributes parameter is not an empty Map (attributes cannot be applied to a 0-length range).
      • AttributedString

        public AttributedString(AttributedCharacterIterator text)
        Constructs an AttributedString instance with the given attributed text represented by AttributedCharacterIterator.
        Parameters:
        text - The text for this attributed string.
        Throws:
        NullPointerException - if text is null.
      • AttributedString

        public AttributedString(AttributedCharacterIterator text,
                        int beginIndex,
                        int endIndex)
        Constructs an AttributedString instance with the subrange of the given attributed text represented by AttributedCharacterIterator. If the given range produces an empty text, all attributes will be discarded. Note that any attributes wrapped by an Annotation object are discarded for a subrange of the original attribute range.
        Parameters:
        text - The text for this attributed string.
        beginIndex - Index of the first character of the range.
        endIndex - Index of the character following the last character of the range.
        Throws:
        NullPointerException - if text is null.
        IllegalArgumentException - if the subrange given by beginIndex and endIndex is out of the text range.
        See Also:
        Annotation
      • AttributedString

        public AttributedString(AttributedCharacterIterator text,
                        int beginIndex,
                        int endIndex,
                        AttributedCharacterIterator.Attribute[] attributes)
        Constructs an AttributedString instance with the subrange of the given attributed text represented by AttributedCharacterIterator. Only attributes that match the given attributes will be incorporated into the instance. If the given range produces an empty text, all attributes will be discarded. Note that any attributes wrapped by an Annotation object are discarded for a subrange of the original attribute range.
        Parameters:
        text - The text for this attributed string.
        beginIndex - Index of the first character of the range.
        endIndex - Index of the character following the last character of the range.
        attributes - Specifies attributes to be extracted from the text. If null is specified, all available attributes will be used.
        Throws:
        NullPointerException - if text is null.
        IllegalArgumentException - if the subrange given by beginIndex and endIndex is out of the text range.
        See Also:
        Annotation
    • Method Detail

      • addAttribute

        public void addAttribute(AttributedCharacterIterator.Attribute attribute,
                        Object value,
                        int beginIndex,
                        int endIndex)
        Adds an attribute to a subrange of the string.
        Parameters:
        attribute - the attribute key
        value - The value of the attribute. May be null.
        beginIndex - Index of the first character of the range.
        endIndex - Index of the character following the last character of the range.
        Throws:
        NullPointerException - if attribute is null.
        IllegalArgumentException - if beginIndex is less then 0, endIndex is greater than the length of the string, or beginIndex and endIndex together don't define a non-empty subrange of the string.
      • addAttributes

        public void addAttributes(Map<? extends AttributedCharacterIterator.Attribute,?> attributes,
                         int beginIndex,
                         int endIndex)
        Adds a set of attributes to a subrange of the string.
        Parameters:
        attributes - The attributes to be added to the string.
        beginIndex - Index of the first character of the range.
        endIndex - Index of the character following the last character of the range.
        Throws:
        NullPointerException - if attributes is null.
        IllegalArgumentException - if beginIndex is less then 0, endIndex is greater than the length of the string, or beginIndex and endIndex together don't define a non-empty subrange of the string and the attributes parameter is not an empty Map.
      • getIterator

        public AttributedCharacterIterator getIterator()
        Creates an AttributedCharacterIterator instance that provides access to the entire contents of this string.
        Returns:
        An iterator providing access to the text and its attributes.
      • getIterator

        public AttributedCharacterIterator getIterator(AttributedCharacterIterator.Attribute[] attributes)
        Creates an AttributedCharacterIterator instance that provides access to selected contents of this string. Information about attributes not listed in attributes that the implementor may have need not be made accessible through the iterator. If the list is null, all available attribute information should be made accessible.
        Parameters:
        attributes - a list of attributes that the client is interested in
        Returns:
        an iterator providing access to the entire text and its selected attributes
      • getIterator

        public AttributedCharacterIterator getIterator(AttributedCharacterIterator.Attribute[] attributes,
                                              int beginIndex,
                                              int endIndex)
        Creates an AttributedCharacterIterator instance that provides access to selected contents of this string. Information about attributes not listed in attributes that the implementor may have need not be made accessible through the iterator. If the list is null, all available attribute information should be made accessible.
        Parameters:
        attributes - a list of attributes that the client is interested in
        beginIndex - the index of the first character
        endIndex - the index of the character following the last character
        Returns:
        an iterator providing access to the text and its attributes
        Throws:
        IllegalArgumentException - if beginIndex is less then 0, endIndex is greater than the length of the string, or beginIndex is greater than endIndex.

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-java/text/attributedstring.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

  1. Bekijk - html-document Taal van het document:fr Manuel PHP : https://docs.oracle.com

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.

Inhoudsopgave Haut