「TabControl コントロール」の使い方について。

　こんにちは、皆さん。今日は、Ｃ＃の「フォームコントロール」の中でも、非常に重要な「タブコントロール（TabControl コントロール）」について、お話ししたいと思います。

　そうですね、その他に重要なフォームコントロールとしては、「TextBox コントロール」、「RichTextBox コントロール」、「PictureBox コントロール」、「DataGridView コントロール」、

「PropertyGrid コントロール」、「MenuStrip コントロール」、「FileDialog コントロール」等があります。

　全て、非常に重量級なコントロールであり、個人では殆ど作れない物なので、非常に助かります。m(_ _)m

　そういう意味では、ＲＡＤツールとしての「Ｃ＃」の、真骨頂だと思います。

　因みに、ＲＡＤツールというのは、出来るだけ「プログラムコード」を書かないで、高品質なアプリケーションを、短期間で作成するというコンセプトです。

　それでは、その辺りを見て行きましょう。Let’s get started !.

タブコントロールで、何が出来るのでしょうか？

　タブコントロールというのは、限られた領域（画面）で「階層構造」のように、データを編集・表示ができる優れたコントロールです。

　分かり易くいうと、「ノート」や「手帳」や「メモ帳」ですね。そして、各項目を選択し易いように、見出しとして「タブ（付箋のようなもの）」が、付いています。

　「タブ」の下には、「各ページ」が付いていて一体化しています。これを、「タブページ（TabPage コントロール）」と言います。「タブページ」は、「Panel コントロール」と同様なので、何でも入れることが出来ます。 

　要するに、タブコントロール（TabControl コントロール）というのは、「システム手帳」のようなもので、中身の「リフィル」がタブページ（TabPage コントロール）という事になります。
　

　特徴的な事としては、「タブ」の表示には、「Multiline」と「Singleline」があります。通常は「Singleline」を使いますが、「設定」等で使う場合は、「Multiline」もあります。

　また、「タブ」の部分の描画を、自分で行うことが出来るようになっています。標準の描画では、満足できない場合等に使います。

　「タブ」の表示位置は、「上下左右」に変更することが出来ます。Visual Studio Community の場合は、「下」に表示されることも多いですね。

　一応、一般的なことは、こんな所です。
　

　ここからは、少し「High レベル」な事になるのですが、「タブコントロール」には、「Paint イベント」がありません。ですから、基本的には、ユーザーから「タブの描画」を行うことが出来ません。

　まぁ、それは「Ｃ＃」としては、妥当な仕様だと思います（私なりに）。何故なら、「タブ」を描画するというのは、可なり難しいからです。

　ところが、「ある事情」が発生する場合には、そうも言ってられないのです。どうしても、「タブの描画」すなわち「Paint イベント」が必要になります。
　

　というのは、「タブコントロール」には、唯一「閉じるボタン」がありません。例えば、「ブラウザー」や「ＶＳＣｏｄｅ」や「ＩＤＥ」でお馴染みの、「閉じるボタン」です。

　「ＷＰＦ」では、「XAML コードエディター」で、追加することが出来ますが、「Ｃ＃」では出来ません。因みに、私自身は、「ＷＰＦ」を習得していません。情報だけです（汗）。

　ですから、「タブページ」を増やすことは出来ても、減らすことが出来ません（激汗）。これは、非常に困ります。これが、「ある事情」になります。

Ｃ＃で「閉じるボタン」は、作れるのでしょうか？

　というのが、最も心配なところだと思うのですが、結論からいうと、色々な方法があるので、安心して下さい。

　とは言うものの、実は、其々に一長一短があるので、これが「正解」というのは、ありません。

　ただ、やる気次第では、「ブラウザー」や「ＶＳＣｏｄｅ」や、「ＩＤＥ」のような「閉じるボタン」も、立派に作れます。 

　そして、最も難しいのは、これらの「プログラムコード」を実装することではなく、「一長一短」がある方法の、どれを採用するかという決断です。

　何故なら、その一長一短というのが、本当に「微妙な思案」なんです。皆さんが知っている熟語でいうと、「思案六法」というところですかね（笑）。
　

　方法論としては、タブコントロールに、「ボタン」を追加することは出来ないので、「Paint イベント」又は、「DrawItem イベント」と、「MouseDown イベント」、「MouseMove イベント」、

「MouseUp イベント」を駆使して、恰も「ボタン」を押しているような、描画を行います。

　これらは、「滅茶苦茶」難しいという分けではありませんが、ある程度難しいです。ですから、これ等の方法に関しては、「次回の記事」で詳しく説明したいと思います。
　

　そして、もう一つ、「閉じるボタン」と同じような効果があり、「Ｃ＃」的には「最もＣ＃的」であり、「最も簡単」であり、「最も確実」であり、「最も実用的」である方法があります。

　更に、今回の「閉じるボタン」の場合だけでなく、困った時に「確実に問題を解決する方法」を提供してくれる、非常に優れた方法があります（パワー）。

　それは、「灯台下暗し」ではありませんが、「ContextMenuStrip コントロール」を、使うことなんです（Good）。

　今回は、この「ContextMenuStrip コントロール」を使って、「閉じるボタン」を実装してみましょう。

ContextMenuStrip コントロールを、習得しましょう。

　それでは、早速、「ContextMenuStrip コントロール」を、使いましょう！。と言いたい所なんですが、さて、何処に貼るのでしょうか？

　Form コントロールに、「TabControl コントロール」と、「ContextMenuStrip コントロール」を、貼るだけでも良いのですが、当サイトでは、過去の記事で「基本の Form 形態」を提供しています。

　ですから、それを使って、解説することになります。既に、習得している方は良いのですが、まだ習得していない方は、当サイトの「オススメ記事」を参考にして、

「基本の Form 形態」を作成してみましょう。結構、ボリュームはありますが、「未来の記事」をより深く理解するためには、是非オススメします。 

　具体的な作成手順は、以下の記事を参照してください。

Ｅｉｍａの何でもファイトラボ

当サイトで扱う、「基本の Form 形態」について。 | Ｅｉｍａの何でもファイトラボ 　当サイトで扱う「基本の Form 形態」について、詳しく解説しています。ある程度の「スケルトン」や「テンプレート」は、有った方が良いと思います。

　そして、今回使用するのは、上記記事の中の三番目の「BaseTabForm」です。画像は、上記記事の中にあります（一番下の画像です）。

　この形態を使って、「ContextMenuStrip コントロール」を、習得する事になります。

　それでは、これから、プラモデルを組むかのように、手順を示して行きます。そして、「BaseTabForm プロジェクト」は、既に、何処かに、作成されている物とします（これが一番重要）。

「NormalTabForm プロジェクト」を作成します。

　特に、名前は、何でも良いのですが、次回の記事で「CloseTabForm プロジェクト」を作成する予定なので、違いが分かるようにしています。

　先ず、「Visual Studio Community」を起動して、「Windows フォーム アプリケーション (.NET Framework)」を作成します（通常）。

　この時の「プロジェクト名」を、「NormalTabForm」にします。

　詳しいことは、以下の記事を参照してください。

Ｅｉｍａの何でもファイトラボ

C# の開発環境 | Ｅｉｍａの何でもファイトラボ C# の環境として、Visual Studio Community 2022 をインストールして、起動します。最も標準的で、必要不可欠な「インストールと登録」の方法を説明します。個人で使用する…

　そして、「NormalTabForm プロジェクト」が起動できたら、次に、上記の記事「当サイトで扱う、基本の Form 形態について」で、既に作成済の「BaseTabForm プロジェクト」を、起動します。

　これで、Visual Studio Community の「二つのプロジェクト」が、起動している状態です。この方法は、「Visual Studio の開発手法」としては、良くあることなので、この際に習得して置きましょう。

　プロジェクトを、「複数」起動することは、良くあります。「コピー＆ペースト」する場合とか、「比較」する場合とかです。

　それでは、非常に細かい事まであるのですが、「少しずつ確実」に実装して行きましょう。エラーに関しては、余り気にする必要はありません。必ず、修正できるので。 

　というのは、マネージドコードなので、プログラムが暴走することはありませんし、エラーの個所は、必ず分かります。

先ず、「BaseTabForm.cs」を、コピー＆ペーストします。

　最初に行うことは、「BaseTabForm プロジェクト」の中にある、「BaseTabForm.cs（本体の Form）」を、「NormalTabForm プロジェクト」に「コピー」することです。

　これによって、一から「基本的な Form」を作成するのではなく、簡単に、複製ができます。勿論、「基本的な Form 形態」なので、これを「NormalTabForm.cs」に変更してから、目的の実装を行います。

　この流れは、一番確実な方法なんですが、多少冗長的な方法になります。しかし、初心者の方には、多分一択かも知れません（笑）。

　その他のスマートな方法としては、各クラス（コントロールクラスを含めて）を、「クラスライブラリー」として作成して、参照設定するという方法もありますが、結構難しいです。

　しかしこの方法の良い所は、クラスを「部品」として再利用できるので、ＩＤＥの「拡張クラス」として、扱えることです。まぁしかし、それは将来にとって置きましょう。

　それでは、これから「その手順」を示しますが、急がずにゆっくりと遣りましょう。また、適度に起動「Ｆ５」して、状況を確認しましょう。

　何故、「エラーになるのか？」ということが、徐々に分かって来ると思います。因みに、全てを完了しないと、必ずエラーになります（笑）。

　重要なことは、「Ｃ＃」というのは「マネージドコード」なので、「暴走」するということは無いので、安心して「実行（Ｆ５）」してください。

　また、万が一「暴走」したとしても、「タスクマネージャー」で、確実に終了することが出来るので、安心してください。

　それでは、これから、「長い旅」になるので、「コーヒーブレイク」をしてから、参りましょう。 

それでは、ここからが「手順（長文）」です。

　上記の説明にあるように、ここでは既に、「NormalTabForm プロジェクト（新規）」と、「BaseTabForm プロジェクト（既存）」とが、起動している状態とします。

　
　これで一応、一段落です。この手順は、アプリケーション開発においては、比較的「原始的な方法」ではありますが、「最も安全」で、「最も簡単」で、「最も早い」方法です（笑）。

　この際に、是非、マスターして置きましょう。 

　しかし、まだまだ、先は長いです（汗）。一旦、「コーヒーブレイク」を取りましょう。

　さぁ、長い冬も、そろそろ終わりですね。後、半月もすれば「桜」の季節です。

　 私の近所でも、「良い桜の木」が、結構何本も咲くので、良い感じですよ。まぁ、写真に撮って「アイキャッチ画像」に使おうかな？、とも考えているのですが・・・（笑）。

　しかし、「桜の色」というのは、何であんなに「心に響く」のでしょうか？。特に「ソメイヨシノ」は、別格ですね。

　年に一度、しかも「ほんの一瞬」の期間ですが、心が洗われます。

それでは、NormalTabForm.cs を作成して行きましょう。

　それでは、基本的な準備が整ったので、「NormalTabForm.cs」を完成させましょう。

　難しいことは、何もありませんが、少々細かい手順もあるので、焦らずにゆっくりと遣りましょう。

最後に、「イベント」に、ソースコードを実装しましょう。

　さぁ、漸くここまで来ましたね。実は、ここまでが、一番大変な作業であり、一番楽しい作業なんです。 

　何故なら、これまでの一連の作業は、「設計」なんです。そして、ソースコードを実装するというのが、実は「施工」なんです。よく言われるのが、「設計七年、施工三年」なんですね（爆笑）。

　どこまで、「ユーザーフレンドリー」にするのかは、「設計」に掛かっています（パワー）。 

　それでは、最後に、全ての「ソースコード」を書いて置きます。しかしこれは、自分で全てを実装（ソースコードを作成）してから、見てください。急ぐ場合を除いて（笑）。

　難しいことは何もありませんが、初心者の方が、マニュアルを頼りに実装するのは、「天文学的」に難しいと思います。しかしそれは、色んな事を参照する「機会」になります。

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace NormalTabForm
{
    /// <summary>
    /// NormalTabForm を提供します。
    /// </summary>
    public partial class NormalTabForm : Form
    {
        /// <summary>
        /// 新しいインスタンスを作成します。
        /// </summary>
        public NormalTabForm()
        {
            // デザイナーが行う初期設定です。
            InitializeComponent();

            // 個人的な初期設定を行います。
            InitializeMyMember();

            // 特定のコントロールを、アクティブにしないようにします。
            // 通常は、特に必要ありません。
            this.Select();
        }

        #region ● 初期設定

        /// <summary>
        /// 初期設定を行います。
        /// </summary>
        private void InitializeMyMember()
        {
            // プロパティ等を確実に設定したい場合は、コードで設定します。
            // （また、動的な状態で設定したい場合は、起動時イベントを使います。）
            SplitContainer.SplitterDistance = 445;

            // TabPage の背景色を、Control にします。
            // まとめて設定したい場合も、コードで設定します。
            foreach (TabPage tp in SideTabControl.TabPages)
            {
                tp.BackColor = SystemColors.Control;
            }

            // 最初のご挨拶。特に必要ありません。
            MessageStatusLabel.Text = "NormalTabForm を提供します。";
        }

        #endregion

        #region ● イベント

        /// <summary>
        /// 右ペインを閉じたり開いたりします。
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        /// <remarks>ステータスラベルは、色々と活用出来ます。</remarks>
        private void PaneStatusLabel_Click(object sender, EventArgs e)
        {
            if (SplitContainer.Panel2Collapsed == false)
            {
                SplitContainer.Panel2Collapsed = true;
                PaneStatusLabel.Text = "ペインを開く";
            }
            else
            {
                SplitContainer.Panel2Collapsed = false;
                PaneStatusLabel.Text = "ペインを閉じる";
            }
        }

        /// <summary>
        /// タブページを先頭に移動します。
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void FirstTabMenuItem_Click(object sender, EventArgs e)
        {
            if (NormalTabControl.SelectedIndex == 0) return;

            // タブページを先頭に移動します。
            TabPage tabPg = NormalTabControl.SelectedTab;

            NormalTabControl.TabPages.Remove(tabPg);
            NormalTabControl.TabPages.Insert(0, tabPg);
            NormalTabControl.SelectedTab = tabPg;
        }

        /// <summary>
        /// タブページを左に移動します。
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void LeftTabMenuItem_Click(object sender, EventArgs e)
        {
            if (NormalTabControl.SelectedIndex == 0) return;

            // タブページを左に移動します。
            int tabInd = NormalTabControl.SelectedIndex;
            TabPage tabPg = NormalTabControl.SelectedTab;

            NormalTabControl.TabPages.Remove(tabPg);
            NormalTabControl.TabPages.Insert(tabInd - 1, tabPg);
            NormalTabControl.SelectedTab = tabPg;
        }

        /// <summary>
        /// タブページを右に移動します。
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void RightTabMenuItem_Click(object sender, EventArgs e)
        {
            if (NormalTabControl.SelectedIndex ==
                NormalTabControl.TabCount - 1) return;

            // タブページを右に移動します。
            int tabInd = NormalTabControl.SelectedIndex;
            TabPage tabPg = NormalTabControl.SelectedTab;

            NormalTabControl.TabPages.Remove(tabPg);
            NormalTabControl.TabPages.Insert(tabInd + 1, tabPg);
            NormalTabControl.SelectedTab = tabPg;
        }

        /// <summary>
        /// タブページを末尾に移動します。
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void LastTabMenuItem_Click(object sender, EventArgs e)
        {
            if (NormalTabControl.SelectedIndex ==
                NormalTabControl.TabCount - 1) return;

            // タブページを末尾に移動します。
            TabPage tabPg = NormalTabControl.SelectedTab;

            NormalTabControl.TabPages.Remove(tabPg);
            NormalTabControl.TabPages.Insert(
                NormalTabControl.TabCount, tabPg);
            NormalTabControl.SelectedTab = tabPg;
        }

        /// <summary>
        /// タブページを閉じます。
        /// </summary>
        /// <remarks>
        /// 通常、ドキュメント等を閉じる場合は、保存処理等が
        /// 必要なのですが、ここでは省略します。
        /// </remarks>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void CloseTabMenuItem_Click(object sender, EventArgs e)
        {
            DialogResult ret = MessageBox.Show(
                "\"" + NormalTabControl.SelectedTab.Text + "\"" +
                " のタブページを閉じますか？", this.Text,
                MessageBoxButtons.OKCancel);

            // タブページを閉じます。
            if (ret == DialogResult.OK)
            {
                NormalTabControl.TabPages.Remove(
                    NormalTabControl.SelectedTab);
            }
        }

        #endregion
    }
}

　重要なのは、「結果」ではありません。何かに挑戦するという「ファイト」です。頑張りましょう。「千里の道も一歩から」ですよ（笑）。

さぁ、最後に、サプライズ（Suprise）です。

　ここ迄の結果を、表示して置きます。以下のような「画面」が起動できたら、成功です。 

　後は、「TabControl コントロール」上で、「右クリック」すると、「コンテキストメニュー」が表示されます。色々と遊んでみましょう（笑）。

　また、プロパティグリッドでも、色々と変更ができるので、遊んでみましょう（笑）。

　更に、この「NormalTabForm プロジェクト」を基本として、アプリケーションを発展することも出来ます。当サイトによる制限は無いので、自由に使用してください。

まとめ。

　さぁ、如何でしたでしょうか？。簡単だったでしょうか？、それとも、難しかったでしょうか？

　何方にしても、重要なのは、見ているだけではなく、実際に試して見ることです。自分の目で見て、自分の体で感じて、一歩ずつ前に進みましょう。

　他人の評価も重要ですが、自分の「大志」は更に重要です。失敗したことは、何時か、何かの役に立つ時も来るでしょう。その日まで、頑張りましょう（待てば海路の日和あり）。 

　まだまだ、「天文学的」に難しいことは、星の数ほどあります。しかしそれ等は、この基本的なことの「積み重ね」だと思います。

　それでは、この辺でごきげんよう。(^_^)/