403
Создание настраиваемых диалоговых окон и управление ими
Горячая клавиша. Необязательный символ в заголовке, который должен использоваться длябыстрогодоступакэтомуэлементууправления. Этотсимволотображаетсявзаголовкес подчеркиванием. Этот доступактивизируетсяпри нажатиинаклавишуAlt+[мнемоническая клавиша]. Функция Мнемоническая клавиша не поддерживается на платформе Mac.
Примечание: Управляющий элемент «Кнопка вложенного диалогового окна» невозможно добавить во вложенное диалоговое окно.
Свойства диалогового окна для вложенного диалогового окна
Чтобы просмотреть и указать свойства для вложенного диалогового окна:
EОткройте вложенное диалоговое окно, дважды щелкнув по кнопке вложенного диалогового окна в основном диалоговом окне или один раз щелкнув по кнопке вложенного диалогового окна и нажав кнопку с троеточием (...) для свойства «Вложенное диалоговое окно».
EВо вложенном диалоговом окне щелкните макет в области, где отсутствуют управляющие элементы. При отсутствии управляющих элементов на макете свойства вложенного диалогового окна отображаются всегда.
Имя вложенного диалогового окна. Уникальный идентификатор для вложенного диалогового окна. Свойство «Имя вложенного диалогового окна» является обязательным.
Примечание: Если имя вложенного диалогового окна указано в качестве идентификатора в шаблоне синтаксиса, как в %%My Sub-dialog Name%%, при исполнении оно будет заменено на разделенный пробелами список синтаксиса, который сгенерирован каждым управляющим элементом во вложенном диалоговом окне в порядке их следования (сверху вниз и слева направо).
Заголовок. Указывает текст, который должен отображаться в заголовке вложенного диалогового окна. Свойство «Заголовок» является необязательным, однако его значение рекомендуется указать.
Файл справки. Указывает путь к необязательному файлу справки для вложенного диалогового окна. Это файл, который будет запускаться, когда пользователь нажмет кнопку Справка во вложенном диалоговом окне, и может совпадать с файлом справки, который указан для основного диалогового окна. Файлы справки должны быть в формате HTML. Дополнительные сведения см. в описании свойства «Файл справки» для окна Свойства диалогового окна.
Синтаксис. Нажмите кнопку с троеточием (...), чтобы открыть окно «Шаблон синтаксиса». Дополнительную информацию см. данная тема Создание шаблона синтаксиса на стр. 382.
Настраиваемые диалоговые окна для команд расширения
Команды расширения — это определенные пользователем команды IBM® SPSS® Statistics, которые реализованы на языке программирования Python либо R. После развертывания в экземпляре SPSS Statistics команда расширения исполняется аналогично любой встроенной команде SPSS Statistics.
404
Глава 19
С помощью Конструктора настраиваемого диалогового окна можно создавать диалоговые окна для команд расширения. Кроме того, можно установить настраиваемые диалоговые окна для команд расширения, созданные другими пользователями.
Создание настраиваемых диалоговых окон для команд расширения
Вне зависимости от того, кто написал команду расширения, для нее можно создать настраиваемое диалоговое окно. Шаблоном синтаксиса для диалогового окна должен генерироваться синтаксис команды для команды расширения. Если настраиваемое диалоговое окно будете использовать только вы, установите диалоговое окно. Если команда расширения уже развернута в системе, можно будет исполнить команду из установленного диалогового окна.
Если настраиваемое диалоговое окно создается для команды расширения и должно быть передано другим пользователям, сохраните спецификации для диалогового окна в файл пакета настраиваемого диалогового окна (.spd). Затем создается пакет расширений, содержащий пакетный файл настраиваемого диалогового окна — файл XML со спецификацией синтаксиса для команды расширения и код реализации (модуль Python или пакет R). После этого пакет расширений передается другим пользователям.
Дополнительную информацию см. данная тема Работа с пакетами расширений в Данная глава 16 на стр. 337.
Установка команд расширения со связанными настраиваемыми диалоговыми окнами
Команда расширения со связанным настраиваемым диалоговым окном состоит из трех компонентов: файла XML, который содержит спецификацию синтаксиса для команды; файла кода (модуль Python или пакет R), который реализует команду; файла пакета настраиваемого диалогового окна, который содержит спецификации для настраиваемого диалогового окна. Если команда расширения и связанное с ней настраиваемое диалоговое окно передается в файле пакета расширений (.spe), Тогда пакет можно просто установить из Сервис>Пакеты расширений>Установить пакет расширения. В противном случае необходимо отдельно устанавливать настраиваемое диалоговое окно и файлы команды расширения следующим образом.
Файл пакета настраиваемого диалогового окна. Установите пакет настраиваемого диалогового окна из Сервис>Настраиваемые диалоговые окна>Установить настраиваемое диалоговое окно.
Файл спецификации синтаксиса XML и код реализации. Для Windows и Linux XML-файл со спецификацией синтаксиса для команды расширения и код реализации (модуль Python или пакет R) необходимо поместить в каталог extensions, находящийся в каталоге установки SPSS Statistics. Для платформы Mac, XML-файл и кодовый файл необходимо поместить в каталог /Library/Application Support/IBM/SPSS/Statistics/20/extensions.
Для Windows и Linux, если разрешения на запись в каталог установки SPSS Statistics отсутствуют или необходимо сохранить файл XML и код реализации в другом месте, можно указать одну или несколько альтернативных папок, задав переменную среды SPSS_EXTENSIONS_PATH. При наличии разрешений пути, указанные в переменной SPSS_EXTENSIONS_PATH, имеют приоритет перед каталогом установки SPSS Statistics.
405
Создание настраиваемых диалоговых окон и управление ими
Обратите внимание, что пользователи платформы Mac могут также использовать переменную среды SPSS_EXTENSIONS_PATH. При использовании нескольких папок разделите каждую из них точкой с запятой в Windows и двоеточием — в Linux и Mac.
Чтобы создать переменную среды SPSS_EXTENSIONS_PATH в системе Windows, выполните те же шаги, что использовались для создания переменной
SPSS_CDIALOGS_PATH . См. раздел Установка настраиваемого диалогового окна в Управление настраиваемыми диалоговыми окнами на стр. 386.
Чтобы просмотреть текущее месторасположение настраиваемых диалоговых окон, запустите следующий командный синтаксис: SHOW EXTPATHS.
Для команды расширения, реализованной на языке программирования Python, можно всегда сохранить соответствующий модуль Python в папке, расположенной на пути поиска Python, например, в папке Python site-packages.
Примечание: Чтобы использовать новую команду расширения, перезапустите SPSS
Statistics.
Создание локализованных версий настраиваемых диалоговых окон
Можно создавать локализованные версии настраиваемых диалоговых окон для любых языков, поддерживаемых IBM® SPSS® Statistics. Можно локализовать любую строку, которая отображается в настраиваемом диалоговом окне. Кроме того, можно локализовать необязательный файл справки.
Локализация строк диалогового окна
EСоздайте копию файла свойств, связанного с диалоговым окном. Файл свойств содержит все локализуемые строки, связанные с диалоговым окном. По умолчанию он расположен в папке ext/lib/<имя_диалогового_окна> папки установки SPSS Statistics для Windows и Linux
и в папке /Library/Application Support/IBM/SPSS/Statistics/20/CustomDialogs/<имя_диалога>
для Mac. Копия должна храниться в той же папке, а не в подпапке.
Если для установленных диалоговых окон указаны альтернативные папки с помощью переменной среды SPSS_CDIALOGS_PATH, то копия должна находиться в папке <Имя_диалогового_окна> в соответствующей альтернативной папке. Дополнительную информацию см. данная тема Управление настраиваемыми диалоговыми окнами на стр. 386.
EПрисвойте копии имя <Имя_диалогового_окна>_<идентификатор_языка>.properties,
используя идентификаторы языков, указанные в приведенной ниже таблице. К примеру, если имя диалогового окна mydialog и необходимо создать японскую версию диалогового окна, то локализованный файл свойств должен иметь имя mydialog_ja.properties.
Локализованные файлы свойств необходимо вручную добавить во все файлы пакетов настраиваемых диалоговых окон, создаваемые для диалогового окна. Пакетный файл настраиваемого диалогового окна — это файл ZIP, который может быть открыт и изменен в таком приложении как WinZip в системе Windows.
406
Глава 19
EОткройте новый файл свойств в текстовом редакторе, поддерживающем кодировку UTF-8, например Notepad в Windows или TextEdit в Mac. Измените значения, связанные со всеми свойствами, которые необходимо локализовать, но не изменяйте имен свойств. Свойства, связанные с определенным управляющим элементом, имеют префикс, в качестве которого используется идентификатор управляющего элемента. К примеру, свойство «Всплывающая подсказка» для управляющего элемента с идентификатором options_button выглядит как options_button_tooltip_LABEL. Свойства «Заголовок» имеют простое имя
<identifier>_LABEL, как в options_button_LABEL.
При открытии диалогового окна программа SPSS Statistics выполнит поиск файла свойств, идентификатор языка которого соответствует текущему языку, указанному
в раскрывающемся списке «Язык» на вкладке «Общие свойства» диалогового окна «Параметры». Если такой файл свойств не найден, будет использован файл свойств по умолчанию <Имя_диалогового_окна>.properties .
Локализация файла справки
EСоздайте копию файла справки, связанного с диалоговым окном, и локализуйте текст для необходимого языка. Копия должна храниться в той же папке, что и файл справки, а не в подпапке. Файл справки должен располагаться расположен в папке ext/lib/<имя_диалогового_окна> папки установки SPSS Statistics для Windows и Linux и
в папке /Library/Application Support/IBM/SPSS/Statistics/20/CustomDialogs/<имя_диалога>
для Mac.
Если для установленных диалоговых окон указаны альтернативные папки с помощью переменной среды SPSS_CDIALOGS_PATH, то копия должна находиться в папке <Имя_диалогового_окна> в соответствующей альтернативной папке. Дополнительную информацию см. данная тема Управление настраиваемыми диалоговыми окнами на стр. 386.
EПрисвойте копии имя <Файл_справки>_<идентификатор_языка>, используя идентификаторы языков, указанные в приведенной ниже таблице. К примеру, если файл справкиmyhelp.htm и необходимосоздатьнемецкуюверсиюфайла, толокализованный файл справки должен иметь имя myhelp_de.htm. Локализованные файлы справки необходимо вручную добавить во все файлы пакетов настраиваемых диалоговых окон, создаваемые для диалогового окна. Пакетный файл настраиваемого диалогового окна — это файл ZIP, который может быть открыт и изменен в таком приложении как WinZip в системе Windows.
При наличии дополнительных файлов, например файлов изображений, которые также необходимо локализовать, потребуется вручную изменить соответствующие пути в основном файле справки к локализованным версиям, которые должны храниться вместе с оригинальными версиями.
При открытии диалогового окна программа SPSS Statistics выполнит поиск файла
справки, идентификатор языка которого соответствует текущему языку, указанному в раскрывающемся списке «Язык» на вкладке «Общие свойства» диалогового окна
«Параметры». Если такой файл справки не найден, используется файл справки, указанный для диалогового окна (файл, указанный в свойстве «Файл справки» в окне «Свойство диалогового окна»).
