晴耕雨読の日々

2015年11月30日月曜日

P007-自作ライブラリを使ってみる

今日の目標→

プログラムコードを使い回せたら楽じゃね？そんなプログラマの永遠の夢を実現するのがライブラリだ。今回はライブラリ自作の基礎を説明する。

●プロジェクトの準備

まずは「TextWork4」という名前で、新規プロジェクトを作る。

●前回作ったクラスを現プロジェクトに組み込んでみる

メニューバーから「プロジェクト」→「既存の項目の追加」で、ファイルダイアログを開く
前回の"TextWork3"プロジェクトのフォルダを探す
ファイル"RichReporter.cs"を選択する
「追加」ボタンの右にある「▼」記号をクリックし、「リンクとして追加」を選択する

これで前回のRichReporterのソースコードにリンクが張られ、このプロジェクトから利用できるようになった。なお、「リンクとして追加」じゃなく、ただの「追加」でも良いのだが、その場合はファイルがまるっとコピーされる。

●RichReporerクラスを利用するコードを書く

Form1.csを開く
次のコードを入力する

using System;
using System.Drawing;
using System.Windows.Forms;

namespace TextWork4
{
    public partial class Form1 : Form
    {
        // コントロール
        private RichTextBox MyTextBox;
        private Button MyStartButton;
        private TextWork3.RichReporter MyReporter;

// フォームのコンストラクタ
        public Form1()
        {
            InitializeComponent();

// タイトルバーにプログラム名を表示する
            this.Text = Application.ProductName;

// リッチテキストボックスを作る
            MyTextBox = new RichTextBox();
            MyTextBox.Name = "MyTextBox";
            MyTextBox.Anchor = AnchorStyles.Left | AnchorStyles.Right |
                                AnchorStyles.Top | AnchorStyles.Bottom;
            MyTextBox.Left = 4;
            MyTextBox.Top = 4;
            MyTextBox.Width = this.ClientSize.Width - 8;
            MyTextBox.Height = this.ClientSize.Height - 36;
            MyTextBox.Font = new Font("ＭＳ ゴシック", 12, FontStyle.Bold);

// 開始ボタンを作る
            MyStartButton = new Button();
            MyStartButton.Name = "MyStartButton";
            MyStartButton.Anchor = AnchorStyles.Left | AnchorStyles.Bottom;
            MyStartButton.Left = 4;
            MyStartButton.Top = this.ClientSize.Height - 28;
            MyStartButton.Width = 100;
            MyStartButton.Height = 24;
            MyStartButton.Text = "開始(&S)";
            MyStartButton.Click += MyStartButton_Click;

// コントロールをフォームに配置する
            this.SuspendLayout();
            this.Controls.Add(MyTextBox);
            this.Controls.Add(MyStartButton);
            this.ResumeLayout();

// 文字出力用のオブジェクトを作る
            MyReporter = new TextWork3.RichReporter(MyTextBox);
        }

// 「開始(S)」ボタンのクリック
        private void MyStartButton_Click(object sender, EventArgs e)
        {
            MyReporter.Print("ボタンを押しても");
            MyReporter.ColorPrint(Color.Red, "何もないよ！\n");
        }

}
}

こうやって前回書いたコードを読み込んで使えると、コピペとか駆使するよりずっと楽ですね。

さてここで、Print()やColorPrint()などメソッドの呼び出し方は前と同じだが、RichRepoterクラスのクラス名を、

TextWork3.RichRepoter

と長い名前で指定しているのに注目してほしい。

なぜならば、今回のプログラムは「namespace TextWork4」の中で作られているのに対し、前回のプログラムは「namespace TextWork3」で作られていたからだ。このように所属が異なるクラスを指定するには、相手のnamespaceを含む長い名前、すなわち「完全修飾名」を使わなくてはならない。

もし、いちいち完全修飾名を書くのが面倒なら、ファイル先頭で次のように宣言してもよい。

using TextWork3;

このusing宣言があれば、以後クラス名の頭の「TextWork3.」は省略できる。

●なんでnamespaceなんかがあるの

namespaceがあるのは、名前の衝突をできるだけ回避するためだ。コンパイラ内部では常に完全修飾名でクラスが区別されるので、短いクラス名が同じでもnamespaceが違えば異なるクラス名となり、名前がぶつからない。

だから実はnamespaceには、「世界の誰とも一致しない独自の単語」を採用するのが理想だったりする。デフォルトはプロジェクト名と同じnamespaceがついているが、自作ライブラリを作る場合などは、独自のかっこいいnamespaceに書き換えたうえでコードを記述していくとよい。

あ、せっかくだからこれは次回のネタに回します。

●次回の予告

ライブラリの作り方後編。自作クラスをDLL化して、それを呼び出します。

2015年11月29日日曜日

P006-色付き表示をライブラリ化

今日の目標→

前回は、「色付き文字を出力するメソッド」を作った。使ってみたら結構便利なので、他のプログラムからでも利用できるように、これをライブラリ化してみる。

●プロジェクトの作成

とりあえず「TextWork3」という名前で、新規プロジェクトを作る

●色付き文字表示用クラスRichReporterの作成

メニューバーから「プロジェクト」→「クラスの追加」を選ぶとクラス追加ウィンドウが開く
左のカテゴリで「コード」を選び、右のアイコンから「クラス」を選ぶ
名前を「RichReporter.cs」として「追加」を押すと、新しいコードウィンドウが開く
次のコードを入力する

// RichReporter.cs
using System.Drawing;
using System.Windows.Forms;

namespace TextWork3
{
    // リッチテキストボックスに色付き文字表示するクラス
    public class RichReporter
    {
        // 出力先のリッチテキストボックス
        private RichTextBox MyTextBox;

// コンストラクタ：引数で出力先を指定する
        public RichReporter(RichTextBox target)
        {
            MyTextBox = target;
        }

// 色なしのテキスト表示
        public void Print(string text)
        {
            // デフォルトの文字色で表示する
            ColorPrint(MyTextBox.ForeColor, text);
        }

// 色付きのテキスト表示
        public void ColorPrint(Color textColor, string text)
        {
            // テキストを末尾に追加する
            AddText(textColor, text);

// 20行を超えたら先頭行から削除する
            CheckLines(20);

// もし必要なら末尾までスクロールする
            ScrollToEnd();
        }

// リッチテキストボックスの末尾に色付きのテキストを追加する
        private void AddText(Color textColor, string text)
        {
            // 文書データの末尾を選択する
            MyTextBox.Select(MyTextBox.TextLength, 0);

// 文字の色を指定する
            if (MyTextBox.SelectionColor != textColor)
            {
                MyTextBox.SelectionColor = textColor;
            }

// テキストを追加する
            MyTextBox.AppendText(text);
        }

// リッチテキストボックスの行数がmaxLinesを超えないようチェックする
        private void CheckLines(int maxLines)
        {
            // 全体の行数を得る
            int nLines = MyTextBox.GetLineFromCharIndex(MyTextBox.TextLength);

if (nLines > maxLines)
            {
                // 余分な行数を得る
                int delLines = nLines - maxLines;

// 余分な文字数を得る
                int delChars = MyTextBox.GetFirstCharIndexFromLine(delLines);

// 余分な文字を先頭から削除する
                MyTextBox.Select(0, delChars);
                MyTextBox.SelectedText = "";
            }
        }

// 末尾の文字が見える位置まで、リッチテキストボックスをスクロールする
        private void ScrollToEnd()
        {
            // 文書データの末尾を選択する
            MyTextBox.Select(MyTextBox.TextLength, 0);

// 選択位置までスクロールする
            MyTextBox.ScrollToCaret();
        }

}
}

メソッドの中身は、前回（TextWork2）のForm1.csとまったく変わらないので、ほとんどコピペでいけるはず。ただしPrint()とColorPrint()は公開メソッドにするので、private宣言をpublicに修正してちょ。

●フォームからRichReporterクラスを利用する

Form1.csを開く
次のコードを入力する

// Form1.cs
using System;
using System.Drawing;
using System.Windows.Forms;

namespace TextWork3
{
    public partial class Form1 : Form
    {
        // コントロール
        private RichTextBox MyTextBox;
        private Button MyStartButton;
        private RichReporter MyReporter;

// フォームのコンストラクタ
        public Form1()
        {
            InitializeComponent();

// タイトルバーにプログラム名を表示する
            this.Text = Application.ProductName;

// 文字出力用のオブジェクトを作る
            MyReporter = new RichReporter(MyTextBox);
        }

// 「開始(S)」ボタンのクリック
        private void MyStartButton_Click(object sender, EventArgs e)
        {
            MyReporter.Print("開始ボタンを");
            MyReporter.ColorPrint(Color.Red, "押しましたね？\n");
        }

}
}

RichReporterクラスの使い方は、まず

MyReporter = new RichReporter(MyTextBox);

のように、出力先を指定してRichReporterのオブジェクトを作る。そして、

MyReporter.ColorPrint(Color.Red, "ほげほげ");

みたいな形でメソッドを呼び出せば、指定した出力先にテキストが表示されるという寸法だ。ね、簡単でしょう？（反語表現）

●次回の予告

次回はこのRichRepoterライブラリを、ソースコードのままリンクして利用する方法と、DLL化して利用する方法について説明する。

2015年11月28日土曜日

P005-文字を色付きで表示

今日の目標→

文字に色を付けたり、行をスクロールさせるなど、RichTextBoxを使ったテキスト表示のテクニックを探る。

●プロジェクトの作成

「TextWork2」という名前で、新規プロジェクトを作る
Form1.csのコードを開き、前回（TextWork）のForm1.csのコードをコピペする
コードを次のように修正する。

using System;
using System.Drawing;
using System.Windows.Forms;

namespace TextWork2
{
    public partial class Form1 : Form
    {
        // コントロール
        private RichTextBox MyTextBox;
        private Button MyStartButton;
        private Button MyEndButton;
        private Timer MyTimer;
        private int MyCounter;

// フォームのコンストラクタ
        public Form1()
        {
            InitializeComponent();

// タイトルバーにプログラム名を表示する
            this.Text = Application.ProductName;

// テキストボックスを作る
            MyTextBox = new RichTextBox();
            MyTextBox.Name = "MyTextBox";
            MyTextBox.Anchor = AnchorStyles.Left | AnchorStyles.Right |
                                AnchorStyles.Top | AnchorStyles.Bottom;
            MyTextBox.Left = 4;
            MyTextBox.Top = 4;
            MyTextBox.Width = this.ClientSize.Width - 8;
            MyTextBox.Height = this.ClientSize.Height - 36;
            MyTextBox.Font = new Font("ＭＳ ゴシック", 12, FontStyle.Bold);

// 停止ボタンを作る
            MyEndButton = new Button();
            MyEndButton.Name = "MyEndButton";
            MyEndButton.Anchor = AnchorStyles.Left | AnchorStyles.Bottom;
            MyEndButton.Left = MyStartButton.Right + 4;
            MyEndButton.Top = MyStartButton.Top;
            MyEndButton.Width = 100;
            MyEndButton.Height = 24;
            MyEndButton.Text = "停止(&E)";
            MyEndButton.Click += MyEndButton_Click;

// コントロールをフォームに配置する
            this.SuspendLayout();
            this.Controls.Add(MyTextBox);
            this.Controls.Add(MyStartButton);
            this.Controls.Add(MyEndButton);
            this.ResumeLayout();

// タイマーを作る
            MyTimer = new Timer();
            MyTimer.Tick += MyTimer_Tick;
        }

// 「開始(S)」ボタンのクリック
        private void MyStartButton_Click(object sender, EventArgs e)
        {
            if (!MyTimer.Enabled)
            {
                // 開始メッセージ表示
                ColorPrint(Color.Red, "タイマー処理を");
                ColorPrint(Color.Blue, "開始します。\n");

// カウンタをゼロリセット
                MyCounter = 0;

// 周期250ミリ秒（0.25秒）でタイマー処理を開始
                MyTimer.Interval = 250;
                MyTimer.Start();
            }
        }

// 「停止(E)」ボタンのクリック
        private void MyEndButton_Click(object sender, EventArgs e)
        {
            if (MyTimer.Enabled)
            {
                // タイマー処理を停止
                MyTimer.Stop();

// 停止メッセージ表示
                ColorPrint(Color.Blue, "タイマー処理を");
                ColorPrint(Color.Red, "停止しました。\n");
            }
        }

// タイマー周期ごとの処理
        private void MyTimer_Tick(object sender, EventArgs e)
        {
            // カウンター値と現在時刻を表示する
            string text = string.Format("{0}: {1}\n", ++MyCounter, DateTime.Now);
            Print(text);
        }

// 色なしのテキスト表示
        private void Print(string text)
        {
            // デフォルトの文字色で表示する
            ColorPrint(MyTextBox.ForeColor, text);
        }

// 色付きのテキスト表示
        private void ColorPrint(Color textColor, string text)
        {
            // テキストを末尾に追加する
            AddText(textColor, text);

// 20行を超えたら先頭行から削除する
            CheckLines(20);

// もし必要なら末尾までスクロールする
            ScrollToEnd();
        }

// 文字の色を指定する
            if (MyTextBox.SelectionColor != textColor)
            {
                MyTextBox.SelectionColor = textColor;
            }

// テキストを追加する
            MyTextBox.AppendText(text);
        }

if (nLines > maxLines)
            {
                // 余分な行数を得る
                int delLines = nLines - maxLines;

// 余分な文字数を得る
                int delChars = MyTextBox.GetFirstCharIndexFromLine(delLines);

// 余分な文字を先頭から削除する
                MyTextBox.Select(0, delChars);
                MyTextBox.SelectedText = "";
            }
        }

// 選択位置までスクロールする
            MyTextBox.ScrollToCaret();
        }

}
}

これも「開始(S)」ボタンで表示が始まり、「停止(E)」ボタンで止まる。見どころは次の3つ。

開始と停止メッセージに色がついている
文字表示が最下部に達するとスクロールする
行数が20行を超えると先頭行から順に消えていく

（実行画面が入る予定）

●文字に色

RichTextBoxで、文字に色を付ける方法は2つある。

(A) すでに表示されている文字の色を変えるには

Select()メソッドで、色を変えたい文字範囲を選択
SelectionColorプロパティで、その範囲の色を設定

(B) これから表示する文字の色を変えるには

Select()メソッドで、テキスト末尾の「長さ0の範囲」を選択
SelectionColorプロパティで、文字色を設定
この状態でAppendText()メソッドを実行すると文字に色がつく

今回はAddText()の定義の中で(B)の方法を使っているので見てみてね。

●余分な行を削除

行の削除にはコツがある。というのも、RichTextBoxの操作は基本的にキャラクタ単位で行うため、行単位の操作は面倒なのだ。そこで次の2つのメソッドの出番となる。

GetLineFromCharIndex() -- 文字の位置から行番号を得る
GetFirstCharIndexFromLine() -- 行番号からその行の先頭の文字位置を返す

今回はCheckLines()の定義の中でこれらを使っている。

●最下行までスクロール

RichTextBoxにはScrollToCaret()メソッドというものがあって、キャレットが見える位置までウィンドウをスクロールできる。キャレットというのは、文字入力の位置でチカチカ点滅している線のことだ。文字カーソルともいう。

キャレットを移動するには、Select()メソッドで、任意の文字位置に「長さ0の範囲」を指定すればよい。

今回はScrollToEnd()の定義の中でこの方法を使っている。

以上、とても駆け足の説明でした。まあ、詳しいことはコードを読んでください。

●今日から投稿は丑三つ時に

今後の投稿ペースですが、できれば毎日1記事を目指します。もちろん全部プログラムネタは無理っぽいので、ただの独り言の場合もあります。

投稿時刻はブログの設定で毎回午前2:00に統一しようと思います。あまりバラバラな投稿時刻だと、どんな生活リズムだと思われそうで恥ずかしいから…。

2015年11月27日金曜日

P004-テキスト表示プログラム

今日の目標→

ここまで画像表示ばっかり続いたので、テキスト表示にも挑戦する。

●プロジェクトの作成

「TextWork」という名前で、新規プロジェクトを作る
Form1.csのコードを開き、次のプログラムを入力する

using System;
using System.Drawing;
using System.Windows.Forms;

namespace TextWork
{
    public partial class Form1 : Form
    {
        // コントロール
        private RichTextBox MyTextBox;
        private Button MyStartButton;
        private Button MyEndButton;
        private Timer MyTimer;

// フォームのコンストラクタ
        public Form1()
        {
            InitializeComponent();

// 終了ボタンを作る
            MyEndButton = new Button();
            MyEndButton.Name = "MyEndButton";
            MyEndButton.Anchor = AnchorStyles.Left | AnchorStyles.Bottom;
            MyEndButton.Left = MyStartButton.Right + 4;
            MyEndButton.Top = MyStartButton.Top;
            MyEndButton.Width = 100;
            MyEndButton.Height = 24;
            MyEndButton.Text = "終了(&E)";
            MyEndButton.Click += MyEndButton_Click;

// タイマーを作る
            MyTimer = new Timer();
            MyTimer.Tick += MyTimer_Tick;
        }

// 「開始(S)」ボタンのクリック
        private void MyStartButton_Click(object sender, EventArgs e)
        {
            if (!MyTimer.Enabled)
            {
                // 開始メッセージ表示
                MyTextBox.AppendText("タイマー処理を開始\n");

// 周期1000ミリ秒（1秒）でタイマー処理を開始
                MyTimer.Interval = 1000;
                MyTimer.Start();
            }
        }

// 「終了(E)」ボタンのクリック
        private void MyEndButton_Click(object sender, EventArgs e)
        {
            if (MyTimer.Enabled)
            {
                // タイマー処理を終了
                MyTimer.Stop();

// 終了メッセージ表示
                MyTextBox.AppendText("タイマー処理を終了\n");
            }
        }

// タイマー周期ごとの処理
        private void MyTimer_Tick(object sender, EventArgs e)
        {
            string line = string.Format("現在時刻は {0}\n", DateTime.Now);
            MyTextBox.AppendText(line);
        }
    }
}

プログラムを実行し、「開始(S)」ボタンを押すと、現在時刻を1秒ごとに繰り返して表示する。「終了(E)」ボタンを押すと停止する。

●要点の解説

文字出力には各種の方法がある。たとえばConsole.Write()によるコンソール出力とか、Labelコントロールにテキストを表示するとか。しかしいろいろ試した結果、いちばん便利だと思ったのは、テキストボックスを１個配置して、そこにテキスト出力を垂れ流していく方法だ。

このときただのTextBoxクラスではなくRichTextBoxクラスを使えば、文字に色をつけたりできて面白い。次の記事からしばらくは、RichTextBoxを利用したテキスト出力や文字列処理についてみていきたい。

あと今回使ったタイマー（Windows.Forms.Timerクラス）についても、いつか説明したいところ。

（実行画面が入る予定）

2015年11月25日水曜日

P003-クリップボードから画像をペースト

今日の目標→

前回のプログラム（ImageView2）に手を加え、クリップボードから画像を貼り付けられるようにする。

●プロジェクトの作成

「ImageView3」という名前で、新規プロジェクトを作る
Form1.csのコードを開き、ImageView2のForm1.csからコードをコピペする
コードを次のように修正する。

using System;
using System.Drawing;
using System.Windows.Forms;
using System.Xml;

namespace ImageView3
{
    public partial class Form1 : Form
    {
        // ピクチャボックスとボタンを用意する
        private PictureBox MyPictBox;
        private Button MyOpenButton;

// フォームのコンストラクタ
        public Form1()
        {
            InitializeComponent();

// ピクチャボックスを作る
            MyPictBox = new PictureBox();
            MyPictBox.Name = "MyPictBox";
            MyPictBox.Anchor = AnchorStyles.Left | AnchorStyles.Right |
                                AnchorStyles.Top | AnchorStyles.Bottom;
            MyPictBox.Left = 4;
            MyPictBox.Top = 4;
            MyPictBox.Width = this.ClientSize.Width - 8;
            MyPictBox.Height = this.ClientSize.Height - 38;
            MyPictBox.BorderStyle = BorderStyle.FixedSingle;

// ボタンを作る
            MyOpenButton = new Button();
            MyOpenButton.Name = "MyOpenButton";
            MyOpenButton.Anchor = AnchorStyles.Left | AnchorStyles.Bottom;
            MyOpenButton.Left = 4;
            MyOpenButton.Top = this.ClientSize.Height - 28;
            MyOpenButton.Width = 100;
            MyOpenButton.Height = 24;
            MyOpenButton.Text = "ファイル参照(&R)";
            MyOpenButton.Click += MyOpenButton_Click;

// ピクチャボックスとボタンをフォームに置く
            this.SuspendLayout();
            this.Controls.Add(MyPictBox);
            this.Controls.Add(MyOpenButton);
            this.ResumeLayout();

// フォームへのドラッグ＆ドロップができるようにする
            this.DragEnter += Form1_DragEnter;
            this.DragDrop += Form1_DragDrop;
            this.AllowDrop = true;

// タイトルバーにプログラム名を表示する
            this.Text = Application.ProductName;

// クラシックメニューを追加する
            this.Menu = CreateMenu();
        }

// フォームへのドラッグ開始
        private void Form1_DragEnter(object sender, DragEventArgs e)
        {
            // ドラッグアイコンを適切に設定する
            e.Effect = e.AllowedEffect;
        }

// フォームへのドロップ
        private void Form1_DragDrop(object sender, DragEventArgs e)
        {
            // ドロップされたファイル名の配列を得る
            var fileNames = (string[])e.Data.GetData(DataFormats.FileDrop);

// 配列先頭にあるファイルの画像を表示する
            if (fileNames != null)
            {
                ShowImage(fileNames[0]);
            }
        }

// ボタンクリック
        private void MyOpenButton_Click(object sender, EventArgs e)
        {
            // 「ファイルを開く」ダイアログボックスを準備する
            var dlg = new OpenFileDialog();

// ダイアログボックスでファイルを選択し、画像を表示する
            if (dlg.ShowDialog(this) == DialogResult.OK)
            {
                ShowImage(dlg.FileName);
            }
        }

// 画像表示の共通ルーチン
        private void ShowImage(string fileName)
        {
            try
            {
                MyPictBox.Image = Image.FromFile(fileName);
            }
            catch
            {
                MessageBox.Show(
                    "ファイル名:\n" + fileName,
                    "画像が読めません");
            }
        }

// メニューを作る
        private MainMenu CreateMenu()
        {
            // メニュー構造をXMLで記述する
            string xmlText =
                "<root>                                " +
                "    <file text='ファイル(&F)'>        " +
                "        <exit text='終了(&X)' />      " +
                "    </file>                           " +
                "    <edit text='編集(&E)'>            " +
                "        <cut text='切り取り(&T)' />   " +
                "        <copy text='コピー(&C)' />    " +
                "        <paste text='ペースト(&P)' /> " +
                "    </edit>                           " +
                "</root>                               ";

// XMLの中では「&」を「&amp;」と書く決まりなので置換
            xmlText = xmlText.Replace("&", "&amp;");

// XMLテキストからXmlDocumentを作る
            XmlDocument xml = new XmlDocument();
            xml.LoadXml(xmlText);

// XmlDocumentの階層構造を見てメニューを構築する
            XmlElement rootXml = xml.DocumentElement;
            MainMenu rootMenu = new MainMenu();

foreach (XmlElement topXml in rootXml.ChildNodes)
            {
                MenuItem topMenu = new MenuItem();
                topMenu.Name = topXml.Name;
                topMenu.Text = topXml.GetAttribute("text");
                topMenu.Popup += TopMenu_Popup;

foreach (XmlElement subXml in topXml.ChildNodes)
                {
                    MenuItem subMenu = new MenuItem();
                    subMenu.Name = subXml.Name;
                    subMenu.Text = subXml.GetAttribute("text");
                    subMenu.Click += SubMenu_Click;
                    topMenu.MenuItems.Add(subMenu);
                }

rootMenu.MenuItems.Add(topMenu);
            }

// 完成したメニューを返す
            return rootMenu;
        }

// 汎用のメニューPopupハンドラ
        private void TopMenu_Popup(object sender, EventArgs e)
        {
            // ポップアップしたメニューを得る
            Menu menu = (Menu)sender;

// メニューのNameで処理を振り分ける
            switch (menu.Name)
            {
                case "edit":
                    // 「編集(E)」メニューのポップアップ処理
                    bool canCopy = (MyPictBox.Image != null);
                    bool canPaste = (Clipboard.GetImage() != null);
                    menu.MenuItems["cut"].Enabled = canCopy;
                    menu.MenuItems["copy"].Enabled = canCopy;
                    menu.MenuItems["paste"].Enabled = canPaste;
                    break;
            }

}

// 汎用のメニューClickハンドラ
        private void SubMenu_Click(object sender, EventArgs e)
        {
            // クリックされたメニューを得る
            Menu menu = (Menu)sender;

// メニューのNameで処理を振り分ける
            switch (menu.Name)
            {
                case "exit":
                    // 「ファイル(F)」→「終了(X)」メニュー
                    Application.Exit();
                    break;

case "cut":
                    // 「編集(E)」→「切り取る(T)」メニュー
                    Clipboard.SetImage(MyPictBox.Image);
                    MyPictBox.Image = null;
                    break;

case "copy":
                    // 「編集(E)」→「コピー(C)」メニュー
                    Clipboard.SetImage(MyPictBox.Image);
                    break;

case "paste":
                    // 「編集(E)」→「貼り付け(P)」メニュー
                    MyPictBox.Image = Clipboard.GetImage();
                    break;
            }
        }

}
}

コードを書き終えたらさっそく実行してみよう。他のソフト上で画像の「コピー」を実行し、このプログラムの「貼り付け」メニューを選択すると、ピクチャボックスに画像が表示されるはずだ。

●要点の解説

クリップボードとの画像データのやりとりは単純だ。次の2つのメソッドを使えばいい。

Clipboard.SetImage() → クリップボードに画像を保存する
Clipboard.GetImage() → クリップボードから画像を取得する

まあ実際は、このお手軽なメソッドにも弱点があって、透過GIFや透過PNGをクリップボード経由でやりとりすると透明色が消えてしまったりする。この問題は、昔なんかして解決した記憶があるので、あとで思い出したら解決法を書いてみる。

しかし今回の追加コードのほとんどがメニュー関連の処理になってしまった。ここでは標準のMenuStripクラスじゃなくて、古くからあるMainMenuクラスを使っている。古いプログラムから取ってきたコードだけど問題なく動いてよかった。

またメニューの設定データにXMLを利用している。こういうメニューみたいな階層構造のデータは、XMLで記述するのが楽である。XMLの使い方はそのうちちゃんと説明するので、しばらくお待ちくだされ。

（実行画面が入る予定）

2015年11月24日火曜日

P002-ファイルをドラッグ＆ドロップで開く

今日の目標→

前回のプログラム（ImageView）に手を加え、ドラッグ＆ドロップで画像ファイルを開けるようにする。

●プロジェクトの作成

「ImageView2」という名前で、新規プロジェクトを作る
Form1.csのコードを開き、前回のForm1.csのコードをコピペする
コードを次のように修正する。

using System;
using System.Drawing;
using System.Windows.Forms;

namespace ImageView2
{
    public partial class Form1 : Form
    {
        // ピクチャボックスとボタンを用意する
        private PictureBox MyPictBox;
        private Button MyOpenButton;

// フォームのコンストラクタ
        public Form1()
        {
            InitializeComponent();

// フォームへのドラッグ＆ドロップができるようにする
            this.DragEnter += Form1_DragEnter;
            this.DragDrop += Form1_DragDrop;
            this.AllowDrop = true;
        }

// フォームへのドラッグ開始
        private void Form1_DragEnter(object sender, DragEventArgs e)
        {
            // ドラッグアイコンを適切に設定する
            // （これをしないとドロップが許可されない）
            e.Effect = e.AllowedEffect;
        }

// 配列先頭にあるファイルの画像を表示する
            if (fileNames != null)
            {
                ShowImage(fileNames[0]);
            }
        }

しかしこれ<textarea>タグでコードを表示してるんだけど読みにくいな。別の表示法にしたほうがいいかな。まあ、おいおい考えよう。

●要点の解説

フォームに対してドラッグ＆ドロップを行うには、少なくとも次の３つが必要だ。

DragEnterイベントの処理ルーチンを追加する
DragDropイベントの処理ルーチンを追加する
AllowDropフラグをtrueに設定する

イベント処理ルーチンの入力はVisual Studioが助けてくれるので楽ちんである。たとえばDragEnter処理を書く場合は次のようになる。

まず「this.DragEnter +=」まで手で入力する
TABキーを押すと、自動的にイベントハンドラの枠組みのコードが挿入される
Enterキーを押すと確定する。Enterキーを押す前にハンドラ名の変更もできるが、まあ必要ないと思う
イベントハンドラの枠組みができたら、あとは中身を自分でコーディングする

DragEnterハンドラとDragDropハンドラの中身は、定型の処理なので説明は省略する。わからない部分があればコメント欄ででも質問してください。できる範囲で答えます。

コードを書き終えたらさっそく実行してみよう。Windowsのフォルダから適当な画像ファイルをドラッグして、このプログラムのフォームにドロップすれば、画像が表示されるはずだ。

（実行画面が入る予定）

P001-画像表示プログラム

最近ではC#もいろいろ進化してるようだけど、まあその辺はいずれ学ぶとして、とりあえず昔の知識でできるところから始めよう。「画像をピクチャボックスに表示するプログラム」なんか簡単でいいかな。

●プロジェクトの作成

メインメニューから［ファイル］→［新しいプロジェクト］を選ぶく
開いたウィンドウで、左上のツリーから［Visual C#］を選ぶ
右のテンプレート一覧から［Windowsフォームアプリケーション］を選ぶ
下の名前欄にプログラムの名前を入力（ここではImageViewとした）
［OK］ボタンを押すと、プロジェクトが新規作成される

ここでツールバーの［開始］ボタンをクリックすると、プログラムがコンパイルされ、起動し、何もないウィンドウが表示された。よしよし昔と変わってないね。

（画像が入る予定）

●コードの入力

さてそれじゃコードを書いていくよ。ソリューションエクスプローラで、

Form1.csの名前を右クリック→［コードの表示］を選択

すると、コードウィンドウが開くから、次のようにコード入力する。

using System;
using System.Drawing;
using System.Windows.Forms;

namespace ImageView
{
    public partial class Form1 : Form
    {
        // ピクチャボックスとボタンを用意する
        private PictureBox MyPictBox;
        private Button MyOpenButton;

// フォームのコンストラクタ
        public Form1()
        {
            InitializeComponent();

// ピクチャボックスとボタンをフォームに置く
            this.SuspendLayout();
            this.Controls.Add(MyPictBox);
            this.Controls.Add(MyOpenButton);
            this.ResumeLayout();
        }

// ボタンクリックのイベントハンドラ
        private void MyOpenButton_Click(object sender, EventArgs e)
        {
            var dlg = new OpenFileDialog();

if (dlg.ShowDialog(this) == DialogResult.OK)
            {
                try
                {
                    MyPictBox.Image = Image.FromFile(dlg.FileName);
                }
                catch
                {
                    MessageBox.Show(
                        "ファイル名:\n" + dlg.FileName,
                        "画像が読めません");
                }
            }
        }
    }
}

ボタン等の配置は、Visual Studioのデザイナー上でマウスで置くこともできるが、個人的には上記のようにぜんぶコードで書くほうが好きだ。そのほうが早いし。

コード入力が終わったら、ツールバーの［開始］ボタンを押すとプログラムが起動する。［ファイル参照］ボタンで適当な画像ファイルが読み込めることを確認すべし。

（画像が入る予定）

登録: 投稿 (Atom)