EnhancedCustomPropertyEditor


1   /*
2    * The contents of this file are subject to the terms of the Common Development
3    * and Distribution License (the License). You may not use this file except in
4    * compliance with the License.
5    *
6    * You can obtain a copy of the License at http://www.netbeans.org/cddl.html
7    * or http://www.netbeans.org/cddl.txt.
8    *
9    * When distributing Covered Code, include this CDDL Header Notice in each file
10   * and include the License file at http://www.netbeans.org/cddl.txt.
11   * If applicable, add the following below the CDDL Header, with the fields
12   * enclosed by brackets [] replaced by your own identifying information:
13   * "Portions Copyrighted [year] [name of copyright owner]"
14   *
15   * The Original Software is NetBeans. The Initial Developer of the Original
16   * Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
17   * Microsystems, Inc. All Rights Reserved.
18   */
19  package org.openide.explorer.propertysheet.editors;
20  
21  import org.openide.explorer.propertysheet.PropertyEnv;
22  
23  /**
24  * Enhances standard custom property editor with the possibility to return the customized value.
25  * I.e. the custom property editor does not need to fire property changes upon
26  * modifications; the property dialog manager
27  * instead sets the acquired value after the custom editor is closed.
28  *
29  * @author  Ian Formanek
30  * @deprecated Use {@link PropertyEnv} instead. An example of what needs to be
31  *    done can be found in the rewrite of
32  *    <a HREF="http://www.netbeans.org/source/browse/core/src/org/netbeans/beaninfo/editors/RectangleCustomEditor.java?r1=1.25&r2=1.26">RectangleCustomEditor</a>.
33  *  Another example showing the changes in property editor as well as in its
34  *  custom component can be found in
35  *  <a HREF="http://core.netbeans.org/source/browse/core/execution/src/org/netbeans/core/execution/beaninfo/editors/NbProcessDescriptorEditor.java?r1=1.3&r2=1.4">NbProcessDescriptorEditor</a>
36  *  and
37  *   <a HREF="http://core.netbeans.org/source/browse/core/execution/src/org/netbeans/core/execution/beaninfo/editors/NbProcessDescriptorCustomEditor.java?r1=1.3&r2=1.5">NbProcessDescriptorCustomEditor</a>.
38  */
39  public @Deprecated   interface EnhancedCustomPropertyEditor {
40      /** Get the customized property value.
41      * @return the property value
42      * @exception IllegalStateException when the custom property editor does not contain a valid property value
43      *            (and thus it should not be set)
44      */
45      public Object   getPropertyValue() throws IllegalStateException  ;
46  }
47
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags