ikkVisualKit 0.0.0__py3-none-any.whl

ikkVisualKit/CTkUiBase.py

@@ -0,0 +1,555 @@
+import customtkinter as ctk
+import os
+import tkinter as tk
+from pathlib import Path
+from typing import Optional, Callable, Any
+from importlib.resources import files
+from io import BytesIO
+
+from PIL import Image
+
+
+class CTkButtonWithTooltip(ctk.CTkButton):
+    """ツールチップ対応のカスタムCTkButtonクラス"""
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self._ui_base: Optional['CTkUiBase'] = None
+        self._command: Optional[Callable[[], Any]] = None
+    
+    @property
+    def tooltip_text(self) -> Optional[str]:
+        """ツールチップテキストを取得"""
+        if self._ui_base:
+            return self._ui_base._button_tooltips.get(self)
+        return None
+    
+    @tooltip_text.setter
+    def tooltip_text(self, value: Optional[str]):
+        """ツールチップテキストを設定"""
+        if self._ui_base:
+            if value:
+                self._ui_base._button_tooltips[self] = value
+            else:
+                self._ui_base._button_tooltips.pop(self, None)
+    
+    @property
+    def command(self) -> Optional[Callable[[], Any]]:
+        """クリック時のコマンドを取得"""
+        return self._command
+    
+    @command.setter
+    def command(self, func: Optional[Callable[[], Any]]):
+        """クリック時のコマンドを設定"""
+        self._command = func
+        if func is not None:
+            self.configure(command=func, state=tk.NORMAL)
+        else:
+            self.configure(state=tk.DISABLED)
+
+
+class TextInputPair:
+    """ラベルとテキストボックスのペア"""
+    def __init__(self, label: ctk.CTkLabel, entry: ctk.CTkEntry):
+        self.label = label
+        self.entry = entry
+        self._ui_base: Optional['CTkUiBase'] = None
+    
+    @property
+    def tooltip_text(self) -> Optional[str]:
+        """ツールチップテキストを取得"""
+        if self._ui_base:
+            return self._ui_base._entry_tooltips.get(self.entry)
+        return None
+    
+    @tooltip_text.setter
+    def tooltip_text(self, value: Optional[str]):
+        """ツールチップテキストを設定"""
+        if self._ui_base:
+            if value:
+                self._ui_base._entry_tooltips[self.entry] = value
+            else:
+                self._ui_base._entry_tooltips.pop(self.entry, None)
+    
+    @property
+    def display_text(self) -> str:
+        """表示テキストを取得"""
+        return self.entry.get()
+    
+    @display_text.setter
+    def display_text(self, text: str):
+        """表示テキストを設定（読み取り専用テキストボックスに値を設定）"""
+        # 読み取り専用を一時的に解除して値を設定
+        self.entry.configure(state="normal")
+        self.entry.delete(0, "end")
+        self.entry.insert(0, text)
+        self.entry.configure(state="disabled")
+        
+        # 背景色を黄色く2回点滅
+        self._blink_entry()
+    
+    def _blink_entry(self):
+        """エントリーの背景色を黄色く2回点滅"""
+        if not self._ui_base or not self._ui_base._tkRoot:
+            return
+        
+        blink_state = [0]  # 点滅状態を保持（0=黄→1=元→2=黄→3=元→終了）
+        original_bg = self.entry.cget("fg_color")  # 元の背景色を保存
+        
+        def toggle_color():
+            if blink_state[0] % 2 == 0:
+                self.entry.configure(fg_color="#FFFF00")  # 黄色
+            else:
+                self.entry.configure(fg_color=original_bg)  # 元の色
+            
+            blink_state[0] += 1
+            if blink_state[0] < 4:  # 4回の遷移 = 2回点滅
+                self._ui_base._tkRoot.after(300, toggle_color)
+        
+        toggle_color()
+    
+    # 後方互換性のための value プロパティ
+    @property
+    def value(self) -> str:
+        """テキストボックスの値を取得（deprecated: display_text を使用してください）"""
+        return self.display_text
+    
+    @value.setter
+    def value(self, text: str):
+        """テキストボックスの値を設定（deprecated: display_text を使用してください）"""
+        self.display_text = text
+
+
+class LogViewBox:
+    """ログ表示用テキストボックス"""
+    def __init__(self, text_widget: ctk.CTkTextbox, x: int, y: int, width: int, initial_lines: int = 2):
+        self.text_widget = text_widget
+        self.x = x
+        self.y = y
+        self.width = width
+        self.lines = initial_lines
+        self.parent = None
+        
+        # ログレベルごとの色定義
+        self._log_level_colors = {
+            "ERROR": "#ff6b6b",    # 赤
+            "WARN": "#ffa500",     # オレンジ
+            "INFO": "#4dabf7",     # 青
+            "DEBUG": "#909090"     # グレー
+        }
+        
+        # タグ設定
+        for level, color in self._log_level_colors.items():
+            text_widget.tag_config(level, foreground=color)
+    
+    def add_log(self, message: str, level: str = "INFO"):
+        """ログを追加（最下行に追加、自動スクロール）"""
+        if level not in self._log_level_colors:
+            level = "INFO"
+        
+        # テキストボックスを編集可能に
+        self.text_widget.configure(state="normal")
+        
+        # ログエントリを作成
+        log_entry = f"[{level}] {message}\n"
+        
+        # 末尾に追加
+        start_index = self.text_widget.index("end-1c")
+        self.text_widget.insert("end", log_entry)
+        
+        # ログレベルに応じて色付け
+        end_index = self.text_widget.index("end-1c")
+        self.text_widget.tag_add(level, start_index, end_index)
+        
+        # 最下行にスクロール
+        self.text_widget.see("end")
+        
+        # 読み取り専用に戻す
+        self.text_widget.configure(state="disabled")
+    
+    def expand(self, lines: int):
+        """表示行数を拡張"""
+        self.lines = lines
+        line_height = 20  # 1行あたりのピクセル高さ（概算）
+        new_height = lines * line_height + 10
+        self.text_widget.configure(height=new_height)
+    
+    def collapse(self):
+        """デフォルト表示に戻す"""
+        self.expand(self.lines)
+    
+    def clear(self):
+        """ログをクリア"""
+        self.text_widget.configure(state="normal")
+        self.text_widget.delete("1.0", "end")
+        self.text_widget.configure(state="disabled")
+    
+    @property
+    def tooltip_text(self) -> Optional[str]:
+        """ツールチップ（互換性のため）"""
+        return None
+    
+    @tooltip_text.setter
+    def tooltip_text(self, value: Optional[str]):
+        """ツールチップ設定"""
+        if self.parent and value:
+            self.parent._entry_tooltips[self.text_widget] = value
+
+
+class CTkUiBase:
+    """
+    Tkは必ずメインスレッドで動かす。
+    サブクラスは _build(self, root) をオーバーライドする。
+    """
+    # パッケージリソースのイメージディレクトリ
+    _image_dir = files('ikkVisualKit').joinpath('image')
+    
+    # ==========================================
+    def __init__(self
+        ,title: str = "Title"
+        ,size: tuple[int, int] = (600, 300)
+        ,icon_path: Optional[str] = None
+        ):
+        '''コンストラクタ
+        title: ウィンドウタイトル
+        size: ウィンドウサイズ (幅, 高さ)
+        icon_path: アイコン画像のパス（必要に応じて指定、Noneの場合はデフォルトアイコン）
+        '''
+        # テーマ設定
+        ctk.set_appearance_mode("Light")
+        ctk.set_default_color_theme("green")        
+        self._title = title
+        self._size = size
+        self._icon_path = icon_path
+        self._tkRoot: Optional[ctk.CTk] = ctk.CTk()
+        self._tooltip: Optional[tk.Toplevel] = None
+        self._button_tooltips: dict[ctk.CTkButton, str] = {}
+        self._entry_tooltips: dict[ctk.CTkEntry, str] = {}
+        #画像をキーで管理する辞書
+        self._images: dict[str, ctk.CTkImage] = {}
+
+        # 汎用画像を起動時に自動登録
+        self._register_common_images()
+        self._tkRoot.title(self._title)
+        self._tkRoot.geometry(f"{self._size[0]}x{self._size[1]}")
+        self._tkRoot.protocol("WM_DELETE_WINDOW", self._handle_close)
+
+        # UI構築
+        self._build(self._tkRoot)
+    # ==========================================
+    # サブクラス用
+    # ==========================================
+    def _build(self, root: ctk.CTk):
+        """UI構築（サブクラスでオーバーライド）"""
+        # ウィンドウアイコン（.ico）
+        iconPath = self._icon_path
+        if iconPath and os.path.exists(iconPath):
+            root.iconbitmap(iconPath)
+    # ==========================================
+    # 他スレッドから安全にUI処理を投げる
+    # ==========================================
+    def invoke_ui(self, func: Callable, *args, **kwargs):
+        if not self._tkRoot:
+            return
+        self._tkRoot.after(0, lambda: func(*args, **kwargs))
+    # ==========================================
+    # 表示制御
+    # ==========================================
+    def show_window(self):
+        if not self._tkRoot:
+            return
+        self._tkRoot.deiconify()
+        self._tkRoot.lift()
+
+    def hide_window(self):
+        if not self._tkRoot:
+            return
+        self._tkRoot.withdraw()
+    # ==========================================
+    # 終了制御
+    # ==========================================
+    def close(self):
+        if self._tkRoot:
+            self._tkRoot.destroy()
+            self._tkRoot = None
+    #--------------------------------------------
+    def _handle_close(self):
+        self._on_close()
+    #--------------------------------------------
+    def _on_close(self):
+        """×ボタン動作（必要なら継承先で上書き）"""
+        self.close()
+    # ==========================================
+    # mainloop開始（必ずメインスレッドで呼ぶ）
+    # ==========================================
+    def run(self):
+        if self._tkRoot:
+            self._tkRoot.mainloop()
+    #==========================================
+    # ボタン作成
+    def make_ActionButton(self,
+        x: int,y: int,  #位置
+        text: Optional[str]="",      #表示する文字
+        command: Optional[Callable[[], Any]] = None, #割り当てるメソッド
+        image_key: Optional[str] = None,
+        compound: str = "left",
+        size_rank: int = 0,  # 0=48x32, 1=96x64(ライトブルー), 2=128x64(Lime)
+    ) -> Optional[ctk.CTkButton]:
+        """共通ボタン生成
+        size_rank=0: 通常サイズ（幅48、高さ32）グレー
+        size_rank=1: 中サイズ（幅96、高さ64）ライトブルー
+        size_rank=2: 大サイズ（幅128、高さ64）Lime
+        """
+        if not self._tkRoot:
+            return None
+        
+        # size_rankに応じてパラメータを変更
+        if size_rank == 1:
+            btn_width = 96
+            btn_height = 64
+            btn_font_size = 12
+            btn_compound = "bottom"  # アイコンの下に文字
+            fg_color = "#ADD8E6"  # ライトブルー
+            hover_color = "#87CEEB"  # スカイブルー
+        elif size_rank == 2:
+            btn_width = 128
+            btn_height = 64
+            btn_font_size = 12
+            btn_compound = "bottom"  # アイコンの下に文字
+            fg_color = "#00FF00"  # Lime
+            hover_color = "#32CD32"  # ライムグリーン
+        else:  # size_rank == 0
+            btn_width = 48
+            btn_height = 32
+            btn_font_size = 12
+            btn_compound = compound
+            fg_color = "#c3c3c3"  # グレー
+            hover_color = "#DB8D0F"  # オレンジ
+        
+        #ボタンの基本スタイル
+        button_kwargs: dict[str, Any] = {
+            "text": text,
+            "width": btn_width,
+            "height": btn_height,
+            "state": tk.NORMAL if command is not None else tk.DISABLED,
+            "fg_color": fg_color,
+            "hover_color": hover_color,
+            "text_color": "black",
+            "font": ctk.CTkFont(size=btn_font_size, weight="normal"),
+            "border_width": 2,
+            "border_color": "#004382",
+            "corner_radius": 4,
+        }
+
+        if command is not None:
+            button_kwargs["command"] = command
+        #画像があれば追加
+        image = self.get_image(image_key) if image_key else None
+        if image is not None:
+            button_kwargs["image"] = image
+            button_kwargs["compound"] = btn_compound
+        #ボタン生成
+        btn = CTkButtonWithTooltip(self._tkRoot, **button_kwargs)
+        btn._ui_base = self  # UIBase参照を設定
+        
+        # デフォルトの色を保存
+        default_fg_color = button_kwargs["fg_color"]
+        hover_fg_color = button_kwargs["hover_color"]
+        
+        #マウスホバー処理
+        def on_enter(event):
+            btn.configure(fg_color=hover_fg_color, text_color="black")
+            tooltip_text = self._button_tooltips.get(btn)
+            if tooltip_text:
+                self._show_tooltip(btn, tooltip_text)
+        #マウスホバー解除処理
+        def on_leave(event):
+            btn.configure(fg_color=default_fg_color, text_color="black")
+            self._hide_tooltip()
+        #ホバーイベントのバインド
+        btn.bind("<Enter>", on_enter)
+        btn.bind("<Leave>", on_leave)
+        btn.place(x=x, y=y)
+        return btn
+    #--------------------------------------------------------
+    def set_button_tooltip(self, button: ctk.CTkButton, text: Optional[str]):
+        """生成済みボタンへツールチップを後付け設定する。"""
+        if text:
+            self._button_tooltips[button] = text
+            return
+
+        self._button_tooltips.pop(button, None)
+        self._hide_tooltip()
+    #========================================================
+    # テキスト入力フィールド作成
+    def make_labelTextBox(self,
+        x: int, y: int,     # ラベルの左上座標
+        label_text: str,    # ラベルのテキスト
+        width: int = 200,   # 幅
+        entry_text: str = "",  # テキストボックスの初期テキスト
+    ) -> Optional[TextInputPair]:
+        """ラベルとテキストボックスのペアを生成"""
+        if not self._tkRoot:
+            return None
+        # ラベル生成
+        _labnel_height = 32
+        label = ctk.CTkLabel(
+            self._tkRoot,
+            text=label_text,
+            font=ctk.CTkFont("Meiryo",size=16,weight="normal"),
+            width=width,
+            height=_labnel_height,
+            anchor="e",      # ウィジェット内での位置を右側に（east）
+            justify="right",  # 複数行のテキストを右揃えに
+        )
+        label.place(x=x, y=y)
+        # テキストボックス生成
+        entry = ctk.CTkEntry(
+            self._tkRoot,
+            font=ctk.CTkFont(size=30),
+            width=width,
+            height=48,
+            justify="center",
+            border_width=1,
+            border_color="#124463",
+            corner_radius=1,    #角丸
+        )
+        entry.place(x=x, y=y + _labnel_height)
+        entry.insert(0, entry_text)
+        # 読み取り専用に設定
+        entry.configure(state="disabled")
+        # ホバーイベント設定
+        def on_enter(event):
+            tooltip_text = self._entry_tooltips.get(entry)
+            if tooltip_text:
+                self._show_tooltip(entry, tooltip_text)
+        #マウスホバー解除処理
+        def on_leave(event):
+            self._hide_tooltip()
+        #ホバーイベントのバインド
+        entry.bind("<Enter>", on_enter)
+        entry.bind("<Leave>", on_leave)
+        # ペアオブジェクト生成
+        pair = TextInputPair(label, entry)
+        pair._ui_base = self
+        
+        return pair
+    #========================================================
+    # ログ表示ボックス作成
+    def make_LogTerminal(self,
+        x: int, y: int,           # 左上座標
+        width: int = 300,         # 幅
+        initial_lines: int = 2,   # 初期表示行数
+    ) -> Optional[LogViewBox]:
+        """ログ表示用テキストボックスを生成"""
+        if not self._tkRoot:
+            return None
+        # CTkTextbox生成
+        textbox = ctk.CTkTextbox(
+            self._tkRoot,
+            width=width,
+            height=initial_lines * 20 + 10,
+            font=ctk.CTkFont("Courier", size=10),
+            border_width=1,
+            border_color="#000000",
+            corner_radius=4,
+        )
+        textbox.place(x=x, y=y)
+        textbox.configure(state="disabled")  # 読み取り専用
+        
+        # ログビューボックス生成
+        log_view = LogViewBox(textbox, x, y, width, initial_lines)
+        log_view.parent = self
+        
+        return log_view    
+    #========================================================
+    #UIに使う画像の登録
+    def register_image(self, key: str, filename: str, size: tuple[int, int] = (32, 24)) -> bool:
+        """imageフォルダ配下の画像をキーで登録する（主用途: png）
+        size: 画像サイズ（幅, 高さ）デフォルト(32, 24)でボタン内にフィッティング
+        """
+        try:
+            image_file = self._image_dir.joinpath(filename)
+            if not image_file.is_file():
+                return False
+            pil_image = Image.open(BytesIO(image_file.read_bytes()))
+            self._images[key] = ctk.CTkImage(light_image=pil_image, dark_image=pil_image, size=size)
+            return True
+        except Exception:
+            return False
+
+    def get_image(self, key: str) -> Optional[ctk.CTkImage]:
+        return self._images.get(key)
+
+    def _register_common_images(self):
+        """baseクラスで汎用利用するpngを事前登録する。"""
+        try:
+            for image_path in self._image_dir.iterdir():
+                if image_path.name.endswith('.png'):
+                    # 拡張子なしファイル名をキーとして登録（例: setting.dio.png -> setting.dio）
+                    self.register_image(image_path.name[:-4], image_path.name)
+        except Exception:
+            # イメージディレクトリが存在しない場合は何もしない
+            pass
+            
+    # アイコンリスト（icoファイルのアイコンはTkinterで直接扱えないため、ここではpngを想定）
+    @staticmethod
+    def icon_list() -> list[str]:
+        """imageフォルダ内のpngファイル名のリストを返す"""
+        try:
+            image_dir = files('ikkVisualKit').joinpath('image')
+            return [p.name[:-4] for p in image_dir.iterdir() if p.name.endswith('.png')]
+        except Exception:
+            return []
+    #-------------------------------------------------------------------
+    #ツールチップ表示
+    #-------------------------------------------------------------------
+    def _show_tooltip(self, widget, text):
+        self._hide_tooltip()
+        if not self._tkRoot:
+            return
+        #ウィジェットの位置を取得してツールチップを表示
+        x = widget.winfo_rootx() + (widget.winfo_width() /2)+4
+        y = widget.winfo_rooty() - (widget.winfo_height() /2)-4
+        #
+        tooltip = tk.Toplevel(self._tkRoot)
+        tooltip.wm_overrideredirect(True)
+        tooltip.wm_geometry(f"+{int(x)}+{int(y)}")
+        tooltip.configure(bg="#CCCCCC")
+        tooltip.attributes("-alpha", 0.7)#半透明
+        #ツールチップとして表示させるラベルの設定
+        label = tk.Label(
+            tooltip,
+            text=text,
+            justify="left",
+            bg="#CCCCCC",
+            fg="black",
+            relief="solid",
+            borderwidth=1,
+            padx=8,
+            pady=4,
+            font=("Meiryo", 10),
+        )
+        label.pack()
+        self._tooltip = tooltip
+    #ツールチップ非表示
+    def _hide_tooltip(self):
+        if self._tooltip is not None:
+            self._tooltip.destroy()
+        self._tooltip = None
+
+#####################################################################
+#
+#####################################################################
+if __name__ == "__main__":
+    window = CTkUiBase(title="テスト", size=(400, 200,), icon_path="../../icon.ico")
+    window.show_window()
+
+    # 2秒後に閉じる
+    def _close_later():
+        if window._tkRoot:
+            window._tkRoot.after(2000, window.close)
+
+    window.invoke_ui(_close_later)
+
+    window.run()
+    print("ウィンドウを閉じました")

ikkVisualKit/Dialog/CdialogBase.py

@@ -0,0 +1,96 @@
+# DialogBase.py
+from enum import Enum
+import customtkinter as tk
+
+
+class CdialogResult(Enum):
+    NONE = 0
+    OK = 1
+    CANCEL = 2
+    CLOSED = 3
+    YES = 4
+    NO = 5
+
+
+class CdialogIcon(Enum):
+    INFO = "info"
+    WARNING = "warning"
+    ERROR = "error"
+
+class CdialogBase:
+    """
+    Toplevel ベースのモーダルダイアログ基底クラス
+    """
+
+    def __init__(self, parent: tk.CTk, title="Dialog", size=(400, 200)):
+        self._parent = parent
+        self._result = CdialogResult.NONE
+        self._size = size
+
+        self._tkRoot = tk.CTkToplevel(parent)
+        self._tkRoot.title(title)
+        self._tkRoot.geometry(f"{size[0]}x{size[1]}")
+        self._tkRoot.protocol("WM_DELETE_WINDOW", self._on_window_close)
+
+        self._tkRoot.transient(parent)
+        self._tkRoot.resizable(False, False)
+        self._tkRoot.withdraw()
+
+        self._build(self._tkRoot)
+
+    # ---------------------------------
+    def _build(self, root: tk.CTkToplevel):
+        pass
+    
+    # ---------------------------------
+    def _on_window_close(self):
+        self._result = CdialogResult.CLOSED
+        self._tkRoot.destroy()
+
+    # ---------------------------------
+    def _action_handle(self, result: CdialogResult):
+        self._result = result
+        self._tkRoot.destroy()
+
+    # ---------------------------------
+    def show(self) -> CdialogResult:
+        self._result = CdialogResult.NONE
+
+        self._center_to_parent()
+
+        self._tkRoot.deiconify()
+        self._tkRoot.lift()
+        self._tkRoot.grab_set()
+        self._tkRoot.focus_set()
+        self._parent.wait_window(self._tkRoot)
+
+        return self._result
+
+    # ---------------------------------
+    def _center_to_parent(self):
+        self._tkRoot.update_idletasks()
+        #画面サイズを取得
+        screen_width = self._tkRoot.winfo_screenwidth()
+        screen_height = self._tkRoot.winfo_screenheight()
+        #ダイアログのサイズ
+        w = self._size[0]
+        h = self._size[1]
+        #画面の中央にダイアログを配置
+        x = (screen_width - w) // 2
+        y = (screen_height - h) // 2
+        #ダイアログのサイズと位置を設定
+        self._tkRoot.geometry(f"{w}x{h}+{x}+{y}")
+
+#####################################################################
+# 使用例（単体テスト）
+#####################################################################
+if __name__ == "__main__":
+    root = tk.CTk()
+    root.withdraw()
+    
+
+    dlg = CdialogBase(root, title="Dialog Example", size=(400, 200))
+    result = dlg.show()
+    print(f"Dialog result: {result}")
+
+    root.destroy()