PropertyEditor (Платформа Java SE 7)

Все Известные Классы с реализацией:

PropertyEditorSupport
```
public interface PropertyEditor
```
Класс PropertyEditor оказывает поддержку для GUI, которые хотят позволить пользователям редактировать значение свойства данного типа.
PropertyEditor поддерживает множество различных видов способов вывести на экран и обновить значения свойств. Большинство PropertyEditors должно будет только поддерживать подмножество различных вариантов, доступных в этом API.
Простой PropertyEditors может только поддерживать getAsText и setAsText методы и не должен поддерживать (говорят) paintValue или getCustomEditor. Более составные типы могут быть неспособны поддерживать getAsText и setAsText, но будут вместо этого поддерживать paintValue и getCustomEditor.
Каждый propertyEditor должен поддерживать один или больше трех простых стилей дисплея. Таким образом это может или (1), поддержка isPaintable или (2) оба возвращает непустую строку [] от getTags () и возвращает ненулевое значение из getAsText, или (3) просто возвращают непустую строку из getAsText ().
Каждый редактор свойств должен поддерживать запрос setValue, когда объект параметра имеет тип, для которого это - соответствующий propertyEditor. Кроме того, каждый редактор свойств должен или поддерживать пользовательского редактора, или поддерживать setAsText.
У каждого PropertyEditor должен быть нулевой конструктор.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` Добавляет слушатель для изменения значения.
`Строка`	`getAsText()` Получает значение свойства как текст.
`Компонент`	`getCustomEditor()` PropertyEditor может хотеть делать доступным полный пользовательский Компонент, который редактирует его значение свойства.
`Строка`	`getJavaInitializationString()` Возвращает фрагмент кода Java, который может использоваться, чтобы установить свойство, чтобы соответствовать текущее состояние редакторов.
`Строка[]`	`getTags()` Если значение свойства должно быть одним из ряда известных теговых значений, то этот метод должен возвратить массив тегов.
`Объект`	`getValue()` Получает значение свойства.
`boolean`	`isPaintable()` Определяет, является ли этот редактор свойств paintable.
`void`	`paintValue(Graphics gfx, Rectangle box)` Нарисуйте представление значения в данную область экранного недвижимого имущества.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` Удаляет слушателя для изменения значения.
`void`	`setAsText(String text)` Установите значение свойства, анализируя данную Строку.
`void`	`setValue(Object value)` Набор (или изменение) объект, который должен быть отредактирован.
`boolean`	`supportsCustomEditor()` Определяет, поддерживает ли этот редактор свойств пользовательского редактора.

- Деталь метода
  - setValue
```
void setValue(Object value)
```
    Набор (или изменение) объект, который должен быть отредактирован. Типы примитивов такой столь же "международный" должны быть обернуты как соответствующий объектный тип такой как "java.lang. Целое число".
    
    Параметры:
    value - Новый целевой объект, который будет отредактирован. Отметьте, что этот объект не должен быть изменен PropertyEditor, скорее PropertyEditor должен создать новый объект содержать любое измененное значение.
  - getValue
```
Object getValue()
```
    Получает значение свойства.
    
    Возвраты:
    Значение свойства. Типы примитивов такой столь же "международный" будут обернуты как соответствующий объектный тип такой как "java.lang. Целое число".
  - isPaintable
```
boolean isPaintable()
```
    Определяет, является ли этот редактор свойств paintable.
    
    Возвраты:
    Истина, если класс будет соблюдать paintValue метод.
  - paintValue
```
void paintValue(Graphics gfx,
              Rectangle box)
```
    Нарисуйте представление значения в данную область экранного недвижимого имущества. Отметьте, что propertyEditor ответственен за выполнение его собственного отсечения так, чтобы он вписался в данный прямоугольник.
    Если PropertyEditor не соблюдает запросы краски (см. isPaintable), этот метод должен быть тихим noop.
    У данного Графического объекта будут шрифт по умолчанию, цвет, и т.д. родительского контейнера. PropertyEditor может изменить графические атрибуты, такие как шрифт и покрасить и не должен восстановить старые значения.
    
    Параметры:
    gfx - Графический объект нарисовать в.
    box - Прямоугольник в пределах графического объекта, в который мы должны нарисовать.
  - getJavaInitializationString
```
String getJavaInitializationString()
```
    Возвращает фрагмент кода Java, который может использоваться, чтобы установить свойство, чтобы соответствовать текущее состояние редакторов. Этот метод предназначается для использования, генерируя код Java, чтобы отразить изменения, произведенные через редактор свойств.
    Фрагмент кода должен быть свободным контекстом и должен быть юридическим выражением Java как определено JLS.
    Определенно, если выражение представляет вычисление тогда, все классы и статические элементы должны быть полностью определены. Это правило применяется к конструкторам, статическим методам и не примитивным параметрам.
    Предостережение должно использоваться, оценивая выражение, поскольку это может выдать исключения. В частности генераторы кода должны гарантировать, что сгенерированный код скомпилирует в присутствии выражения, которое может выдать проверенные исключения.
    Результаты в качестве примера:
    - Примитивный expresssion: 2
    - Конструктор класса: new java.awt.Color(127,127,34)
    - Статическое поле: java.awt.Color.orange
    - Статический метод: javax.swing.Box.createRigidArea(new java.awt.Dimension(0, 5))
    Возвраты:
    фрагмент кода Java, представляющего инициализатор для текущей стоимости. Это не должно содержать точку с запятой (';'), чтобы закончить выражение.
  - getAsText
```
String getAsText()
```
    Получает значение свойства как текст.
    
    Возвраты:
    Значение свойства как человеческая доступная для редактирования строка.
    Нуль возвратов, если значение не может быть выражено как доступная для редактирования строка.
    Если ненулевое значение возвращается, то PropertyEditor должен быть подготовлен проанализировать ту строку назад в setAsText ().
  - setAsText
```
void setAsText(String text)
               throws IllegalArgumentException
```
    Установите значение свойства, анализируя данную Строку. Может повысить java.lang. IllegalArgumentException, если или Строка ужасно форматируется или если этот вид свойства не может быть выражен как текст.
    
    Параметры:
    text - Строка, которая будет проанализирована.
    
    Броски:
    
    IllegalArgumentException
  - getTags
```
String[] getTags()
```
    Если значение свойства должно быть одним из ряда известных теговых значений, то этот метод должен возвратить массив тегов. Это может использоваться, чтобы представить (например) перечислимые значения. Если PropertyEditor поддерживает теги, то он должен поддерживать использование setAsText со значением тега как способ установить значение и использование getAsText, чтобы идентифицировать текущую стоимость.
    
    Возвраты:
    Тег оценивает за это свойство. Может быть нуль, если это свойство не может быть представлено как теговое значение.
  - getCustomEditor
```
Component getCustomEditor()
```
    PropertyEditor может хотеть делать доступным полный пользовательский Компонент, который редактирует его значение свойства. Это - обязанность PropertyEditor сцепиться до его редактора Компонента непосредственно и сообщить об изменениях значения свойства, запуская событие PropertyChange.
    Высокоуровневый код, который вызывает getCustomEditor, может или встроить Компонент в некоторое большее окно свойств, или это может поместить это в свое собственное отдельное диалоговое окно, или...
    
    Возвраты:
    java.awt. Компонент, который позволит человеку непосредственно редактировать текущее значение свойства. Может быть нуль, если это не поддерживается.
  - supportsCustomEditor
```
boolean supportsCustomEditor()
```
    Определяет, поддерживает ли этот редактор свойств пользовательского редактора.
    
    Возвраты:
    Истина, если propertyEditor может предоставить пользовательскому редактору.
  - addPropertyChangeListener
```
void addPropertyChangeListener(PropertyChangeListener listener)
```
    Добавляет слушатель для изменения значения. Когда редактор свойств изменяет свое значение, он должен запустить a PropertyChangeEvent на всех зарегистрированных PropertyChangeListeners, определяя null значение для имени свойства и его непосредственно как источник.
    
    Параметры:
    listener - PropertyChangeListener добавить
  - removePropertyChangeListener
```
void removePropertyChangeListener(PropertyChangeListener listener)
```
    Удаляет слушателя для изменения значения.
    
    Параметры:
    listener - PropertyChangeListener удалить

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный PropertyEditor

Сводка метода

Деталь метода

setValue

getValue

isPaintable

paintValue

getJavaInitializationString

getAsText

setAsText

getTags

getCustomEditor

supportsCustomEditor

addPropertyChangeListener

removePropertyChangeListener