From 3abd114a97d2797a82b9d1230eabe0fa1b25fbf8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=93=D1=80=D0=B8=D0=B3=D0=BE=D1=80=D0=B8=D0=B9=20=D0=9F?= =?UTF-8?q?=D0=BE=D0=BF=D0=BE=D0=B2?= Date: Mon, 22 Dec 2025 11:41:43 +0000 Subject: [PATCH] =?UTF-8?q?=D0=9E=D0=B1=D0=BD=D0=BE=D0=B2=D0=B8=D1=82?= =?UTF-8?q?=D1=8C=20README.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 57 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index cd3e0e2..2f04649 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,58 @@ -# tkinter-designer README -Тут можно создавать формы на tkinter :) +# Tkinter Form Designer +**Tkinter Form Designer** — это расширение для Visual Studio Code, которое позволяет визуально создавать графические интерфейсы (GUI) для Python библиотеки `tkinter` с помощью простого перетаскивания (Drag & Drop). + +Расширение автоматически генерирует Python-код в реальном времени. + +## Основные возможности + +* **Drag & Drop редактор:** Перетаскивайте элементы на форму и расставляйте их мышкой (используется абсолютное позиционирование `.place()`). +* **Двусторонняя связь:** + * Изменения в редакторе мгновенно обновляют `.py` файл. + * Возможность **импорта** существующего Python-кода обратно в визуальный редактор. Импортируемый файл должен иметь ту же структуру, что и файлы, генерируемые этим расширением. +* **Набор виджетов:** + * Label, Button, Entry, Text (многострочный ввод). + * Checkbox, Radiobutton. + * Listbox (с настройкой элементов списка). + * Canvas (холст). + * **Frame** (поддержка вложенности: можно перетаскивать виджеты внутрь фреймов). +* **Настройка свойств:** + * Изменение координат (X, Y) и размеров (Width, Height). + * Настройка цветов (Background, Foreground). + * Редактирование текста и содержимого. +* **Настройки главного окна:** Изменение заголовкаи и размеров основного окна через удобное меню. +* **Undo / Redo:** Полная поддержка отмены и повтора действий (`Ctrl+Z`, `Ctrl+Y`) с синхронизацией кода. + +## Установка + +Так как расширение находится в формате `.vsix` (локальный пакет): + +1. Скачайте файл `tkinter-designer-0.0.1.vsix`. +2. Откройте VS Code. +3. Перейдите на вкладку **Расширения** (Extensions) `Ctrl+Shift+X`. +4. Нажмите на меню (три точки) в правом верхнем углу панели. +5. Выберите **"Install from VSIX..."**. +6. Укажите файл расширения. + +## Как использовать + +1. **Создание проекта:** + * Создайте пустой файл с расширением `.tkjson` (например, `app.tkjson`). +2. **Запуск редактора:** + * Дважды кликните по файлу `.tkjson`. Откроется визуальный редактор. + * Рядом автоматически создастся файл `app.py` с кодом. +3. **Редактирование:** + * Перетаскивайте виджеты из палитры справа. + * Настраивайте их свойства в панели "Settings" (иконка шестеренки при выборе элемента). + * Для настройки размера окна нажмите иконку шестеренки в правом верхнем углу панели инструментов. +4. **Импорт кода (Обратная разработка):** + * Если вы написали код вручную в `.py` файле, нажмите кнопку **Import** в панели инструментов редактора. + * Выберите ваш `.py` файл, и форма в редакторе перестроится согласно коду. + +## Требования + +* **VS Code** версии 1.75.0 или выше. +* **Python 3** (для запуска сгенерированного кода). + +--- +*Разработано в рамках производственной практики. 2025 г.* \ No newline at end of file