Элемент выбора файла

Элемент управления, предоставляющий простой механизм навигации по файловой системе, с последующим выбором (или вводом имени) файла.

Элемент выбора файла может работать в двух режимах:

Взгляните на эту простую демонстрационную модель, в которой Элемент выбора файла совмещен с объектом Текстовый файл так, чтобы можно было выбрать файл, например, с параметрами модели, еще до ее запуска.

Демо модель: File Chooser For Text Files

 Чтобы добавить элемент выбора файла

  1. Перетащите элемент Элемент выбора файла  из палитры Элементы управления в то место графического редактора, где вы хотите его нарисовать.
  2. В параметре Тип укажите тип этого элемента управления. Выберите Загрузка, если хотите использовать элемент для загрузки файлов (стандартный пример применения; чтение данных до запуска модели). Загруженные файлы будут помещены в папку модели. Доступ к файлам возможен в режиме "Только для чтения".
  3. Если необходимо с помощью элемента выбора файла скачивать файлы, выберите тип Скачивание.
  4. В поле Заголовок укажите заголовок диалогового окна, которое откроется после нажатия на элемент выбора файла.
  5. В поле секции Действие, напечатайте Java код, который будет выполняться при каждой загрузке или скачивании файла с помощью элемента выбора файла. Этот код может считывать данные из файла и использовать их в модели. Имя выбранного файла доступно здесь как value (локальная переменная типа String).

Свойства

Основные

Имя – Имя элемента управления. Имя используется для идентификации элемента и доступа к нему из кода.

Исключить – Если опция выбрана, то элемент управления будет исключен из модели.

Отображается на верхнем уровне – Если опция выбрана, то элемент управления будет виден на презентации типа агента, в который будет вложен данный агент.

Тип – Тип диалогового окна. Если вам нужно позволить пользователям с помощью этого элемента открывать файлы, выберите опцию Загрузка. Если же с помощью этого элемента вам нужно сохранять файлы, выберите Скачивание.

Заголовок – Заголовок диалогового окна.

Фильтры имен файлов – [Параметр виден, если в параметре Тип выбрана опция Загрузка] Здесь вы задаете фильтры имен файлов для элемента выбора файлов. Элемент выбора файлов позволит пользователям видеть и загружать только указанные типы файлов. Фильтр задается списком расширений файлов, к примеру: .png, .jpeg, .jpg.

Файл – [Параметр виден, если в параметре Тип выбрана опция Скачивание] Полное имя файла, который этот элемент управления должен скачать.

Действие

Код, который будет выполняться при загрузке/скачивании пользователем файла с помощью этого элемента управления. Этот код может считывать данные из файла и использовать их в модели. Имя выбранного в данный момент времени файла доступно здесь как value (локальная переменная типа String). 

Внешний вид

Цвет фона – Задает цвет фона элемента выбора файла. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета. Цвет фона корректно отображается в операционной системе Windows с классическим оформлением. В то же время некоторые операционные системы не поддерживают такие элементы управления с измененным пользователем цветом фона.

Цвет текста – Задает цвет текста, отображающего имя выбранного файла в поле элемента. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета.

Шрифт – Задает тип шрифта для текста, отображающего имя выбранного файла в поле элемента. В расположенном справа поле вы можете выбрать размер шрифта.

Курсив – Если опция выбрана, то текст будет выделен курсивом.

Полужирный – Если опция выбрана, то текст будет выделен полужирным шрифтом.

Местоположение и размер

X – X-координата верхнего левого угла элемента.

Y – Y-координата верхнего левого угла элемента.

Ширина – Ширина элемента (в пикселах).

Высота – Высота элемента (в пикселах).

Специфические

Видимость – Элемент будет виден, если заданное здесь выражение будет истинно (true), в противном случае он отображаться не будет.

Количество – Количество экземпляров данного элемента управления. Если вы оставите это поле пустым, то будет создан только один такой элемент управления.

Отображать имя – Если опция выбрана, то имя элемента будет отображаться в графическом редакторе.

Значок – Если опция выбрана, то элемент управления будет считаться частью значка типа агентов.

Функции

Значение элемента выбора файла

Функция

Описание

String getValue()

Возвращает имя выбранного файла. Если ни один файл не выбран, возвращает пустую строку.

void setValue
(String fileName)

Устанавливает fileName в качестве имени выбранного файла.

При этом действие, заданное пользователем, не выполняется.

Параметр:
fileName - имя файла

void setValue(String fileName,
boolean callAction)

Устанавливает fileName в качестве имени выбранного файла.

При этом если значение аргумента функции callAction равно true, то выполнится заданное пользователем действие.

Параметры:
fileName - имя файла
callAction - если true, то будет выполнено заданное пользователем действие

void setValueToDefault()

Устанавливает заданное по умолчанию имя файла в качестве текущего значения элемента выбора файла.

При этом заданное пользователем действие не выполняется.

Управление доступом

Функция

Описание

boolean isEnabled()

Проверяет, доступен ли элемент управления в текущий момент времени. Возвращает true, если элемент доступен (и вы можете менять его состояние), либо же false, если элемент недоступен.

void setEnabled
(boolean yes)

Делает элемент управления активным или недоступным (в зависимости от значения аргумента функции).

Параметр:
yes - если true, то элемент управления будет активен; если false - то недоступен. 

Программное выполнение заданного действия

Функция

Описание

void action()

Выполняет действие, заданное пользователем для этого элемента управления (в его свойстве Действие).

Местоположение

Функция

Описание

double getX()

Возвращает координату X элемента управления (если точнее, то координату X его верхнего левого угла).

double getY()

Возвращает координату Y элемента управления (если точнее, то координату Y его верхнего левого угла).

void setX(double x)

Задает новую координату X.

Параметр:
x - новое значение координаты X

void setY(double y)

Задает новую координату Y.

Параметр:
y - новое значение координаты Y

void setPos(double x, double y)

Задает новое местоположение элемента управления.

Параметры:
x - новое значение координаты X
y - новое значение координаты Y

Размер

Функция

Описание

double getWidth()

Возвращает ширину элемента в пикселах.

double getHeight()

Возвращает высоту элемента в пикселах.

void setWidth(double width)

Устанавливает ширину элемента равной параметру width.

void setHeight(double height)

Устанавливает высоту элемента равной параметру height.

Видимость

Функция

Описание

boolean isVisible()

Возвращает видимость элемента управления. 

Если возвращает true, то элемент управления виден; если false - то нет.

void setVisible
(boolean v)

Задает видимость элемента управления.

Параметр:
v - видимость: если true, то элемент управления будет виден, если false - то нет.


См. также

 Справочник классов: Класс ShapeFileChooser