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

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

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

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

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

  1. Перетащите элемент Элемент выбора файла  из палитры Элементы управления в то место графического редактора, где вы хотите его нарисовать.

Свойства

Основные

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

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

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

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

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

Фильтры имен файлов – Здесь вы задаете фильтры имен файлов для элемента выбора файлов. Каждый фильтр задается в отдельной строке таблицы: вы должны указать для каждого фильтра Имя фильтра и соответствующие Расширения имен файлов. Чтобы удалить запись из таблицы, выберите соответствующую строку и щелкните по кнопке , расположенной справа от таблицы.

Действие

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

Внешний вид

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

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

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

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

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

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

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