﻿SquareClick Standard 1.4 RC1
開発者向け説明書（TXT版／ファイル名・フォルダ構成更新）
========================================================

本書で使用する完成アドイン名：SquareClick.xlam
想定環境：Windows版 Excel 2019 / Excel 2021
更新日：2026年11月7日

■ 1. この説明書の位置付け
--------------------------------------------------------
・本書は、SquareClick 1.4 RC1 の開発・保守用資料です。
・完成アドインのファイル名は「SquareClick.xlam」として説明します。
・実際に「SquareClick.xlam」へ改名したバイナリの動作については、
  改名後に一度Excelで読み込みと保存の確認を行ってください。
・これまで実機検証した1.4 RC1をベースにしています。
・アドイン利用者は、通常、完成済みの SquareClick.xlam だけを
  Excelに登録します。ソースとリボン素材を個別にインストールしません。

■ 2. 開発用フォルダ構成（今回の整理内容）
--------------------------------------------------------
開発用のフォルダは、次の「2フォルダ」を中心とします。
本書のTXTファイルは、その2フォルダと同じ階層に置いて構いません。

    SquareClick_開発用/
      ├─ VBAソース/
      └─ リボンと画像/
完成した SquareClick.xlam は別の「配布用」フォルダ、または
インストール先に置いて管理してください。
開発用フォルダに .xlam を同梱する必要はありません。

【VBAソース】
  SquareClickStandard.bas   ：フォームコントロールの検出・上書き表示・切替
  SquareClickCore.bas       ：□/■の入力規則リストの検出・切替
  SquareClickSession.bas    ：保存前の一時図形削除・保存後の復元
  SquareClickRibbon.bas     ：リボンの「この文書の設定」ボタン
  ThisWorkbook_コード.txt  ：ブックイベント用コード
  Sheet1_コード.txt        ：必要に応じて保存するシートコード
  SCStdSettings_CODE.txt   ：設定画面のUserFormコード
  SCStdNoConfirm_CODE.txt  ：無効化の再確認UserFormコード

  ※上記ファイルは「VBAソース」配下のサブフォルダに整理しても構いません。
  ※実際のファイル名に「_ソース_UTF8」等が付く閲覧用コピーがある場合、
    そのファイルはVBEへの直接インポート用とは区別してください。
  ※フォームを完全に再構築するには、コードだけでなくフォームの
    .frm／.frx（ExcelのVBEから正式にエクスポートしたもの）が必要です。

【リボンと画像】
  customUI14.xml
  customUI14.xml.rels
  SquareClick_Settings_Yellow.png
  [Content_Types].xml
  _rels/.rels

  ※これらは .xlam 内の対応する場所へ組み込む素材です。
  ※画像ファイル名や階層は、実際のXMLの参照先と一致させてください。
  ※既に動作している SquareClick.xlam には素材が内蔵されます。

■ 3. 主要モジュールの役割
--------------------------------------------------------
SquareClickStandard
  フォームコントロールのチェック部分に□・■の一時図形を重ね、
  元の説明文（例：「チェック項目A」）を表示したまま動作させます。
  ブック単位の有効・無効設定も管理します。

SquareClickCore
  入力規則に登録された□・■の組み合わせを認識し、
  ワンクリックで切り替える処理を担当します。

SquareClickSession
  Excelブックの保存直前に一時図形を取り除き、保存後に再生成します。
  これにより、別PCでの外部マクロ参照・リンク切れを抑える設計です。

SquareClickRibbon
  「☑⇔■」タブの「この文書の設定」から設定画面を呼び出します。

ThisWorkbook
  Excelのブック・シートイベントを各処理へ接続します。

SCStdSettings / SCStdNoConfirm
  設定画面と初回確認時の再確認画面です。

■ 4. 1.4の表示基準値
--------------------------------------------------------
SquareClickStandard内のチェック表示用定数：

    Private Const SC14_MARK_SIZE_PT As Double = 8.7
    Private Const SC14_MARK_LEFT_PT As Double = 4
    Private Const SC14_MARK_TOP_PT As Double = 0

SCStd_RenderOverlay内の枠線の太さ：

    .Line.Weight = 0.75

Excel 2019で100%表示したとき、実機で自然な表示と確認された設定です。
Excel 2021では、表示環境によりわずかな位置差が見られました。
今後の調整では、Excelの倍率・Windowsの画面拡大率も記録してください。

■ 5. 安全な修正手順（推奨）
--------------------------------------------------------
1. Excelをすべて終了します。
2. 正常動作中の SquareClick.xlam を別の場所にバックアップします。
3. 開発用にコピーを作成します（例：SquareClick_DEV.xlam）。
4. Excel側で安定版と開発版を同時に有効化しないでください。
5. 開発版を開き、Alt + F11でVBAエディターを表示します。
6. VBAを修正し、［デバッグ］→［VBAProjectのコンパイル］を実行します。
7. 保存してExcelを終了・再起動し、テスト用ブックで動作を確認します。
8. VBAの変更がないリボン修正でも、必ず別名バックアップを残します。

注意：SquareClickStandard.basなどのモジュールを置き換える場合は、
既存の同名モジュールを解放してからインポートしてください。
ThisWorkbookは標準モジュールとしてインポートできません。
また、UserFormのコードだけを貼り付けても、フォームの部品がなければ
正しく動作しません。日常的な保守は完成済み .xlam のコピーで行うのが安全です。

■ 6. ソースからの再構築に関する注意
--------------------------------------------------------
・.basは従来のVBEインポート用としてCP932で保存されている場合があります。
  Unicode文字や日本語の破損に注意してください。
・ThisWorkbook／シートコードは、該当するオブジェクトのコード画面へ
  貼り付けます。
・UserFormはExcel上で正常に作成したものから .frm と .frx を
  エクスポートし、セットで保管することを推奨します。
・リボン定義を組み込む場合は、customUI14.xmlだけでなく、画像、
  リレーション、[Content_Types].xml内のPNG定義なども必要です。
・これらの素材をフォルダに置くだけでは完成アドインにはなりません。
  新規に .xlam を組み直す場合はExcel上でのフォーム／VBA作成と
  Office Open XMLパッケージへのリボン組込み作業が必要です。

■ 7. 有効／無効と保存処理の仕様
--------------------------------------------------------
・ブックごとの設定はCustomDocumentPropertiesの
  「SCSTD_CheckboxConsent_v1」で管理します（yes / no）。
・フォームコントロールの説明文は変更せず、チェック部分に図形を重ねます。
・保存時に一時図形を削除し、保存後に再生成します。
・入力規則リストは保存後も通常のリストとして残ります。
・対象チェックボックスがない新規ブックでは、初回確認画面は出ません。
・入力規則リストだけのブックは、確認なしで自動適用されることがあります。
・設定は「☑⇔■」→「この文書の設定」から後で切り替えられます。

■ 8. 変更後の必須確認項目
--------------------------------------------------------
[ ] Excel 2019／2021でアドインの読み込みと設定画面が正常
[ ] フォームコントロールの□/■表示とクリック操作が正常
[ ] 説明文のフォント・位置が変わらない
[ ] 入力規則リストのワンクリック切り替えが正常
[ ] 有効 → 無効 → 有効が正常
[ ] 上書き保存／名前を付けて保存が正常
[ ] 別PCで開いてリンク切れ警告が出ない
[ ] チェック状態と入力規則リストが保持される
[ ] SquareClickをアンインストールしても既存のブックが利用できる

1.4 RC1では、Excel 2019・2021で上記の主要な動作を実機確認済みです。
ただし、今後の改修版や別のWindows設定については再確認が必要です。

■ 9. 完成アドインの配置・配布
--------------------------------------------------------
推奨配置先：

    %APPDATA%\Microsoft\AddIns\SquareClick.xlam

%APPDATA%\Microsoft は開けるが AddIns がない場合は、
必要に応じて AddIns フォルダを新規作成できます。
Excelの［ファイル］→［オプション］→［アドイン］→［管理：Excel アドイン］
→［設定］→［参照］で SquareClick.xlam を登録します。

ダウンロードしたアドインが「保護ビューでは開けません」と表示される場合は、
入手元の信頼性を確認したうえで、当該 .xlam の［プロパティ］→［全般］
→［許可する／ブロックの解除］を確認します。
Excel全体のマクロ制限・保護ビューを無効にする必要はありません。
組織管理PCでは管理者の方針を優先してください。

利用者への配布には通常「SquareClick.xlam」と「利用者向けREADME」で十分です。
「VBAソース」「リボンと画像」は開発用の資料であり、一般利用者の
AddInsフォルダへコピーする必要はありません。

■ 10. 対応状況・制限
--------------------------------------------------------
実機確認済み：Windows版 Excel 2019、Excel 2021。
未確認：Excel 2024、Microsoft 365の全環境、Excel for Mac。
対象：主にExcelのフォームコントロールのチェックボックス。
対象外：ActiveXチェックボックス等、一部の特殊なコントロール。

この開発資料は独立した利用許諾契約ではありません。
一般公開時には利用条件・再配布・免責について別途整理してください。

以上
