Quellcodebibliothek Statistik Leitseite products/Sources/formale Sprachen/JAVA/Netbeans/platform/openide.util.ui/   (Apache JAVA IDE Version 28©)  Datei vom 3.10.2025 mit Größe 98 kB image not shown  

Quelle  apichanges.xml   Sprache: XML

 
<?xml version="1.0" encoding="UTF-8"?>
<!--

    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.

-->

<!DOCTYPE apichanges PUBLIC "-//NetBeans//DTD API changes list 1.0//EN" "../../nbbuild/javadoctools/apichanges.dtd">
<apichanges>
<apidefs>
    <apidef name="util">Utilities API</apidef>
    <apidef name="xml">XML API</apidef>
    <apidef name="actions">Actions API</apidef>
</apidefs>
<changes>
    <change id="moreImageUtilsForHiDPI">
      <api name="util"/>
      <summary>Added methods to ImageUtilities, to aid migration from other icon loading methods.</summary>
      <version major="9" minor="36"/>
      <date day="5" month="1" year="2025"/>
      <author login="ebakke"/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="yes"/>
      <description>
            <p>Added new utility methods to ImageUtilities to ease migration from other image loading methods used throughout the NetBeans codebase.
            Loading icons via ImageUtilities is preferred as it permits alternative SVG versions to be loaded automatically when available.</p>
       </description>
       <class package="org.openide.util" name="ImageUtilities"/>
    </change>

    <change id="mouseKeyCodes">
      <api name="util"/>
      <summary>Added methods to query mouse event pseudo-keycodes</summary>
      <version major="9" minor="31"/>
      <date day="25" month="9" year="2023"/>
      <author login="neilcsmith"/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="yes"/>
      <description>
            <p>
               Added methods to query the existing pseudo-keycodes assigned to mouse wheel events, and new pseudo-keycodes added
               for extended mouse buttons.
            </p>
       </description>
       <class package="org.openide.util" name="Utilities"/>
    </change>
    <change id="findDialogParent2">
         <api name="util"/>
         <summary>static method Utilities.findDialogParent overloaded and isModalDialogOpen added</summary>
         <version major="9" minor="30"/>
         <date day="26" month="5" year="2023"/>
         <author login="rkeen-siemens"/>
         <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="yes"/>
         <description>
             <p>
                 Updated <code>findDialogParent</code> to ensure that if a modal dialog is open the returned component is in that dialog
                 and added an overload that allows providing a fallback component.
                 Added <code>isModalDialogOpen</code> to determine if there is a modal dialog open.
             </p>
         </description>
         <class package="org.openide.util" name="Utilities"/>
    </change>
    <change id="actionsForPathLookup">
         <api name="util"/>
         <summary>Added variant Utilities.actionsForPath with Lookup that produces context-aware actions</summary>
         <version major="9" minor="28"/>
         <date day="5" month="1" year="2023"/>
         <author login="sdedic"/>
         <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
         <description>
             <p>
                 Added a variant <a href="@TOP@/org/openide/util/Utilities.html#actionsForPath(java.lang.String,org.openide.util.Lookup)">actionsToPath</a> that instantiates context-bound actions if the registered action(s) implements 
                 <a href="@TOP@/org/openide/util/ContextAwareAction.html">ContextAwareAction</a>.
                 Improves consistency with <a href="@TOP@/org/openide/util/Utilities.html#actionsToPopup(javax.swing.Action%5B%5D,org.openide.util.Lookup)">actionsToPopup</a> that supports contextual actions. 
             </p>
         </description>
         <class package="org.openide.util" name="Utilities"/>
    </change>
    <change id="findDialogParent">
         <api name="util"/>
         <summary>static method Utilities.findDialogParent added</summary>
         <version major="9" minor="26"/>
         <date day="15" month="10" year="2022"/>
         <author login="errael"/>
         <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
         <description>
             <p>
                 Added <code>findDialogParent</code> to provide a parent component for standard swing dialog displayers
                 such as <code>JOptionPane</code> and <code>JFileChooser</code>.
                 This method first checks <code>KeyboardFocusManager</code>, then uses an active frame.
             </p>
         </description>
         <class package="org.openide.util" name="Utilities"/>
    </change>
    <change id="propertyURL">
      <api name="util"/>
      <summary>Declaration of long-used URL image property</summary>  
      <version major="9" minor="24"/>
      <date year="2021" month="1" day="15"/>
      <author login="sdedic"/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible"/>
      <description>
          The property <code>url</code> is documented in Javadoc <b>since 8.12</b> but the key string was not
          added to the API. <a href="@TOP@/org/openide/util/ImageUtilities.html#PROPERTY_URL">It is now</a>, along with a 
          <a href="@TOP@/org/openide/util/ImageUtilities.html#findImageBaseURL(java.awt.Image)">convenience method</a>, which should be used in preference.
      </description>
      <class package="org.openide.util" name="ImageUtilities"/>
    </change>
    <change id="SVGLoader">
      <api name="util"/>
      <summary>Support loading of SVG icons for scalable rendering on HiDPI displays.</summary>
      <version major="9" minor="15"/>
      <date year="2019" month="11" day="24"/>
      <author login="ebakke"/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible"/>
      <description>
        <p>
            As a part of the effort to make NetBeans look better on HiDPI displays, the
            ImageUtilities class has now been completely updated to support scalable implementations
            of the java.awt.Icon interface, and to support loading of icons and images from SVG
            files. If an SVG file resource exists with the same base name as an existing bitmap
            icon, the SVG file will be loaded instead (e.g. "icon.svg" will be loaded instead of
            "icon.png"). SVG file resources can also be loaded explicitly.
        </p>
        <p>
            To avoid bloating the core platform modules with large JAR libraries, the actual loading
            and parsing of SVG files is implemented in a separate, optional module, which is lazily
            loaded the first time that an SVG file is encountered for loading. A new interface
            SVGLoader has been added to serve as an SPI for said module to implement. Furthermore,
            the CachedHiDPIIcon helper class has been made public to assist in the implementation of
            this and other scalable Icon implementations.
        </p>
      </description>
      <issue number="NETBEANS-2604"/>
    </change>
    <change id="VectorIcon">
      <api name="util"/>
      <summary>Added abstract class VectorIcon to support creation of custom-painted HiDPI icons.</summary>
      <version major="9" minor="12"/>
      <date year="2018" month="9" day="29"/>
      <author login="ebakke"/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible"/>
      <description>
        <p>
            It is now increasingly common for NetBeans to run on Windows, Linux, or MacOS machines with
            so-called "HiDPI" screens, aka. "retina" screens in the Apple world. These screens have about
            twice the physical pixel density of traditional screens, making it necessary to scale GUI
            graphics up by some amount, e.g. 150% or 200% (depending on OS and OS-level user settings), in
            order to remain readable. Since Java 9, this scaling is done automatically by AWT by means of a
            scaling default transform in each Component's Graphics2D instances. This makes text sharp on
            HiDPI screens, but leaves bitmap icons blurry.
        </p>
        <p>
            This change introduces a new abstract class VectorIcon, which can be extended to create
            custom-painted Icon instances that will look sharp on HiDPI screens, regardless of scaling level.
            See VectorIcon's Javadoc for a discussion of appropriate use cases.
        </p>
      </description>
      <class package="org.openide.util" name="VectorIcon"/>
      <issue number="NETBEANS-1238"/>
    </change>
    <change id="DeprecateBooleanStateAction">
        <api name="util"/>
        <summary><code>BooleanStateAction</code> deprecated in favour of <code>Actions</code> API and <code>@ActionState</code> annotation.</summary>
        <version major="9" minor="11"/>
        <date day="1" month="8" year="2018"/>
        <author login="sdedic"/>
        <compatibility deprecation="yes"/>
        <description>
            <p>
                The <a href="@TOP@/org/openide/util/actions/BooleanStateAction.html">BooleanStateAction</a> base class was deprecated, as
                there's a programatic API in Actions
                and a declarative <a href="@org-openide-awt@/org/openide/awt/ActionState.html">@ActionState</a> annotation which fully supersede the deprecated class.
            </p>
        </description>
        <class package="org.openide.util.actions" name="BooleanStateAction"/>
    </change>
    <change id="GetAuthenticationPassword">
        <api name="util"/>
        <summary>API <code>NetworkSettings.getAuthenticationPassword</code> added</summary>
        <version major="9" minor="8"/>
        <date day="11" month="11" year="2016"/>
        <author login="tstupka"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                The SPI <a href="@TOP@/org/openide/util/NetworkSettings.ProxyCredentialsProvider.html">
                NetworkSettings.ProxyCredentialsProvider</a> allows NetBeans Platform
                users to provide proxy and network credentials, but the according API should also provide
                the password, not only the username.
            </p>
        </description>
        <class package="org.openide.util" name="NetworkSettings"/>
        <issue number="268803"/>
    </change>
    <change id="server.is.free">
        <api name="util"/>
        <summary>Desktop independent utilities extracted</summary>
        <version major="9" minor="0"/>
        <date day="20" month="3" year="2014"/>
        <author login="sdedic"/>
        <compatibility modification="yes" addition="yes">
            <p>
                Runtime compatibility remains, compile time compatibility is
                mostly preserved too. It is however recommended to upgrade
                dependencies of client modules. Try running
                <code>ant fix-dependencies</code> in your Ant module.
            </p>
        </compatibility>
        <description>
            <p>
                The following classes were spinned of into 
                <a href="@org-openide-util@/index.html">org.openide.util.base module</a>:
            </p>
            <ul>
                <li><a href="@org-openide-util@/org/openide/util/Cancellable.html">Cancellable</a></li>
                <li><a href="@org-openide-util@/org/openide/util/ChangeSupport.html">ChangeSupport</a></li>
                <li><a href="@org-openide-util@/org/openide/util/CharSequences.html">CharSequences</a></li>
                <li><a href="@org-openide-util@/org/openide/util/Enumerations.html">Enumerations</a></li>
                <li><a href="@org-openide-util@/org/openide/util/Exceptions.html">Exceptions</a></li>
                <li><a href="@org-openide-util@/org/openide/util/MapFormat.html">MapFormat</a></li>
                <li><a href="@org-openide-util@/org/openide/util/Mutex.html">Mutex</a></li>
                <li><a href="@org-openide-util@/org/openide/util/MutexException.html">MutexException</a></li>
                <li><a href="@org-openide-util@/org/openide/util/NbBundle.html">NbBundle</a></li>
                <li><a href="@org-openide-util@/org/openide/util/NbCollections.html">NbCollections</a></li>
                <li><a href="@org-openide-util@/org/openide/util/NotImplementedException.html">NotImplementedExcepion</a></li>
                <li><a href="@org-openide-util@/org/openide/util/Pair.html">Pair</a></li>
                <li><a href="@org-openide-util@/org/openide/util/Parameters.html">Parameters</a></li>
                <li><a href="@org-openide-util@/org/openide/util/RequestProcessor.html">RequestProcessor</a></li>
                <li><a href="@org-openide-util@/org/openide/util/Task.html">Task</a></li>
                <li><a href="@org-openide-util@/org/openide/util/TaskListener.html">TaskListener</a></li>
                <!--<li><a href="@org-openide-util@/org/openide/util/TimedSoftReference.html">TimedSoftReference</a></li>-->
                <li><a href="@org-openide-util@/org/openide/util/TopologicalSortException.html">TopologicalSortException</a></li>
                <li><a href="@org-openide-util@/org/openide/util/Union2.html">Union2</a></li>
                <li><a href="@org-openide-util@/org/openide/util/WeakListeners.html">WeakListeners</a></li>
                <li><a href="@org-openide-util@/org/openide/util/WeakSet.html">WeakSet</a></li>
            </ul>
            <p>
                The class <a href="@TOP@/org/openide/util/Utilities.html">Utilities</a> was also split and the
                client desktop indepenent parts landed in <a href="@org-openide-util@/org/openide/util/BaseUtilities.html">BaseUtilities</a>.
                Although all the constants and methods are still available through Utilities class, it is advised to change the dependencies
                and reference them through BaseUtilities.
            </p>
        </description>
        <issue number="243100"/>
    </change>
    <change id="disabled-action-beep">
        <api name="util"/>
        <summary>Platform dependent sound when invoking a disabled action.</summary>
        <version major="8" minor="39"/>
        <date year="2014" month="7" day="9"/>
        <author login="saubrecht"/>
        <compatibility addition="yes" binary="compatible" source="compatible"/>
        <description>
            <p>
                Only some platforms provide an audible notification when user 
                tries to invoke a disabled action. So instead of Toolkit.beep() 
                which always plays a sound a new method 
                <code>Utilities.disabledActionSound()</code> shoud be used instead.
            </p>
        </description>
        <class package="org.openide.util" name="Utilities"/>
        <issue number="203979"/>
    </change>
    <change id="try-lock">
        <api name="util"/>
        <summary>Try to lock a Mutex</summary>
        <version major="8" minor="37"/>
        <date year="2014" month="1" day="20"/>
        <author login="jtulach"/>
        <compatibility addition="yes" binary="compatible" source="compatible"/>
        <description>
            <p>
                Two new methods, <code>tryReadAccess</code> and <code>tryWriteAccess</code>,
                added to <a href="@org-openide-util@/org/openide/util/Mutex.Privileged.html">Mutex.Privileged</a>
                to allow better control when waiting for a lock.
            </p>
        </description>
        <class package="org.openide.util" name="Mutex" link="no"/>
        <issue number="240442"/>
    </change>
    <change id="darklaf">
        <api name="util"/>
        <summary>Added an option to load different images and icons when using a dark look and feel.</summary>
        <version major="8" minor="35"/>
        <date year="2013" month="12" day="6"/>
        <author login="saubrecht"/>
        <compatibility addition="yes" binary="compatible" source="compatible"/>
        <description>
            <p>
                When the IDE is running under a dark look and feel (<code>UIManager.getBoolean("nb.dark.theme")</code>)
                then <code>ImageUtilities</code> will try to load an image or on icon with a "_dark" suffix.
                For example "org/netbeans/modulename/toolbaricon_dark.png" or
                "org/netbeans/modulename/imagewithoutextension_dark". If such
                resource exists it will be used instead of the default one.
            </p>
        </description>
        <class package="org.openide.util" name="ImageUtilities"/>
        <issue number="233959"/>
    </change>
    <change id="pair">
        <api name="util"/>
        <summary>Added a type safe Pair of 2 elements</summary>
        <version major="8" minor="32"/>
        <date year="2013" month="5" day="1"/>
        <author login="tzezula"/>
        <compatibility addition="yes" binary="compatible" source="compatible"/>
        <description>
            <p>
                Added a type safe Pair of 2 elements.
            </p>
        </description>
        <class package="org.openide.util" name="Pair" link="no"/>
        <issue number="228994"/>
    </change>
    <change id="automatic-uqe">
        <api name="util"/>
        <summary>Automatic support for UserQuestionException</summary>
        <version major="8" minor="29"/>
        <date year="2012" month="11" day="14"/>
        <author login="jtulach"/>
        <compatibility addition="yes" binary="compatible" source="compatible"/>
        <description>
            <p>
                The default NetBeans Platform infrastructure knows how to
                display dialog when a <code>UserQuestionException</code> is
                reported.
            </p>
        </description>
        <class package="org.openide.util" name="Exceptions" link="no"/>
        <class package="org.openide.util" name="UserQuestionException"/>
        <issue number="57748"/>
    </change>
    <change id="File.URI">
        <api name="util"/>
        <summary>UNC-safe File / URI interconversion</summary>
        <version major="8" minor="25"/>
        <date year="2012" month="6" day="11"/>
        <author login="jglick"/>
        <compatibility addition="yes">
            <p>
                Use the Jackpot-format upgrade hint.
            </p>
        </compatibility>
        <description>
            <p>
                <code>Utilities</code> gets new methods <code>toURI(File)</code>
                and <code>toFile(URI)</code> which offer the UNC safety of NIO.2
                even on JDK 6.
            </p>
        </description>
        <class package="org.openide.util" name="Utilities"/>
        <issue number="213562"/>
    </change>
    <change id="exit-code">
        <api name="util"/>
        <summary>Exit with status code</summary>
        <version major="8" minor="23"/>
        <date year="2012" month="3" day="8"/>
        <author login="jtulach"/>
        <compatibility addition="yes" binary="compatible" source="compatible"/>
        <description>
            <p>
                <a href="@TOP@/org/openide/LifecycleManager.html">LifecycleManager</a>
                has new <code>exit</code> method allowing callers to specify
                the exit code.
            </p>
        </description>
        <class package="org.openide" name="LifecycleManager"/>
        <issue number="209018"/>
    </change>
    <change id="Messages.fields">
        <api name="util"/>
        <summary><code>@NbBundle.Messages</code> available on fields</summary>
        <version major="8" minor="22"/>
        <date year="2012" month="1" day="3"/>
        <author login="jglick"/>
        <compatibility addition="yes">
            <p>
                Existing annotations made on classes but only used from a field
                within that class will continue to work, but for clarity should
                be moved onto the field.
            </p>
        </compatibility>
        <description>
            <p>
                <code>@NbBundle.Messages</code> may now be used on fields, useful
                in case the field initializer involves some complex construction
                requiring a localized message. (Merely storing a localized message
                in a String constant is poor practice; inline the field instead.)
            </p>
        </description>
        <class package="org.openide.util" name="NbBundle" link="no"/>
        <issue number="206543"/>
    </change>
    <change id="HelpCtx.display">
        <api name="util"/>
        <summary><code>HelpCtx.display</code> added</summary>
        <version major="8" minor="21"/>
        <date year="2011" month="12" day="13"/>
        <author login="jglick"/>
        <compatibility binary="compatible">
            <p>
                Modules calling <code>org.netbeans.api.javahelp.Help.showHelp</code>
                via reflection should use this new API instead.
            </p>
        </compatibility>
        <description>
            <p>
                To permit modules to display help pages where available without
                a direct dependency on the JavaHelp API, <code>HelpCtx.display()</code>
                was added together with a matching SPI.
            </p>
        </description>
        <class package="org.openide.util" name="HelpCtx"/>
        <issue number="205992"/>
    </change>
    <change id="rp.cancel">
        <api name="util"/>
        <summary>RequestProcessor tweaks</summary>
        <version major="8" minor="19"/>
        <date day="12" month="10" year="2011"/>
        <author login="jtulach"/>
        <compatibility binary="compatible" semantic="incompatible">
            The changes are supposed to be as compatible as possible. The only
            desirable change is that calling <code>cancel(); cancel()</code> on
            the same task returns <code>false</code> on the second call now.
            In spite of that the changes caused bunch of regressions and it took
            a week to stabilize them. That is why they deserve a warning note
            in compatibility section.
        </compatibility>            
        <description>
            <p>
            In order to deal with bug #202354 there were some minor tweaks
            inside <code>RequestProcessor</code> implementation.
            </p>
        </description>
        <class package="org.openide.util" name="RequestProcessor" link="no"/>
        <issue number="202354"/>
    </change>
    <change id="ProxyCredentialsProvider">
        <api name="util"/>
        <summary>SPI <code>NetworkSettings.ProxyCredentialsProvider</code> added</summary>
        <version major="8" minor="17"/>
        <date day="20" month="9" year="2011"/>
        <author login="jrechtacek"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Most of the proxy and network credentials are currently read
                from a default NetBeans storage. This may not be ideal
                for other Platform aplications storing the settings in a different
                way or computing them dynamically. 
                A SPI <a href="@TOP@/org/openide/util/NetworkSettings.ProxyCredentialsProvider.html">
                NetworkSettings.ProxyCredentialsProvider</a> allows NetBeans Platform
                users to provide proxy and network credentials separately.
                See <a href="https://netbeans.apache.org/wiki/Authenticator">https://netbeans.apache.org/wiki/Authenticator</a>
            </p>
        </description>
        <class package="org.openide.util" name="NetworkSettings"/>
        <issue number="201662"/>
    </change>
    <change id="SuppressAuthentication">
        <api name="util"/>
        <summary><code>NetworkSettings.suppressAuthenticationDialog</code> added</summary>
        <version major="8" minor="17"/>
        <date day="20" month="9" year="2011"/>
        <author login="jrechtacek"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Some plugins needs a way to suppress <a href="@JDK@@JDKMODULE_JAVA_BASE@/java/net/Authenticator.html"><code>java.net.Authenticator</code></a> without asking
                user a question about the credentials. 
                Invoke <a href="@TOP@/org/openide/util/NetworkSettings.html#suppressAuthenticationDialog(java.util.concurrent.Callable)">
                suppressAuthenticationDialog</a> with a block of code where authentication dialog will be suppressed.                
                See <a href="https://netbeans.apache.org/wiki/Authenticator">https://netbeans.apache.org/wiki/Authenticator</a>
            </p>
        </description>
        <class package="org.openide.util" name="NetworkSettings"/>
        <issue number="201662"/>
    </change>
    <change id="NetworkSettings">
        <api name="util"/>
        <summary><code>NetworkSettings</code> added</summary>
        <version major="8" minor="13"/>
        <date day="1" month="2" year="2011"/>
        <author login="jrechtacek"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added new useful methods for getting Network Proxy for specified URI.
            </p>
        </description>
        <class package="org.openide.util" name="NetworkSettings"/>
        <issue number="194530"/>
    </change>
    <change id="ImageUtilities.URL">
        <api name="util"/>
        <summary>ImageUtilities support "url" attribute</summary>
        <version major="8" minor="12"/>
        <date day="10" month="1" year="2011"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>
            Images loaded by <a href="@TOP@/org/openide/util/ImageUtilities.html#loadImage(java.lang.String,boolean)">
            ImageUtilities.loadImage</a> now
            respond to <code>getProperty("url", null)</code> calls.
            </p>
        </description>
        <class package="org.openide.util" name="ImageUtilities"/>
        <issue number="193944"/>
    </change>
    <change id="WeakSet.putIfAbsent">
        <api name="util"/>
        <summary>New implementation of WeakSet with two new methods <code>putIfAbsent</code> and <code>resize</code>
        </summary>
        <version major="8" minor="11"/>
        <date day="22" month="12" year="2010"/>
        <author login="vv159170"/>
        <compatibility addition="yes"/>
        <description>
            <p>
            New method putIfAbsent gives access to key already stored in Set. Method resize allows to change capacity of internal hash map.
            </p>
        </description>
        <class package="org.openide.util" name="WeakSet" link="no"/>
        <issue number="192759"/>
    </change>
    <change id="NbBundle.Messages">
        <api name="util"/>
        <summary>Added <code>@NbBundle.Messages</code></summary>
        <version major="8" minor="10"/>
        <date day="8" month="12" year="2010"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                A new annotation makes it easier to produce localizable strings.
            </p>
        </description>
        <class package="org.openide.util" name="NbBundle" link="no"/>
        <issue number="192750"/>
    </change>
    <change id="Exceptions.attachSeverity">
        <api name="util"/>
        <summary>Supress logging of not important exceptions</summary>
        <version major="8" minor="9"/>
        <date day="8" month="9" year="2010"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                New method <code>Exceptions.attachSeverity</code> allows
                everyone to thrown an exception, which later will not be
                logged.
            </p>
        </description>
        <class package="org.openide.util" name="Exceptions" link="no"/>
        <issue number="190079"/>
    </change>
    <change id="RequestProcessorForClass">
        <api name="util"/>
        <summary>Simplified constructor for RequestProcessor</summary>
        <version major="8" minor="6"/>
        <date day="13" month="4" year="2010"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Simpler constructor for RequestProcessor.
            </p>
        </description>
        <class package="org.openide.util" name="RequestProcessor" link="no"/>
        <issue number="180458"/>
    </change>
    <change id="CharSequences">
        <api name="util"/>
        <summary>Added <code>CharSequences</code></summary>
        <version major="8" minor="3"/>
        <date day="2" month="4" year="2010"/>
        <author login="vv159170"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                <code>CharSequences.create</code> can now be used
                to create memory-efficient implementations of <code>CharSequence</code> for ASCII strings.
            </p>
        </description>
        <class package="org.openide.util" name="CharSequences" link="no"/>
        <issue number="183162"/>
    </change>
    <change id="ActionInvoker-ActionPresenterProvider">
        <api name="actions"/>
        <summary>Action SPI interfaces added</summary>
        <version major="8" minor="1"/>
        <date day="21" month="1" year="2010"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added some internal SPI interfaces.
            </p>
        </description>
        <class package="org.openide.util.actions" name="ActionInvoker"/>
        <class package="org.openide.util.actions" name="ActionPresenterProvider"/>
        <issue number="179289"/>
    </change>
    <change id="NbPreferences.Provider">
        <api name="util"/>
        <summary><code>NbPreferences.Provider</code> added</summary>
        <version major="8" minor="1"/>
        <date day="21" month="1" year="2010"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added an internal SPI interface.
            </p>
        </description>
        <class package="org.openide.util" name="NbPreferences" link="no"/>
        <issue number="179289"/>
    </change>
    <change id="lookup.is.free">
        <api name="util"/>
        <summary>Lookup API extracted</summary>
        <version major="8" minor="0"/>
        <date day="20" month="12" year="2009"/>
        <author login="jtulach"/>
        <compatibility modification="yes">
            <p>
                Runtime compatibility remains, compile time compatibility is
                mostly preserved too. It is however recommended to upgrade
                dependencies of your modules. Try running
                <code>ant fix-dependencies</code> in your Ant module.
            </p>
        </compatibility>
        <description>
            <p>
                <a href="@org-openide-util-lookup@/org/openide/util/Lookup.html">Lookup</a>
                and its associated interfaces are now available as a
                <a href="@org-openide-util-lookup@/overview-summary.html">separate module</a>.
            </p>
        </description>
        <issue number="170056"/>
    </change>
    <change id="URLStreamHandlerRegistration">
        <api name="util"/>
        <summary>Added <code>@URLStreamHandlerRegistration</code></summary>
        <version major="7" minor="31"/>
        <date day="30" month="10" year="2009"/>
        <author login="jglick"/>
        <compatibility addition="yes">
            <p>
                Modules registering <code>URLStreamHandlerFactory</code>s into
                global lookup will still work but are advised to switch to this
                annotation, which is both easier to use and more efficient.
            </p>
        </compatibility>
        <description>
            <p>
                Introduced an annotation to register URL protocols.
            </p>
        </description>
        <class package="org.openide.util" name="URLStreamHandlerRegistration" link="no"/>
        <issue number="20838"/>
    </change>
    <change id="ImageUtilities.createDisabled">
        <api name="util"/>
        <summary><code>ImageUtilities.createDisabledIcon</code> and <code>ImageUtilities.createDisabledImage</code> added.</summary>
        <version major="7" minor="28"/>
        <date day="10" month="9" year="2009"/>
        <author login="t_h"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                <code>ImageUtilities.createDisabledIcon</code> now can be used
                to create low color saturation icon for disabled buttons. Also
                <code>ImageUtilities.createDisabledImage</code> was added.
            </p>
        </description>
        <class package="org.openide.util" name="ImageUtilities"/>
        <issue number="171400"/>
    </change>
    <change id="NbBundle.varargs">
        <api name="util"/>
        <summary><code>NbBundle.getMessage</code> can take arbitrarily many format arguments</summary>
        <version major="7" minor="27"/>
        <date day="5" month="8" year="2009"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                <code>NbBundle.getMessage</code> now has a varargs overload that
                permits you to specify four or more format arguments without
                explicitly constructing an array.
            </p>
        </description>
        <class package="org.openide.util" name="NbBundle" link="no"/>
    </change>
    <change id="EditableProperties">
        <api name="util"/>
        <summary>Copied API from <code>project.ant</code> for <code>EditableProperties</code>.</summary>
        <version major="7" minor="26"/>
        <date day="29" month="7" year="2009"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                 <code>EditableProperties</code> now available in Utilities API
                 so it can be used more broadly.
            </p>
        </description>
        <class package="org.openide.util" name="EditableProperties" link="no"/>
        <issue number="66577"/>
    </change>
    <change id="LifecycleManager.markForRestart">
        <api name="util"/>
        <summary>Added way to request that the platform restart.</summary>
        <version major="7" minor="25"/>
        <date day="14" month="7" year="2009"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                 Can now use <code>LifecycleManager.markForRestart</code> to cause
                 the application to restart after exiting. Formerly needed to
                 create special files in the userdir or use similar tricks.
            </p>
        </description>
        <class package="org.openide" name="LifecycleManager"/>
        <issue number="168257"/>
    </change>
    <change id="enableStackTraces">
        <api name="util"/>
        <summary>Added constructor <code>RequestProcessor(String name, int throughput, boolean interruptThread, boolean enableStackTraces)</code></summary>
        <version major="7" minor="24"/>
        <date day="8" month="6" year="2009"/>
        <author login="rmichalsky"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Newly added constructor allows to disable (slow) filling stack traces before posting each task. 
            </p>
        </description>
        <class package="org.openide.util" name="RequestProcessor" link="no"/>
        <issue number="165862"/>
    </change>
    <change id="ImageUtilities.loadImageIcon">
        <api name="util"/>
        <summary>Added <code>loadImageIcon(String resource, boolean localized)</code></summary>
        <version major="7" minor="22"/>
        <date day="26" month="1" year="2009"/>
        <author login="t_h"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Convenient method for loading icons.
            </p>
        </description>
        <class package="org.openide.util" name="ImageUtilities"/>
        <issue number="157254"/>
    </change>
    <change id="Utilities.keyToString">
        <api name="util"/>
        <summary>Added <code>keyToString(KeyStroke stroke, boolean portable)</code></summary>
        <version major="7" minor="21"/>
        <date day="8" month="1" year="2009"/>
        <author login="msauer"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                <code>keyToString(KeyStroke stroke, boolean portable)</code>
                provides cross-platform compitable keystroke textual representation
                instead of hardcoding Ctrl, Meta or Alt key.
            </p>
        </description>
        <class package="org.openide.util" name="Utilities"/>
        <issue number="110492"/>
    </change>
    <change id="Utilities.OS_OPENBSD">
        <api name="util"/>
        <summary>Added <code>OS_OPENBSD</code> and <code>OS_UNIX_OTHER</code> fields</summary>
        <version major="7" minor="18"/>
        <date day="16" month="9" year="2008"/>
        <author login="jskrivanek"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added a new <code>Utilities.OS_OPENBSD</code> and <code>OS_UNIX_OTHER</code>
                fields. Deprecated <code>OS_WINDOWS_MASK</code> and <code>OS_UNIX_MASK</code>.
            </p>
        </description>
        <class package="org.openide.util" name="Utilities"/>
        <issue number="145462"/>
    </change>
    <change id="Utilities.OS_WINVISTA">
        <api name="util"/>
        <summary>Added <code>OS_WINVISTA</code> field</summary>
        <version major="7" minor="17"/>
        <date day="8" month="8" year="2008"/>
        <author login="jskrivanek"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added a new <code>Utilities.OS_WINVISTA</code> field to be able
                to recognize Windows Vista operating system.
            </p>
        </description>
        <class package="org.openide.util" name="Utilities"/>
        <issue number="142629"/>
    </change>
    <change id="XMLUtil.validate">
        <api name="xml"/>
        <summary>Added <code>XMLUtil.validate</code></summary>
        <version major="7" minor="17"/>
        <date day="11" month="7" year="2008"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added a new method to validate XML documents against schemas.
            </p>
        </description>
        <class package="org.openide.xml" name="XMLUtil" link="no"/>
        <issue number="42686"/>
    </change>
    <change id="RequestProcessor.Executor">
        <api name="util"/>
        <summary>RequestProcessor implements Executor interface</summary>
        <version major="7" minor="16"/>
        <date day="27" month="6" year="2008"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                In order to align <code>RequestProcessor</code> closer to standard 
                Java 5 concurrency utilities, the class now implements
                <a href="@JDK@@JDKMODULE_JAVA_BASE@/java/util/concurrent/Executor.html">Executor</a>
                interfaces and its <code>execute(Runnable)</code> method.
            </p>
        </description> 
        <class package="org.openide.util" name="RequestProcessor" link="no"/>
        <issue number="134297"/>
    </change>
    <change id="Utilities.toolTips">
        <api name="util"/>
        <summary>ImageUtilities class (with additional methods) was created as 
        replacement for "image methods" in Utilities. </summary>
        <version major="7" minor="15"/>
        <date day="6" month="6" year="2008"/>
        <author login="t_h"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Image methods were separated to <a href="@TOP@/org/openide/util/ImageUtilities.html">ImageUtilities</a>
                (renamed IconManager) as replacement for methods in Utilities. 
                There are some additional methods for image tool tips manipulation.
            </p>
            <p>    
                New methods for tool tips manipulation:
                <code>Image assignToolTipToImage(Image image, String text)</code>;
                <code>String getImageToolTip(Image image)</code>;
                <code>Image addToolTipToImage(Image image, String text)</code>;
            </p>
            <p>
                New method for conversion from Image to Icon:
                <code>Icon image2Icon(Image image)</code>;
            </p>
            <p>
                "Moved" methods from <a href="@TOP@/org/openide/util/Utilities.html">Utilities</a>:
                <code>Image icon2Image(Icon icon)</code>;
                <code>Image loadImage(String resourceID)</code>;
                <code>Image loadImage(String resource, boolean localized)</code>;
                <code>Image mergeImages(Image image1, Image image2, int x, int y)</code>;
            </p>
        </description> 
        <class package="org.openide.util" name="Utilities"/>
        <class package="org.openide.util" name="ImageUtilities"/>
        <issue number="123469"/>
    </change>
    <change id="Mutex.Wrapper">
        <api name="util"/>
        <summary>Mutex made pluggable</summary>
        <version major="7" minor="12"/>
        <date day="3" month="1" year="2008"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added new constructor
                <a href="@org-openide-util@/org/openide/util/Mutex.html">Mutex(Privileged, Executor)</a>
                that allows creators of the mutex to intercept and wrap all actions running
                inside the mutex with custom code.
            </p>
        </description> 
        <class package="org.openide.util" name="Mutex" link="no"/>
        <issue number="123832"/>
    </change>
    <change id="Utilities.isLargeFrameIcons">
        <api name="util"/>
        <summary>Obsolete method <code>Utilities.isLargeFrameIcons</code> deprecated.</summary>
        <version major="7" minor="10"/>
        <date day="23" month="10" year="2007"/>
        <author login="mslama"/>
        <compatibility addition="no" deprecation="yes"/>
        <description>
            <p>
            Javadoc says: Test whether the operating system supports icons on frames (windows).
            But window system used this method to decide if small 16x16 or bigger 32x32 icon
            should be used for frame (main window). So usage and Javadoc is inconsistent.
            All OS support small icon in frame. From JDK 6 it is possible to set multiple size
            icons for frame so OS WM selects appropriate size.
            I removed useless usage of this method from window system code and this method is
            not used elsewhere.
            </p>
        </description> 
        <class package="org.openide.util" name="Utilities"/>
        <issue number="119069"/>
    </change>

    <change id="ChangeSupport">
        <api name="util"/>
        <summary>Added <code>ChangeSupport</code></summary>
        <version major="7" minor="8"/>
        <date day="26" month="3" year="2007"/>
        <author login="abadea"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added a <code>ChangeSupport</code> class to simplify
                the management of <code>ChangeListener</code>s and the 
                firing of <code>ChangeEvent</code>s.
            </p>
        </description>
        <class package="org.openide.util" name="ChangeSupport" link="no"/>
        <issue number="95885"/>
    </change>

    <change id="Utilities.isMac">
        <api name="util"/>
        <summary>Added <code>Utilities.isMac()</code> method</summary>
        <version major="7" minor="7"/>
        <date day="11" month="1" year="2007"/>
        <author login="rkubacki"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added a <code>Utilities.isMac()</code> method for checking 
                if current platform is Mac.
            </p>
        </description>
        <class package="org.openide.util" name="Utilities"/>
        <issue number="61044"/>
    </change>

    <change id="Parameters">
        <api name="util"/>
        <summary>Added <code>Parameters</code></summary>
        <version major="7" minor="6"/>
        <date day="8" month="12" year="2006"/>
        <author login="abadea"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added a <code>Parameters</code> class for checking the
                values of method parameters.
            </p>
        </description>
        <class package="org.openide.util" name="Parameters" link="no"/>
        <issue number="89768"/>
    </change>

    <change id="NbCollections.iterable">
        <api name="util"/>
        <summary>Added <code>NbCollections.iterable(...)</code> methods</summary>
        <version major="7" minor="5"/>
        <date day="13" month="11" year="2006"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added two new methods to make enhanced for-loops easier to use
                with legacy APIs returning <code>Iterator</code> or <code>Enumeration</code>.
            </p>
        </description>
        <class package="org.openide.util" name="NbCollections" link="no"/>
        <issue number="88606"/>
    </change>

    <change id="nbpreferences">
        <api name="util"/>
        <summary>Added <code>NbPreferences.forModule(Class cls)</code> and
          <code>NbPreferences.root()</code> methods as static factory methods
          for getting preference node from NetBeans preference tree.</summary>
        <version major="7" minor="4"/>
        <date day="10" month="11" year="2006"/>
        <author login="rmatous"/>
        <compatibility addition="yes" deprecation="no"/>
        <description>
            <p>
              NetBeans preference tree is provided by NetBeans implementation of preferences
              which uses userdir as a storage. Both newly added methods return
              preferences  node from NetBeans preference tree.
              Method <code>NbPreferences.root()</code> returns root preference
              node.
              Method <code>NbPreferences.forModule(Class cls)</code> returns
              preference node whose
              path depends whether class provided as a parameter
              was loaded as a part of any module or not. If so, then absolute path corresponds to slashified 
              code name base of module. If not, then absolute path corresponds to class's package.
              See document
              <a href="@org-openide-util@/org/openide/util/doc-files/preferences.html">Preferences in NetBeans</a>
              to learn more about preferences in NetBeans.              
            </p>
        </description>
        <class package="org.openide.util" name="NbPreferences" link="no"/>
        <issue number="73474"/>
    </change>

    <change id="icon2image">
        <api name="util"/>
        <summary>Added <code>Utilities.icon2Image</code> method to perform conversion from <code>Icon</code> to Image</summary>
        <version major="7" minor="3"/>
        <date day="4" month="7" year="2006"/>
        <author login="rkubacki"/>
        <compatibility addition="yes" deprecation="no"/>
        <description>
            <p>
                Conversion from <code>Icon</code> to <code>Image</code> is done 
                at various places and newly introduced method avoids the need to 
                duplicate the same code.
            </p>
        </description>
        <class package="org.openide.util" name="Utilities"/>
        <issue number="52562"/>
    </change>
    
    <change id="Exceptions">
        <api name="util"/>
        <summary>Added <code>Exceptions</code> class as a replacement for <code>ErrorManager</code></summary>
        <version major="7" minor="2"/>
        <date day="20" month="6" year="2006"/>
        <author login="jtulach"/>
        <compatibility addition="yes" deprecation="yes"/>
        <description>
            <p>
                <code>ErrorManager</code> is now deprecated and its replacement
                is either <a href="@JDK@@JDKMODULE_JAVA_LOGGING@/java/util/logging/Logger.html">Logger</a> 
                or <code>Exceptions</code>.
            </p>
        </description>
        <class package="org.openide.util" name="Exceptions" link="no"/>
        <issue number="35067"/>
    </change>
    
    <change id="NbCollections">
        <api name="util"/>
        <summary>Added <code>NbCollections</code> and <code>Union2</code></summary>
        <version major="7" minor="1"/>
        <date day="5" month="6" year="2006"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added two new classes useful for transitioning to JDK 5 generics.
            </p>
        </description>
        <class package="org.openide.util" name="NbCollections" link="no"/>
        <class package="org.openide.util" name="Union2" link="no"/>
        <issue number="73637"/>
    </change>
    
    <change id="use-logging" >
      <api name="util"/>
      <summary>Do not use ErrorManager for logging</summary>
      <version major="7" minor="0"/>
      <date day="15" month="4" year="2006"/>
      <author login="jtulach"/>
      <compatibility addition="yes" modification="yes" binary="compatible" source="compatible" semantic="incompatible" deprecation="no" deletion="no"/>
      <description>
          <a href="@TOP@/org/openide/ErrorManager.html">ErrorManager</a>
          is no longer the recommended way to do logging in NetBeans based
          application. Instead NetBeans now fully support logging two JDK's
          standard <a href="@JDK@@JDKMODULE_JAVA_LOGGING@/java/util/logging/Logger.html">Logger</a>.
          See the
          <a href="@org-openide-util@/org/openide/util/doc-files/logging.html">NetBeans logging guide</a>
          to learn the best practises for logging in NetBeans.
          <br/>
          <a href="@TOP@/org/openide/ErrorManager.html">ErrorManager</a>
          is still kept around for annotating exceptions with localized
          messages and advanced manipulation and its behaviour is fully
          backward compatible. However modules are adviced to migrate to
          <a href="@JDK@@JDKMODULE_JAVA_LOGGING@/java/util/logging/Logger.html">logging</a> whereever
          possible.
          <br/>
          To migrate your modules you can install Jackpot modules from
          autoupdate (if they are not yet part of your IDE) and apply
          precreate jackpot error manager rule.
          <br/>
          There is one possible incompatibility from end user point of view.
          The way to <em>enable logging</em> for certain components when
          running inside the whole NetBeans container has changed:
          If there is 
          <a href="@JDK@@JDKMODULE_JAVA_LOGGING@/java/util/logging/Logger.html">Logger</a> or
          <a href="@TOP@/org/openide/ErrorManager.html">ErrorManager</a>
          named <q>org.mymodule.MyComponent</q> then the correct way
          to turn the logging is now to invoke NetBeans with
          <code>-J-Dorg.mymodule.MyComponent<b>.level</b>=100</code>
          (where the possible constants are taken form
          a JDK's definition of level).
          There is however a certain benefit in this change, the value
          of the property (like <q>org.mymodule.MyComponent.level</q>)
          can be changed during runtime and thus the logging can be
          enabled or disabled dynamically (after changing the value, it is
          necessary to call
          <a href="@JDK@@JDKMODULE_JAVA_LOGGING@/java/util/logging/LogManager.html">LogManager.readConfiguration()</a>).
      </description>
      <class package="org.openide" name="ErrorManager"/>
      <issue number="56311"/>
    </change>
    <change id="rp-create-true" >
      <api name="util"/>
      <summary>Ability to create finished RequestProcessor task</summary>
      <version major="6" minor="8"/>
      <date day="22" month="11" year="2005"/>
      <author login="jtulach"/>
      <compatibility addition="yes" modification="no" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no"/>
      <description>
        <a href="@org-openide-util@/org/openide/util/RequestProcessor.html">RequestProcessor.create(Runnable, boolean)</a>
        has been added to allow creation of 
        <a href="@org-openide-util@/org/openide/util/RequestProcessor.Task.html">Task</a>
        that has not executed its runnable yet, but looks like it is finished.
      </description>
      <class package="org.openide.util" name="RequestProcessor" link="no"/>
      <issue number="68031"/>
    </change>
    
    <change>
      <api name="util"/>
      <summary>DynamicMenuContent interface added</summary>
      <version major="6" minor="4"/>
      <date day="12" month="6" year="2005"/>
      <author login="mkleint"/>
      <compatibility addition="no" modification="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no"/>
      <description>
        In order to support MacOSX top menus and to fix problems with deprecated JInlineMenu, this new
        interface was added that allows to handle dynamic content in 
<a href="@TOP@/org/openide/util/actions/Presenter.Menu.html">Presenter.Menu</a>
 and <a href="@TOP@/org/openide/util/actions/Presenter.Popup.html">Presenter.Popup</a>.
        If the instance returned by Presenter.Menu/Popup is an instance of 
<a href="@org-openide-awt@/org/openide/awt/DynamicMenuContent.html">DynamicMenuContent</a>, it's methods are
        consulted when creating/updating the menu.
      </description>
      <class package="org.openide.util.actions" name="Presenter"/>
      <issue number="35827"/>
    </change>
    

    
    <change>
      <api name="util"/>
      <summary>Support for interruption of RequestProcessor tasks</summary>
      <version major="6" minor="3"/>
      <date day="10" month="6" year="2005"/>
      <author login="jtulach"/>
      <compatibility addition="yes" modification="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no"/>
      <description>
          When one calls <a href="@org-openide-util@/org/openide/util/RequestProcessor.Task.html">RequestProcessor.Task</a>.cancel(), 
          the running thread gets interrupted if the 
          <a href="@org-openide-util@/org/openide/util/RequestProcessor.html#%3Cinit%3E(java.lang.String,int,boolean)">
          RequestProcessor(string, int, boolean) 
          </a> 
          constructor is used.
          There always was a way how to cancel not yet running Task, 
          but if the task was already running, one was out of luck. Since now
          the thread running the task is interrupted and the Runnable can check 
          for that and terminate its execution sooner. In the runnable one shall 
          check for  thread interruption and 
          if true, return immediatelly as in this example:
          <pre>
public void run () {
  while (veryLongTimeLook) {
    doAPieceOfIt ();

    if (Thread.interrupted ()) return;
  }
}
</pre>
      </description>
      <class package="org.openide.util" name="RequestProcessor" link="no"/>
      <issue number="33467"/>
    </change>
    <change id="textual-icons-for-actions" >
      <api name="actions"/>
      <summary>Can create textual icons for actions</summary>
      <date day="23" month="3" year="2000"/>
      <author login="jglick"/>
      <compatibility addition="yes" modification="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no"/>
      <description>
        <code>iconResource</code> may now return <code>null</code> to indicate no
        icon. <code>getIcon(true)</code> may be used to get an icon created from
        the label if there is no icon specified.
      </description>
      <class package="org.openide.util.actions" name="SystemAction"/>
    </change>
    <change id="use-icon-instead-of-imageicon" >
      <api name="actions"/>
      <summary>
        <code>SystemAction</code> refers to <code>Icon</code> rather than <code>ImageIcon</code>
      </summary>
      <date day="11" month="4" year="2000"/>
      <author login="jglick"/>
      <compatibility modification="yes" binary="compatible" source="incompatible" semantic="compatible" deprecation="no" addition="no" deletion="no">
        First broken, later restored binary compatibility in trunk and
        <code>boston</code>. Any code explicitly using this calls before may break
        (source code may be compatible in many cases; binary compatibility has
        been preserved). These calls were known to be used only for
        <code>Actions</code> to create presenters; normal code which constructs
        <code>SystemAction</code>s and implements <code>iconResource</code> should
        be unaffected. Actions using the "grouping action" template should check
        their <code>getMenuPresenter</code> method which may be
        binary-incompatible; it is easy to replace the code with safer code such
        as:
        <pre xml:space="preserve">
<span class="comment">// ....
</span>
<span class="keyword">private</span> <span class="keyword">static</span> <span class="type">Icon</span> <span class="variable-name">icon</span> = <span class="constant">null</span>;
<span class="comment">// ....
</span>
<span class="keyword">public</span> <span class="type">JMenuItem</span> <span class="function-name">getMenuPresenter</span>() {
    <span class="type">JMenu</span> <span class="variable-name">menu</span> = <span class="keyword">new</span> <span class="type">JMenu</span>(getName ());
    <span class="keyword">if</span> (icon == <span class="constant">null</span>) {
        icon = <span class="keyword">new</span> <span class="type">ImageIcon</span>(MyAction.<span class="keyword">class</span>.getResource(iconResource()));
    }
    menu.setIcon(icon);
    <span class="comment">// ....</span>
</pre>
      </compatibility>
      <description>
        <code>getIcon</code> and <code>setIcon</code> now use the interface
        <code>Icon</code> rather than the particular implementation
        <code>ImageIcon</code>. This corrects an API bug (excessive specificity).
      </description>
      <class package="org.openide.util.actions" name="SystemAction"/>
    </change>
    <change>
        <api name="actions"/>
        <summary>New Actions system - part I.</summary>
        <version major="3" minor="29"/>
        <date day="8" month="1" year="2003"/>
        <author login="jtulach"/>
        <author login="pzavadsky"/>
        <compatibility deprecation="yes" addition="yes" modification="yes" binary="compatible" source="compatible" semantic="compatible" deletion="no"/>
        <description>
            <p>
            Introduction of new action system, which generally means
            move from usage of <code>SystemAction</code> to <code>Action</code> instances.
            That document also focuses on declarative actions
            usage which is not subject of current change, it will be part of later changes.
            </p>
        </description>
        <class package="org.openide.util" name="ContextAwareAction"/>
        <class package="org.openide.util" name="Utilities"/>
        <class package="org.openide.util.actions" name="CallbackSystemAction"/>
        <issue number="27868"/>
    </change>

<change id="Task-waitFinished-timeout">
      <api name="util"/>
      <summary>New method <code>task.waitFinished(timeout)</code> added</summary>
      <version major="5" minor="0"/>
      <date day="2" month="11" year="2004"/>
      <author login="jtulach"/>
      <compatibility addition="yes" binary="compatible" semantic="compatible" source="compatible" deprecation="no" deletion="no" modification="no"/>
      <description>
        <p>It is not possible to wait for a limited amount of time for
            completion of any task. The <code>RequestProcessor.Task</code>
            version is optimized, the <code>Task</code> version ensures that
            the sematics will be compatible for all subclasses, even they did
            not know about the method at all.
        </p>
      </description>
      <class package="org.openide.util" name="Task" link="no"/>
      <class package="org.openide.util" name="RequestProcessor" link="no"/>
      <issue number="16849"/>
    </change>
<change id="add-detection-of-FreeBSD-OS">
      <api name="util"/>
      <summary>Added field <code>OS_FREEBSD</code> to <code>Utilities</code>
</summary>
      <version major="4" minor="50"/>
      <date day="29" month="10" year="2004"/>
      <author login="jrechtacek"/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
      <description>
        <p>FreeBSD was not recognized as Unix OS. <code>Utilities</code> has been
        enlarged with new field <code>OS_FREEBSD</code>, part of OS Unix mask. <code>Utilities.isUnix()</code>
        now returns <code>true</code> for applications run on FreeBSD.
        </p>
      </description>
      <class package="org.openide.util" name="Utilities"/>
    </change>
    <change id="Mutex.isReadWriteAccess">
        <api name="util"/>
        <summary>Added <code>Mutex.isReadAccess()</code> and <code>Mutex.isWriteAcess()</code>
</summary>
        <version major="4" minor="48"/>
        <date day="30" month="9" year="2004"/>
        <author login="jtulach"/>
        <compatibility addition="yes" binary="compatible" semantic="compatible" source="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            A thread can now check whether read or write access on a <code>Mutex</code>
            has already been
            granted to it and use it to decide whether it is safe to perform
            certain operations or delay them.
        </description>
        <class package="org.openide.util" name="Mutex" link="no"/>
        <issue number="49459"/>
    </change>
<change id="SharedClassObject.reset">
        <api name="util"/>
        <summary>Added <code>SharedClassObject.reset</code> method to allow subclasses to implement reset correctly</summary>
        <version major="4" minor="46"/>
        <date day="2" month="9" year="2004"/>
        <author login="jtulach"/>
        <compatibility addition="yes" binary="compatible" semantic="compatible" source="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            The new <code>SharedClassObject.reset</code> method is called
            by the infrastructure in moments when an original (at the time
            of start) state of an option or any other <code>SharedClassObject</code>
            is requested. Interested subclasses are free to implement any kind of clean
            they need. The <code>SystemOption</code> provides a default 
            implementation based on fired property changed events, so 
            its correctly written subclasses do not need 
            to do anything.
        </description>
        <class package="org.openide.util" name="SharedClassObject"/>
        <issue number="20962"/>
    </change>
<change>
--> --------------------

--> maximum size reached

--> --------------------

100%


¤ Dauer der Verarbeitung: 0.32 Sekunden  (vorverarbeitet)  ¤

*© Formatika GbR, Deutschland






Wurzel

Suchen

Beweissystem der NASA

Beweissystem Isabelle

NIST Cobol Testsuite

Cephes Mathematical Library

Wiener Entwicklungsmethode

Haftungshinweis

Die Informationen auf dieser Webseite wurden nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit, noch Qualität der bereit gestellten Informationen zugesichert.

Bemerkung:

Die farbliche Syntaxdarstellung ist noch experimentell.