javax.imageio

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

public interface IIOParamController

Интерфейс, который будет реализован объектами, которые могут определить настройки IIOParam объект, или поднимая GUI, чтобы получить значения от пользователя, или другими средствами. Этот интерфейс просто определяет обобщение activate метод, который вызывает контроллер, не принимая во внимание то, как контроллер получает значения (то есть, поднимает ли контроллер GUI или просто вычисляет ряд значений, не важно этому интерфейсу).

В пределах activate метод, контроллер получает начальные значения, запрашивая IIOParam объект get методы, изменяет значения любыми средствами, затем вызывает IIOParam объект set методы, чтобы изменить соответствующие настройки. Обычно, они set методы будут вызваны внезапно в заключительной фиксации, чтобы работа отмены не нарушила существующие значения. Вообще, приложения могут ожидать это когда activate возвраты метода true, IIOParam объект готов к употреблению в операции чтения или операции записи.

Поставщики могут хотеть обеспечивать GUI для IIOParam подклассы они определяют для определенного плагина. Они могут быть установлены как контроллеры по умолчанию в соответствии IIOParam подклассы.

Приложения могут переопределить любые GUI по умолчанию и обеспечить их собственные контроллеры, встроенные в их собственную платформу. Все, что требуется, то, чтоactivate метод ведет себя модально (не возвращающийся до или отмененный или фиксировавший), хотя он не должен поднять явно модальное диалоговое окно. Такой немодальный компонент GUI был бы кодирован примерно следующим образом:

 class MyGUI extends SomeComponent implements IIOParamController {

    public MyGUI() {
        // ...
        setEnabled(false);
    }

    public boolean activate(IIOParam param) {
        // disable other components if desired
        setEnabled(true);
        // go to sleep until either cancelled or committed
        boolean ret = false;
        if (!cancelled) {
            // set values on param
            ret = true;
        }
        setEnabled(false);
        // enable any components disabled above
        return ret;
    }
 

Альтернативно, алгоритмический процесс, такой как поиск базы данных или парсинг командной строки мог использоваться в качестве контроллера, когда activate метод просто искал бы или вычислил бы настройки, вызвать IIOParam.setXXX методы, и возврат true.

См. Также:

IIOParam.setController(javax.imageio.IIOParamController), IIOParam.getController(), IIOParam.getDefaultController(), IIOParam.hasController(), IIOParam.activateController()

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

Методы

Модификатор и Тип	Метод и Описание
boolean	activate(IIOParam param) Активирует контроллер.

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

активироваться

boolean activate(IIOParam param)

Активирует контроллер. Если true возвращается, все настройки в IIOParam объект должен быть готовым к употреблению в операции чтения или операции записи. Если false возвращается, никакие настройки в IIOParam объект будет нарушен (то есть, пользователь, отмененный работа).

Параметры:

param - IIOParam объект, который будет изменен.

Возвраты:

true если IIOParam был изменен, false иначе.

Броски:

IllegalArgumentException - если param null или не экземпляр корректного класса.