Gui Command/ru: Difference between revisions

From FreeCAD Documentation
(Created page with "=== Требования к качеству === Существует множество GuiCommands (Особенностей/Фишек) в FreeCAD которые являю...")
(Created page with "* Команда/Функция должна быть '''законченой'''. Никаких незавершенных работ! * Должен иметь '''справ...")
Line 46: Line 46:
Для обеспечения хорошей работы пользователя, был создан''Полный(Complete)'' инструментарий. Это инструментарий, который запускается по умолчанию при старте FreeCAD и он включает в себя все GuiCommand-ы, отвечающие '''Требованиям к качеству''' ,описанным здесь:
Для обеспечения хорошей работы пользователя, был создан''Полный(Complete)'' инструментарий. Это инструментарий, который запускается по умолчанию при старте FreeCAD и он включает в себя все GuiCommand-ы, отвечающие '''Требованиям к качеству''' ,описанным здесь:


* Команда/Функция должна быть '''законченой'''. Никаких незавершенных работ!
* The Command/Feature has to be '''finished'''. No work in progress!
* Должен иметь '''справочную страницу''' как [[Std ViewScreenShot|эта]]
* Has to have a '''help page''' like [[Draft ShapeString]]
** All the fields in [[Template:GuiCommand]] have to filled in
** Все поля [[Template:GuiCommand]] должны быть заполнены
** Картинки с изображением диологов команды и конечный вывод
** A picture of the dialogs the command eventually yield
** детальное описание команды и всех её параметров и настроек
** detailed description of the command and all its parameters and settings
** Описание связанных python интерфесов и классов с примерами кода
** Description of the related python interfaces and classes with example code
* Настройка надлежащей иконки и позиции в меню
* Set up a proper Icon and menu position


Hopefully this becomes true for all GuiCommands in the [[List of Commands]].
Hopefully this becomes true for all GuiCommands in the [[List of Commands]].

Revision as of 10:07, 30 March 2014

GuiCommand одни из наиболее важных функций FreeCAD при взаимодействии с пользователем. Каждый раз когда пользователь выберает опцию в меню или нажимает на кнопку панели инструментов это активирует GuiCommand. Некоторые из атрибутов GuiCommand:

  • Задано имя
  • Содержит иконку
  • Определена возможности для отмены/повтора
  • Есть страница справки
  • Открывает и управляет диалогами
  • Записывается в макрос
  • и.т.д...

Назначение имен

GuiCommand именуются определенным образом: ИмяМодуля_ИмяКоманды т.е. "Base_Open" это команда Открыть(Open) графического интерфейса в Base(базоввой системе). GuiCommand определенная в модуле получает имя, включающее спереи имя модуля, наприер "Part_Cylinder".

Если документ не закончен(в смысле wiki статья) используйте шаблон Template:UnfinishedDocu

Страница справки

Каждая GuiCommand должна обладать страницей справки. Страница справки должна располагаться в FreeCAD wiki. В статье со схожим с именем GuiCommand, т.т. Std ViewScreenShot.

Чтобы создать ваши собственные справочные страницы используйте шаблон: GuiCommand model

Примеры:

Иконки

Каждая GuiCommand-а должна иметь иконку. Мы используем Tango набор иконок и его принципы. Справа вы можете видеть палитру цветов tango.

Предпочтительней всех, иконки нарисованные в SVG , например с помощью Inkscape. Это упрощает добавление изменений и получение дополнительных Иконок в том же пространстве приложения.

icons color coding chart

We try as much as possible to respect this chart, so the color of the icons has a direct meaning.

Требования к качеству

Существует множество GuiCommands (Особенностей/Фишек) в FreeCAD которые являются экспериментальными или используются недолгое время для реализации целей. Эти GuiCommands в основном помещаются в инструментарии, такие как Part, Mesh или Cam. Для обеспечения хорошей работы пользователя, был созданПолный(Complete) инструментарий. Это инструментарий, который запускается по умолчанию при старте FreeCAD и он включает в себя все GuiCommand-ы, отвечающие Требованиям к качеству ,описанным здесь:

  • Команда/Функция должна быть законченой. Никаких незавершенных работ!
  • Должен иметь справочную страницу как эта
    • Все поля Template:GuiCommand должны быть заполнены
    • Картинки с изображением диологов команды и конечный вывод
    • детальное описание команды и всех её параметров и настроек
    • Описание связанных python интерфесов и классов с примерами кода
  • Настройка надлежащей иконки и позиции в меню

Hopefully this becomes true for all GuiCommands in the List of Commands.