# Диалоги

`axipy.show_message`(text[, title, icon, details]) | Показ сообщения.
`axipy.show_dialog`(text[, title, buttons, ...]) | Отображает диалоговое окно с различными опциями и возвращает информацию о кнопке, нажатой пользователем.
`axipy.prompt_string`(text[, title, ...]) | Диалог запроса строкового значения.
`axipy.prompt_int`(text[, title, value, ...]) | Диалог запроса целого значения.
`axipy.prompt_float`(text[, title, value, ...]) | Диалог запроса вещественного значения.
`axipy.prompt_item`(text[, title, items, ...]) | Диалог выбора значения из выпадающего списка.
`axipy.select_style_dialog`() | Диалог выбора стиля по геометрии в виде функции.
`axipy.prompt_rect`([rect, unit]) | Диалог выбора параметров прямоугольника.
`axipy.prompt_coordsystem`([cs]) | Диалог выбора координатной системы.

## Сообщения

axipy.show_message(text: str, title: str = '', icon: DlgIcon = DlgIcon.NONE, details: str = '')

  Показ сообщения.

  Параметры:

    - text – Текст диалога

    - title – Заголовок

    - icon – Иконка

    - details – Дополнительная информация в виде текста

  Пример:

      show_message('Сообщение', 'Заголовок', icon=DlgIcon.INFORMATION)

axipy.show_dialog(text: str, title: str = '', buttons: DlgButtons = DlgButtons.OK, icon: DlgIcon = DlgIcon.NONE, default_button: Optional[DlgButtons] = None, details: str = '') → DlgButtons

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

  Параметры:

    - text – Текст диалога

    - title – Заголовок

    - buttons – Перечень стандартных кнопок диалога,

    - icon – Иконка

    - default_button – Кнопка, выбранная по умолчанию. Должна присутствовать в buttons

    - details – Дополнительная информация в виде текста

  Результат:

    Возвращает выбор пользователя в диалоге

  Пример:

      res = show_dialog('Подтвердить действие?', 'Заголовок',
                  icon=DlgIcon.QUESTION,
                  default_button = DlgButtons.CANCEL,
                  buttons = DlgButtons.YES_NO_CANCEL)
      if res == DlgButtons.YES:
          print('Yes')

## Задание значения

axipy.prompt_string(text: str, title: str = '', multiline: bool = False, value: str = '') → Optional[str]

  Диалог запроса строкового значения.

  Параметры:

    - text – Текст диалога

    - title – Заголовок

    - multiline – Поддержка задания многострочного текста

    - value – Значение по умолчанию

  Пример:

      res = prompt_string('Введите текст:', multiline=True)

axipy.prompt_int(text: str, title: str = '', value: int = 0, min_value: int = -2147483647, max_value: int = 2147483647, step: int = 1) → Optional[int]

  Диалог запроса целого значения.

  Параметры:

    - text – Текст диалога

    - title – Заголовок

    - value – Значение по умолчанию

    - min_value – Минимально возможное значение при задании

    - max_value – Максимально возможное значение при задании

    - step – Шаг изменения значения посредством мыши

  Пример:

      value = prompt_int('Введите значение (0..100):', min_value=0, max_value=100)

axipy.prompt_float(text: str, title: str = '', value: float = 0.0, min_value: float = -sys.float_info.max, max_value: float = sys.float_info.max, decimals: int = 2, step: float = 1) → Optional[float]

  Диалог запроса вещественного значения.

  Параметры:

    - text – Текст диалога

    - title – Заголовок

    - value – Значение по умолчанию

    - min_value – Минимально возможное значение при задании

    - max_value – Максимально возможное значение при задании

    - decimals – Цифр после запятой

    - step – Шаг изменения значения посредством мыши

  Пример:

      value = prompt_float('Введите значение (0..100):', min_value=0, max_value=100)

axipy.prompt_item(text: str, title: str = '', items: Optional[Iterable[str]] = None, value: Union[int, str] = 0, editable: bool = False) → Optional[str]

  Диалог выбора значения из выпадающего списка.

  Параметры:

    - text – Текст диалога.

    - title – Заголовок.

    - items – Последовательность значений или итератор.

    - value – Значение по умолчанию или его индекс.

    - editable – Допустимо ли редактирование текущего значения.

  Результат:

    Выбранное значение или пустая строка.

  Пример:

      res = prompt_item('Варианты для выбора:', items = ("один", "два", "три"), value = 'два')

axipy.select_style_dialog(value: StyleGeometryType) → Optional[Style]
axipy.select_style_dialog(value: Style) → Optional[Style]
axipy.select_style_dialog(value: Geometry) → Optional[Style]

  Диалог выбора стиля по геометрии в виде функции. В качестве входных параметров рассматривается или стиль или геометрия, для которого этот стиль выбирается.

  Параметры:

    value – Геометрия, ее тип или стиль. Если задана геометрия, то стиль по умолчанию подставляется как стиль нового объекта для данного типа геометрии.

  Результат:

    Возвращает выбранный в диалоге стиль.

  По типу геометрического объекта:

      style = axipy.select_style_dialog(StyleGeometryType.Linear)

  Пример задания по геометрии:

      style = axipy.select_style_dialog(Point(3,3))

  Пример задания по стилю:

      style = select_style_dialog(axipy.Style.from_mapinfo('Symbol (35, 0, 12)'))

axipy.prompt_rect(rect: Rect = Rect(-10000000, -10000000, 10000000, 10000000), unit: Union[LinearUnit, str] = LinearUnits.m) → Optional[Rect]

  Диалог выбора параметров прямоугольника.

  Параметры:

    - rect – Значение по умолчанию.

    - unit – Единицы измерения при отображении.

  См.также

  `axipy.BoundingRectDialog`

axipy.prompt_coordsystem(cs: Optional[CoordSystem] = None) → Optional[CoordSystem]

  Диалог выбора координатной системы.

  Параметры:

    cs – Система координат.

  См.также

  `axipy.ChooseCoordSystemDialog`