日本語エンコーディングはややこしい

今日の目標→

日本語のEncodingについてあらためて調べているところである。とりあえず途中経過の報告を。

●各種エンコードのHTMLをブラウザで表示するテスト

まずは基本的なところで、いろいろなエンコードのHTMLファイルをWebブラウザで表示してみた。ファイルは公開スペースに置いたので、よかったらご自由にアクセスしてください。

こちら→ http://pilikala.net/yuima/encoding/

この9種類のHTMLファイルを、FireFoxとIEで表示した結果が次である。

No.	ファイル名	エンコード	charset	備考	FF	IE
1.	file_Shift_JIS.html	CP932	Shift_JIS	-	○	○
2.	file_EUC-JP.html	CP51932	EUC-JP	-	○	○
3.	file_ISO-2022-JP.html	CP50221	ISO-2022-JP	-	○	○
4.	file_UTF-8.html	UTF-8	UTF-8	-	○	○
5.	file_UTF-8_BOM.html	UTF-8	UTF-8	BOMを付加	○	○
6.	file_UTF-16LE.html	UTF-16LE	UTF-16LE	-	○	○
7.	file_UTF-16LE_BOM.html	UTF-16LE	UTF-16	BOMを付加	○	○
8.	file_UTF-16BE.html	UTF-16BE	UTF-16BE	-	○	○
9.	file_UTF-16BE_BOM.html	UTF-16BE	UTF-16	BOMを付加	○	×

なぜかIEがひとつ表示に失敗している。HTTPヘッダでcharsetも送信しているはずなのにおかしいな。

てな感じで調査継続中、続きは、この記事に追加していきます。

P013-URLをドラッグ＆ドロップ

今日の目標→

UnicodeのBOMについて探求する前にちょっと脇道へ。 いちいちURLを入力するのが面倒になってきたので、 今回はWebブラウザからURLをドラッグ＆ドロップできるようにプログラムを改造してみる。

●Webブラウザからのドラッグデータを受け取るには

最近のWebブラウザは、 画面上のリンクや画像などをドラッグ＆ドロップで持ち出せるので非常に便利である。 問題は、Webブラウザのドラッグ＆ドロップには標準的な手法が決まっておらず、 各陣営が好き勝手にやっているという点だ。

試しにフォームのDragDropイベントに次のようなコードを書いて実行してみるといい。

private void Form1_DragDrop(object sender, DragEventArgs e) { this.Activate(); MessageBox.Show( string.Join("\n", e.Data.GetFormats()), "取得できるデータ形式"); }

ブラウザ画面から上記のフォームにリンクか何かをドラッグ＆ドロップすると、 いろいろな形式のデータが取得可能なことがわかる。 ただし種類はFireFoxとChromeとMS Edgeでバラバラだ。 唯一共通しているのは、

UniformResourceLocator

という形式のドロップデータである。 これは字面からわかる通りURLを表している。 この形式のドロップデータからURLを文字列として取り出すには次のように書く。

private void Form1_DragDrop(object sender, DragEventArgs e) { if (e.Data.GetDataPresent("UniformResourceLocator")) { string URL = (string)e.Data.GetData(DataFormats.Text); // なにかURLを使った処理 } }

URL以外のデータにも便利なものがありそうで、 たとえばブラウザから画像をドラッグ＆ドロップした場合、 ローカルPCのキャッシュデータなんかもとれるみたいだが、 ブラウザごとに挙動が変わるのが困るなあ。 まあURLさえわかってれば、もっかいデータを読みにいけばいいんだし…。

●プロジェクトの作成

というわけで、前々回（P011～）で作成したNetJob2を改造する。

1. プロジェクト作成ウィンドウを開く
2. 「Windowsフォームアプリケーション」テンプレート、名前は「NetJob3」でプロジェクトを作る
3. Form1.csを開き、NetJob2のFomr1.csをコピペし、次のように改造する

// プロジェクト：NetJob3 // ファイル名：Form1.cs using System; using System.Drawing; using System.IO; using System.Net; using System.Text; using System.Windows.Forms; using MarugeProject; namespace NetJob3 { public partial class Form1 : Form { // コントロールなど private SplitContainer MySplitBox; private RichTextBox MyReportBox; private RichTextBox MyWebTextBox; private TextBox MyInputBox; private Button MyGetButton; private RichReporter MyReporter; // フォームのコンストラクタ public Form1() { InitializeComponent(); // タイトルバーにプログラム名を表示する this.Text = Application.ProductName; // ウィンドウサイズを400x400にする this.Width = 400; this.Height = 400; // 上下分割コンテナを作る MySplitBox = new SplitContainer(); MySplitBox.Name = "MySplitBox"; MySplitBox.Anchor = AnchorStyles.Left | AnchorStyles.Right | AnchorStyles.Top | AnchorStyles.Bottom; MySplitBox.Left = 8; MySplitBox.Top = 8; MySplitBox.Width = this.ClientSize.Width - 16; MySplitBox.Height = this.ClientSize.Height - 40; MySplitBox.BorderStyle = BorderStyle.FixedSingle; MySplitBox.Orientation = Orientation.Horizontal; MySplitBox.SplitterDistance = 200; // 分割コンテナの上側にネットデータ表示用のRichTextBoxを配置する MyWebTextBox = new RichTextBox(); MyWebTextBox.Name = "MyWebTextBox"; MyWebTextBox.BorderStyle = BorderStyle.None; MyWebTextBox.Dock = DockStyle.Fill; MyWebTextBox.DetectUrls = false; MySplitBox.Panel1.Controls.Add(MyWebTextBox); // 分割コンテナの下側にレポート出力用のRichTextBoxを配置する MyReportBox = new RichTextBox(); MyReportBox.Name = "MyReportBox"; MyReportBox.BorderStyle = BorderStyle.None; MyReportBox.Dock = DockStyle.Fill; MySplitBox.Panel2.Controls.Add(MyReportBox); // 「テキストを読み込む」ボタンを作る MyGetButton = new Button(); MyGetButton.Name = "MyGetButton"; MyGetButton.Anchor = AnchorStyles.Right | AnchorStyles.Bottom; MyGetButton.Left = this.ClientSize.Width - 128; MyGetButton.Top = this.ClientSize.Height - 30; MyGetButton.Width = 120; MyGetButton.Text = "テキストを読み込む(&R)"; MyGetButton.Click += MyGetButton_Click; // テキスト入力ボックスを作る MyInputBox = new TextBox(); MyInputBox.Name = "MyInputBox"; MyInputBox.Anchor = AnchorStyles.Left | AnchorStyles.Right | AnchorStyles.Bottom; MyInputBox.Left = 8; MyInputBox.Top = MyGetButton.Top + 2; MyInputBox.Width = this.ClientSize.Width - MyGetButton.Width - 18; MyInputBox.Text = "http://"; // 各コントロールをフォームに配置する this.SuspendLayout(); this.Controls.Add(MySplitBox); this.Controls.Add(MyGetButton); this.Controls.Add(MyInputBox); this.ResumeLayout(); // テキスト出力の準備 MyReportBox.DetectUrls = false; MyReportBox.Font = new Font("MS UI Gothic", 12); MyReporter = new RichReporter(MyReportBox); // 初期メッセージを出力 MyReporter.Print("使用方法：\n"); MyReporter.Print("URLを入力 → 「テキストを読み込む」をクリック\n"); MyReporter.Print("または、WebブラウザからURLをドラッグ＆ドロップ\n"); // フォームへのドラッグ＆ドロップの準備 this.AllowDrop = true; this.DragEnter += Form1_DragEnter; this.DragDrop += Form1_DragDrop; // リッチテキストボックスへのドラッグ＆ドロップを禁止 MyWebTextBox.ReadOnly = true; MyWebTextBox.AllowDrop = false; MyWebTextBox.EnableAutoDragDrop = false; } // 「テキストを読み込む」ボタンをクリック private void MyGetButton_Click(object sender, EventArgs e) { MyReportBox.Clear(); MyReporter.Print("接続します\n"); byte[] data = ReadNetData(MyInputBox.Text); if (data != null) { Encoding enc = EncodingChecker.GetEncoding(data); MyReporter.Print("成功しました\n"); MyReporter.Print("文字コードは " + enc.EncodingName + " です\n"); MyWebTextBox.Text = enc.GetString(data); } else { MyReporter.ColorPrint(Color.Red, "失敗しました\n"); } } // ネットからバイナリテキストを読み込む private byte[] ReadNetData(string URL) { try { // ネットからデータを読み込み、byte配列として返す WebClient client = new WebClient(); return client.DownloadData(URL.Trim()); } catch { // 読み込み失敗ならnullを返す return null; } } // フォームへのドラッグ開始 private void Form1_DragEnter(object sender, DragEventArgs e) { e.Effect = e.AllowedEffect; } // フォームへのドロップ private void Form1_DragDrop(object sender, DragEventArgs e) { if (e.Data.GetDataPresent("UniformResourceLocator")) { string URL = (string)e.Data.GetData(DataFormats.Text); // URLを入力して「テキストを読み込む」ボタンを押したことにする MyInputBox.Text = URL; MyGetButton_Click(MyGetButton, EventArgs.Empty); } } } }

プログラムを実行し、ブラウザからURLをドラッグ＆ドロップできることを確認する。やっぱドラッグ＆ドロップは便利だなあ。

P012-BOMの処理はどうするか

今日の目標→

前回のプログラムで、Unicodeのファイルを読み込むと、ときどき先頭に妙な空白が表示されるのに気がついた。これはBOMだ。何とかしないと。

●BOM（バイトオーダーマーク）について

Unicodeテキストは、その保存形式を見分けやすくするため、最初にUnicode文字の「\uFEFF」を付けることがある。これがBOM（バイトオーダーマーク）である。文字の値としては「\uFEFF」ひとつだが、ファイルへの保存形式によって次の違いが出る。

• UTF-16BE
  -- 16ビットをビッグエンディアンで保存するため、BOMは(fe, ff)となる。
• UTF-16
  -- リトルエンディアンで保存するため、BOMは(ff, fe)の順になる。
• UTF-8
  -- 可変長データに変換するため、BOMは(ef, bb, bf)の3バイトになる。

UTF-16BEとUTF-16は、データ内容からどちらなのか判別するのが原理的に難しいため、BOMの付加が強く推奨されている。いっぽうUTF-8の場合はBOMがなくても判定は容易だし、プログラムによっては未対応だし、あまりBOMを付けるメリットはない。

●いろいろな形式のUnicodeファイルを作る

実際に各種の形式のUnicodeファイルに触れてみるとわかりやすい。せっかくだからC#でいろいろなファイルを作ってみよう。コードは下記。今回はコンソールアプリケーションにしてみた。

1. 「ファイル(F)」→「新しいプロジェクト(P)」で、プロジェクト作成ウィンドウを開く
2. カテゴリ「Visual C#」で、テンプレート「コンソールアプリケーション」を選ぶ
3. 名前を「EncodeFiles」と入力してプロジェクトを作成する
4. Program.csを開き、次のコードを入力する

// プロジェクト：EncodeFiles // ファイル名：Program.cs using System; using System.IO; using System.Text; namespace EncodeFiles { class Program { // メイン処理 static void Main(string[] args) { // index.htmlの途中まで string indexHTML = @"<!DOCTYPE html> <html> <head> <meta charset=""shift_jis"" /> <title>各種エンコードのテスト</title> </head> <body> <h1>各種エンコードのテスト</h1> <ol> "; // file_XXXX.htmlのテンプレート string templateHTML = @"<!DOCTYPE html> <html> <head> <meta charset=""$WEB_NAME"" /> <title>$ENC_NAME のテスト</title> </head> <body> <h1>$ENC_NAME のテスト</h1> <p>このファイルのcharsetは $WEB_NAME です。</p> <p>半角カナの例： ｱｲｳｴｵｶﾞｷﾞｸﾞｹﾞｺﾞ</p> <p>拡張文字の例： 﨑（たつさき）、髙（はしごたか）</p> </html> "; // 作業用フォルダをデスクトップに作る string workFolder = Environment.GetFolderPath( Environment.SpecialFolder.Desktop) + "\\WorkFolder\\"; Directory.CreateDirectory(workFolder); // エンコードの一覧 Encoding[] encList = { Encoding.GetEncoding(932), // Shift_JIS + IBM拡張文字 Encoding.GetEncoding(51932), // EUC-JP + IBM拡張文字 Encoding.GetEncoding(50221), // JIS + 半角カナ + IBM拡張文字 Encoding.UTF8, // UTF-8 Encoding.Unicode, // UTF-16LE Encoding.BigEndianUnicode, // UTF-16BE }; for (int i = 0; i < 6; ++i) { // エンコードを得る Encoding enc = encList[i]; // エンコードに対応するファイル名とHTMLデータを作る string fileName = string.Format("file_{0}.html", enc.WebName); string fileHTML = templateHTML .Replace("$WEB_NAME", enc.WebName) .Replace("$ENC_NAME", enc.EncodingName); // HTMLデータを適切なエンコードで保存する File.WriteAllBytes(workFolder + "\\" + fileName, enc.GetBytes(fileHTML)); Console.WriteLine("{0}を作成しました。", fileName); indexHTML += string.Format("<li><a href=\"{0}\">{0}</a></li>\r\n", fileName); // UTF-8とUTF-16系は、BOM付きのデータも書き込む if (i >= 3) { const string BOM = "\ufeff"; // データの先頭にBOMを追加する fileHTML = fileHTML.Replace("</html>", "<p style='color:red;'>このファイルはBOM付きです！</p>\r\n</html>"); fileHTML = BOM + fileHTML; fileName = fileName.Replace(".html", "_BOM.html"); // HTMLデータを適切なエンコードで保存する File.WriteAllBytes(workFolder + "\\" + fileName, enc.GetBytes(fileHTML)); Console.WriteLine("{0}を作成しました。", fileName); indexHTML += string.Format("<li><a href=\"{0}\">{0}</a></li>\r\n", fileName); } } indexHTML += "</ol>\r\n</body>\r\n</html>\r\n"; // index.htmlを作る File.WriteAllText(workFolder + "\\index.html", indexHTML, Encoding.GetEncoding(932)); Console.WriteLine("index.htmlを作成しました。"); // コンソールウィンドウがすぐ消えるのを防ぐためキー入力待ち Console.WriteLine("Enterキーを押してください"); Console.ReadLine(); } } }

実行すると、PCのデスクトップに「WorkFolder」というフォルダができ、さらにその中にいろいろなエンコードのHTMLファイルが作られる。

●次回の予告

BOMの処理の続き。

P011-ネットのテキストを読み込む

今日の目標→

ネットから画像が読み込めたら、次はテキストの読み込みだろう。

●MyLibの拡張

ネット上の日本語テキストって、ほぼUTF-8に統一されたのかな？ でもやっぱり、今でも文字コードの判別は避けて通れないだろうなあ。 昔作った文字コード判定クラスがあるので、これを流用しよう。

というわけで、次のクラスをMyLibライブラリに追加する。

// プロジェクト：MyLib // ファイル名：EncodingChecker.cs using System; using System.Text; namespace MarugeProject { /// <summary> /// 日本語の文字コードを検査するクラス /// </summary> public class EncodingChecker { // 検査データの一時保管場所 private byte[] MyBuf; // 可能性の高い順に並べた文字エンコード private Encoding[] MyEncodings; /// <summary> /// コンストラクタ：検査対象のバイナリデータを引数として渡す /// </summary> public EncodingChecker(byte[] bytes) { // 検査対象のコピーを作っておく MyBuf = new byte[bytes.Length]; Array.Copy(bytes, MyBuf, bytes.Length); // 順位は未定 MyEncodings = null; } /// <summary> /// 文字エンコードを可能性の高い順に配列で返す /// </summary> public Encoding[] GetEncodings() { if (MyEncodings == null) { MyEncodings = CreateRanking(); } return MyEncodings; } /// <summary> /// 最も可能性の高い文字エンコードを返す /// </summary> public Encoding GetEncoding() { return (GetEncodings())[0]; } /// <summary> /// 文字エンコードを可能性の高い順に配列で返すstaticメソッド /// </summary> public static Encoding[] GetEncodings(byte[] bytes) { EncodingChecker checker = new EncodingChecker(bytes); return checker.GetEncodings(); } /// <summary> /// 最も可能性の高い文字エンコードを返すstaticメソッド /// </summary> public static Encoding GetEncoding(byte[] bytes) { EncodingChecker checker = new EncodingChecker(bytes); return checker.GetEncoding(); } //==================================================================== // 以下、非公開メソッド // バイナリデータの文字エンコードを調べ、可能性の高い順に配列に入れる private Encoding[] CreateRanking() { // 文字列終端までの長さを得る（+1はゼロ除算を避けるため） int valid8 = CountValid8() + 1; // 1バイト終端(0)までの長さ int valid16 = CountValid16() + 1; // 2バイト終端(0,0)までの長さ // 文字エンコードごとの得点を計算 double[] scoreList = { (double)ScoreUTF16BE() / valid16, // UTF-16BE (double)ScoreUTF16LE() / valid16, // UTF-16LE (double)ScoreJIS() / valid8, // JIS (double)ScoreEUC() / valid8, // EUC-JP (double)ScoreUTF8() / valid8, // UTF-8 (double)ScoreSJIS() / valid8, // Shift_JIS }; // 文字エンコードの候補、scoreList[]の並び順と対応させること Encoding[] encodingList = { Encoding.BigEndianUnicode, // UTF-16BE Encoding.Unicode, // UTF-16LE Encoding.GetEncoding(50221), // JIS + 半角カナ + IBM拡張文字 Encoding.GetEncoding(51932), // EUC-JP + IBM拡張文字 Encoding.UTF8, // UTF-8 Encoding.GetEncoding(932), // Shift_JIS + IBM拡張文字 }; // Sort()はデフォルトが昇順ソートなので、低得点→高得点の順になる Array.Sort(scoreList, encodingList); // 反転すると高得点→低得点の順になる Array.Reverse(encodingList); // 結果を返す return encodingList; } // iが配列範囲内ならMyBuf[i]、そうでなければ-1を返す private int Peek(int i) { if (i < MyBuf.Length) { return MyBuf[i]; } else { return -1; } } // Shift_JISの得点：Shift_JISとして有効なバイト数 private int ScoreSJIS() { int i = 0; while (i < MyBuf.Length) { int ch = MyBuf[i]; if (ascii(ch)) { // ASCII英数字 ++i; } else if (sjis_1of2(ch) && sjis_2of2(Peek(i + 1))) { // Shift_JIS 2バイト漢字 i += 2; } else if (sjis_Kana(ch)) { // Shift_JIS 半角カナ ++i; } else { // Shift_JISではない文字が出たら終了 break; } } return i; } // EUC-JPの得点：EUC-JPとして有効なバイト数 private int ScoreEUC() { int i = 0; while (i < MyBuf.Length) { int ch = MyBuf[i]; if (ascii(ch)) { // ASCII英数字 ++i; } else if (euc_1of2(ch) && euc_2of2(Peek(i + 1))) { // EUC-JP 2バイト漢字 i += 2; } else if (euc_1of3(ch) && euc_2of3(Peek(i + 1)) && euc_3of3(Peek(i + 2))) { // EUC-JP 3バイト漢字 i += 3; } else if (euc_1ofKana(ch) && euc_2ofKana(Peek(i + 1))) { // EUC-JP 2バイト半角カナ i += 2; } else { // EUC-JPではない文字が出たら終了 break; } } return i; } // JISの得点：JISとして有効なバイト数＋KI/KOっぽい記号の数 private int ScoreJIS() { int escape = 0; int i = 0; while (i < MyBuf.Length) { int ch = MyBuf[i]; if (ascii(ch)) { // ASCII英数字 ++i; } else if ((ch == 0x1B) && jis_Esc(Peek(i + 1))) { // KI/KO記号の先頭2バイト（かもしれない） i += 2; ++escape; } else if (jis_Kana(ch)) { // JIS 半角カナ ++i; } else { // JISではない文字が出たら終了 break; } } return i + escape; } // UTF-8の得点：UTF-8として有効なバイト数 private int ScoreUTF8() { int i = 0; while (i < MyBuf.Length) { int ch = MyBuf[i]; if (ascii(ch)) { // ASCII英数字 ++i; } else if (u8_1of2(ch) && u8(Peek(i + 1))) { // UTF-8 2バイト文字 i += 2; } else if (u8_1of3(ch) && u8(Peek(i + 1)) && u8(Peek(i + 2))) { // UTF-8 3バイト文字 i += 3; } else if (u8_1of4(ch) && u8(Peek(i + 1)) && u8(Peek(i + 2)) && u8(Peek(i + 3))) { // UTF-8 4バイト文字 i += 4; } else { // UTF8ではない文字が出たら終了 break; } } return i; } // UTF-16LEの得点：UTF-16LEとして有効なバイト数＋BOMボーナス private int ScoreUTF16LE() { int bom = Peek(0) * 256 + Peek(1); if (bom == 0xFeFF) { // UTF-16BEのBOMを検出したので、UTF-16LEではありえない return 0; } int i = 0; while (i < MyBuf.Length) { if ((MyBuf[i] == 0) && (Peek(i + 1) == 0)) { // 2バイト連続して0なら終端とみなす break; } else if (u16_1of2(Peek(i + 1))) { // UTF-16LE 2バイト文字 i += 2; } else if (u16_1of4(Peek(i + 1)) && u16_3of4(Peek(i + 3))) { // UTF-16LE 4バイト文字 i += 4; } else { // UTF-16LEではない文字が出たら終了 break; } } // UTF-16LEのBOMを検出したら得点+1 if (bom == 0xFFFe) { i += 1; } return i; } // UTF-16BEの得点：UTF-16BEとして有効なバイト数＋BOMボーナス private int ScoreUTF16BE() { int bom = Peek(0) * 256 + Peek(1); if (bom == 0xFFFe) { // UTF-16BEのBOMを検出したので、UTF-16LEではありえない return 0; } int i = 0; while (i < MyBuf.Length) { if ((MyBuf[i] == 0) && (Peek(i + 1) == 0)) { // 2バイト連続して0なら終端とみなす break; } else if ((i + 1 < MyBuf.Length) && u16_1of2(MyBuf[i])) { // UTF-16BE 2バイト文字 i += 2; } else if ((i + 3 < MyBuf.Length) && u16_1of4(MyBuf[i]) && u16_3of4(MyBuf[i + 2])) { // UTF-16BE 4バイト文字 i += 4; } else { // UTF-16BEではない文字が出たら終了 break; } } // UTF-16BEのBOMを検出したら得点+1 if (bom == 0xFeFF) { i += 1; } return i; } // 1バイトずつ見て、0が出るまでの長さを返す private int CountValid8() { for (int i = 0; i < MyBuf.Length; ++i) { if (MyBuf[i] == 0) return i; } return MyBuf.Length; } // 2バイトずつ見て、(0,0)が出るまでの長さを返す private int CountValid16() { for (int i = 0; i < MyBuf.Length - 1; i += 2) { if (MyBuf[i] == 0 && MyBuf[i + 1] == 0) return i; } return MyBuf.Length; } //==================================================================== // 文字コードの大まかな判定 // 厳密な定義はJISなどの資料を参照のこと // ASCII 1バイト英数記号 + 制御文字 private static bool ascii(int ch) { return (ch >= 0x07 && ch <= 0x0D) || (ch >= 0x20 && ch <= 0x7E); } // Shift_JIS 2バイト漢字の第1バイト private static bool sjis_1of2(int ch) { return (ch >= 0x81 && ch <= 0x9F) || (ch >= 0xE0 && ch <= 0xFC); } // Shift_JIS 2バイト漢字の第2バイト private static bool sjis_2of2(int ch) { return (ch >= 0x40 && ch <= 0x7E) || (ch >= 0x80 && ch <= 0xFC); } // Shift_JIS 1バイト半角カナ private static bool sjis_Kana(int ch) { return (ch >= 0xA1 && ch <= 0xDF); } // EUC-JP 2バイト漢字の第1バイト private static bool euc_1of2(int ch) { return (ch >= 0xA1 && ch <= 0xA8) || (ch == 0xAD) || (ch >= 0xB0 && ch <= 0xFE); } // EUC-JP 2バイト漢字の第2バイト private static bool euc_2of2(int ch) { return (ch >= 0xA1 && ch <= 0xFE); } // EUC-JP 3バイト漢字の第1バイト private static bool euc_1of3(int ch) { return (ch == 0x8F); } // EUC-JP 3バイト漢字の第2バイト private static bool euc_2of3(int ch) { return (ch >= 0xA1 && ch <= 0xAB) || (ch >= 0xB0 && ch <= 0xED) || (ch >= 0xF3 && ch <= 0xFE); } // EUC-JP 3バイト漢字の第3バイト private static bool euc_3of3(int ch) { return (ch >= 0xA1 && ch <= 0xFE); } // EUC-JP 2バイト半角カナの第1バイト private static bool euc_1ofKana(int ch) { return (ch == 0x8E); } // EUC-JP 2バイト半角カナの第2バイト private static bool euc_2ofKana(int ch) { return (ch >= 0xA1 && ch <= 0xDF); } // JIS エスケープ文字(0x1B)の次にくるべき文字 private static bool jis_Esc(int ch) { return (ch == '$' || ch == '(' || ch == '.'); } // JIS X0201 片仮名 （いわゆる半角カナ） private static bool jis_Kana(int ch) { return (ch >= 0xA1 && ch <= 0xDF); } // UTF-8 2バイト漢字の第1バイト private static bool u8_1of2(int ch) { return (ch >= 0xC2 && ch <= 0xDF); } // UTF-8 3バイト漢字の第1バイト private static bool u8_1of3(int ch) { return (ch >= 0xE0 && ch <= 0xEF); } // UTF-8 4バイト漢字の第1バイト private static bool u8_1of4(int ch) { return (ch >= 0xF0 && ch <= 0xF7); } // UTF-8 多バイト漢字の第2バイト以降 private static bool u8(int ch) { return (ch >= 0x80 && ch <= 0xBF); } // UTF-16 2バイト漢字の第1バイト private static bool u16_1of2(int ch) { return (ch >= 0x00 && ch <= 0xD7) || (ch >= 0xE0 && ch <= 0xFF); } // UTF-16 4バイト漢字の第1バイト private static bool u16_1of4(int ch) { return (ch >= 0xD8 && ch <= 0xDB); } // UTF-16 4バイト漢字の第3バイト private static bool u16_3of4(int ch) { return (ch >= 0xDC && ch <= 0xDF); } } }

おそらく世の中にはもっと優秀なライブラリがあるだろうが、まあ自作のコードは愛着があるよね。 コードを入力し終えたらコンパイルして、「MyLibV03.dll」というファイル名で保存する。

●プログラム本体

1. NetJob2という名前で、プロジェクトを作成する
2. ソリューションエクスプローラの「参照」で、MyLibV03.dllの参照を追加する
3. Form1.csを開き、次のコードを入力する

// プロジェクト：NetJob2 // ファイル名：Form1.cs using System; using System.Drawing; using System.IO; using System.Net; using System.Text; using System.Windows.Forms; using MarugeProject; namespace NetJob2 { public partial class Form1 : Form { // コントロールなど private SplitContainer MySplitBox; private RichTextBox MyReportBox; private RichTextBox MyWebTextBox; private TextBox MyInputBox; private Button MyGetButton; private RichReporter MyReporter; // フォームのコンストラクタ public Form1() { InitializeComponent(); // タイトルバーにプログラム名を表示する this.Text = Application.ProductName; // ウィンドウサイズを400x400にする this.Width = 400; this.Height = 400; // 上下分割コンテナを作る MySplitBox = new SplitContainer(); MySplitBox.Name = "MySplitBox"; MySplitBox.Anchor = AnchorStyles.Left | AnchorStyles.Right | AnchorStyles.Top | AnchorStyles.Bottom; MySplitBox.Left = 8; MySplitBox.Top = 8; MySplitBox.Width = this.ClientSize.Width - 16; MySplitBox.Height = this.ClientSize.Height - 40; MySplitBox.BorderStyle = BorderStyle.FixedSingle; MySplitBox.Orientation = Orientation.Horizontal; MySplitBox.SplitterDistance = 200; // 分割コンテナの上側にネットデータ表示用のRichTextBoxを配置する MyWebTextBox = new RichTextBox(); MyWebTextBox.Name = "MyWebTextBox"; MyWebTextBox.BorderStyle = BorderStyle.None; MyWebTextBox.Dock = DockStyle.Fill; MyWebTextBox.DetectUrls = false; MySplitBox.Panel1.Controls.Add(MyWebTextBox); // 分割コンテナの下側にレポート出力用のRichTextBoxを配置する MyReportBox = new RichTextBox(); MyReportBox.Name = "MyReportBox"; MyReportBox.BorderStyle = BorderStyle.None; MyReportBox.Dock = DockStyle.Fill; MySplitBox.Panel2.Controls.Add(MyReportBox); // 「テキストを読み込む」ボタンを作る MyGetButton = new Button(); MyGetButton.Name = "MyGetButton"; MyGetButton.Anchor = AnchorStyles.Right | AnchorStyles.Bottom; MyGetButton.Left = this.ClientSize.Width - 128; MyGetButton.Top = this.ClientSize.Height - 30; MyGetButton.Width = 120; MyGetButton.Text = "テキストを読み込む(&R)"; MyGetButton.Click += MyGetButton_Click; // テキスト入力ボックスを作る MyInputBox = new TextBox(); MyInputBox.Name = "MyInputBox"; MyInputBox.Anchor = AnchorStyles.Left | AnchorStyles.Right | AnchorStyles.Bottom; MyInputBox.Left = 8; MyInputBox.Top = MyGetButton.Top + 2; MyInputBox.Width = this.ClientSize.Width - MyGetButton.Width - 18; MyInputBox.Text = "http://"; // 各コントロールをフォームに配置する this.SuspendLayout(); this.Controls.Add(MySplitBox); this.Controls.Add(MyGetButton); this.Controls.Add(MyInputBox); this.ResumeLayout(); // テキスト出力の準備 MyReportBox.DetectUrls = false; MyReportBox.Font = new Font("MS UI Gothic", 12); MyReporter = new RichReporter(MyReportBox); // 初期メッセージを出力 MyReporter.Print("使用方法：\n"); MyReporter.Print("URLを入力 → 「テキストを読み込む」をクリック\n\n"); } // 「テキストを読み込む」ボタンをクリック private void MyGetButton_Click(object sender, EventArgs e) { MyReportBox.Clear(); MyReporter.Print("接続します\n"); byte[] data = ReadNetData(MyInputBox.Text); if (data != null) { Encoding enc = EncodingChecker.GetEncoding(data); MyReporter.Print("成功しました\n"); MyReporter.Print("文字コードは " + enc.EncodingName + " です\n"); MyWebTextBox.Text = enc.GetString(data); } else { MyReporter.ColorPrint(Color.Red, "失敗しました\n"); } } // ネットからバイナリテキストを読み込む private byte[] ReadNetData(string URL) { try { // ネットからデータを読み込み、byte配列として返す WebClient client = new WebClient(); return client.DownloadData(URL.Trim()); } catch { // 読み込み失敗ならnullを返す return null; } } } }

プログラムを起動し、テキストファイルのURLを入力して「テキストを読み込む」ボタンを押すと、上部のテキストボックスに内容が表示される。

テキストとは言うけどプレーンテキストだけじゃなくて、HTMLファイルも、RSSフィードも、中身は文字だけなのでこのプログラムで表示できる。

●要点の解説

WebClientクラスを利用してネットからデータを読み出すのは、画像の場合と同じだ。

ちょっと違うのは、前回はReadOpen()メソッドを利用しネットデータをストリーム形式でオープンしたが、今回はDownloadData()メソッドを利用して全データを一気にbyte配列に取得したことだ。メモリが少なかった昔はこういう大名プログラムは書かなかったが、時代は変わったのだ。

っていうか今考えたら、画像データもこのDownloadData()メソッドで取得すればよかったじゃない。そうすればストリームを閉じるの閉じないので、エラーが起きることもなかった…かもしれない。

取得した生のデータは、先ほどのMyLibライブラリのEncodingCheckerで文字コードを調べる。ちなみに使い方は、

Encoding enc = EncodingChecker.GetEncoding(バイト配列);

とすれば指定したバイト配列のエンコードを推測し、Encoding型の結果をencに入れる。あとは通常のEncoding.GetString()メソッドにより、適切な方法でstring型に変換可能だ。

バグ修正

今日の目標→

今日はバグの修正だけ。

●修正箇所

前回のForm1.csで、ReadNetImage()メソッドの次の部分に問題があった。

return Image.FromStream(stream);

これは次の3行のコードに差し替える。

MemoryStream mem = new MemoryStream();
stream.CopyTo(mem);
return Image.FromStream(mem);

そもそもWebClient.OpenRead()の説明で、「ストリームはすぐ閉じろ」的なことが書いてあるから、即クローズしていたのである。しかも、確実にストリームをクローズできるように、わざわざtry～catch～finally構文とか使ってた。

ところが、Image.FromStream()の説明を見たら、「読み込んだ画像の使用中はストリームを閉じちゃダメ」だって。なんだよそれ。

結局、ネットデータのストリームはメモリにコピーして接続を切る。そしてメモリストリームはクローズせず後始末をガベコレにまかせる、という折衷案にたどり着いたのであった。

バグ修正後のForm1.csが下記である。

// プロジェクト：NetJob // ファイル名：Form1.cs using System; using System.Net; using System.Drawing; using System.IO; using System.Windows.Forms; using MarugeProject; namespace NetJob { public partial class Form1 : Form { // コントロールなど private SplitContainer MySplitBox; private RichTextBox MyRichTextBox; private PictureBox MyPictBox; private TextBox MyInputBox; private Button MyGetButton; private RichReporter MyReporter; // フォームのコンストラクタ public Form1() { InitializeComponent(); // タイトルバーにプログラム名を表示する this.Text = Application.ProductName; // ウィンドウサイズを400x400にする this.Width = 400; this.Height = 400; // 上下分割コンテナを作る MySplitBox = new SplitContainer(); MySplitBox.Name = "MySplitBox"; MySplitBox.Anchor = AnchorStyles.Left | AnchorStyles.Right | AnchorStyles.Top | AnchorStyles.Bottom; MySplitBox.Left = 8; MySplitBox.Top = 8; MySplitBox.Width = this.ClientSize.Width - 16; MySplitBox.Height = this.ClientSize.Height - 40; MySplitBox.BorderStyle = BorderStyle.FixedSingle; MySplitBox.Orientation = Orientation.Horizontal; MySplitBox.SplitterDistance = 200; // 分割コンテナの上側にピクチャボックスを配置する MyPictBox = new PictureBox(); MyPictBox.Name = "MyPictBox"; MyPictBox.BorderStyle = BorderStyle.None; MyPictBox.Dock = DockStyle.Fill; MySplitBox.Panel1.Controls.Add(MyPictBox); // 分割コンテナの下側にリッチテキストボックスを配置する MyRichTextBox = new RichTextBox(); MyRichTextBox.Name = "MyRichTextBox"; MyRichTextBox.BorderStyle = BorderStyle.None; MyRichTextBox.Dock = DockStyle.Fill; MySplitBox.Panel2.Controls.Add(MyRichTextBox); // 「画像を読み込む」ボタンを作る MyGetButton = new Button(); MyGetButton.Name = "MyGetButton"; MyGetButton.Anchor = AnchorStyles.Right | AnchorStyles.Bottom; MyGetButton.Left = this.ClientSize.Width - 128; MyGetButton.Top = this.ClientSize.Height - 30; MyGetButton.Width = 120; MyGetButton.Text = "画像を読み込む(&R)"; MyGetButton.Click += MyGetButton_Click; // テキスト入力ボックスを作る MyInputBox = new TextBox(); MyInputBox.Name = "MyInputBox"; MyInputBox.Anchor = AnchorStyles.Left | AnchorStyles.Right | AnchorStyles.Bottom; MyInputBox.Left = 8; MyInputBox.Top = MyGetButton.Top + 2; MyInputBox.Width = this.ClientSize.Width - MyGetButton.Width - 18; MyInputBox.Text = "http://"; // 各コントロールをフォームに配置する this.SuspendLayout(); this.Controls.Add(MySplitBox); this.Controls.Add(MyGetButton); this.Controls.Add(MyInputBox); this.ResumeLayout(); // テキスト出力の準備 MyRichTextBox.DetectUrls = false; MyRichTextBox.Font = new Font("MS UI Gothic", 12); MyReporter = new RichReporter(MyRichTextBox); // 初期メッセージを出力 MyReporter.Print("使用方法：\n"); MyReporter.Print("URLを入力 → 「画像を読み込む」をクリック\n\n"); } // 「画像を読み込む」ボタンをクリック private void MyGetButton_Click(object sender, EventArgs e) { MyRichTextBox.Clear(); MyReporter.Print("接続します\n"); Image image = ReadNetImage(MyInputBox.Text); if (image != null) { MyReporter.Print("成功しました\n"); MyPictBox.Image = image; } else { MyReporter.ColorPrint(Color.Red, "失敗しました\n"); } } // ネットにアクセスして画像を読み込む private Image ReadNetImage(string URL) { Stream stream = null; try { // ネットから画像を読み込み、Image型で返す WebClient client = new WebClient(); stream = client.OpenRead(URL.Trim()); // return Image.FromStream(stream); // ←バグるので下記に変更 MemoryStream mem = new MemoryStream(); stream.CopyTo(mem); return Image.FromStream(mem); } catch { // 読み込み失敗ならnullを返す return null; } finally { // 成功でも失敗でも、戻る前に必ずストリームを閉じる if (stream != null) { stream.Close(); stream.Dispose(); } } } } }

旧版のプログラムはアニメーションGIFを読み込ませると不正終了した。今度は大丈夫だろう…たぶん…。

P010-ネットの画像を読み込む

今日の目標→

いまどきのプログラムは、やはりネットに接続できないと話にならない。今回はその最も簡単な例として、ネットから画像を取得してピクチャボックスに表示するプログラムを作ってみる。

●MyLibの修正

その前に、前回発見したMyLibライブラリの不具合（namespaceに全角文字を発見！）を修正しておく。コードを直すついでに、行数上限を変えるSetMaxLines()メソッドも追加した。

// プロジェクト：MyLib // ファイル名：RichReporter.cs using System.Drawing; using System.Windows.Forms; namespace MarugeProject { /// <summary> /// リッチテキストボックスに文字表示するクラス /// </summary> public class RichReporter { // 出力先のリッチテキストボックス private RichTextBox MyTextBox; // 行数の上限 private int MyMaxLines; /// <summary> /// コンストラクタ：引数で出力先を指定する /// </summary> public RichReporter(RichTextBox target) { MyTextBox = target; MyMaxLines = 20; } /// <summary> /// 行数の上限を設定する /// </summary> public void SetMaxLines(int maxLines) { if (maxLines < 2) { MessageBox.Show( "行数上限は2以上を指定してください", "RichReporter.SetMaxLines()"); } else { MyMaxLines = maxLines; } } /// <summary> /// 色なしのテキスト表示 /// </summary> public void Print(string text) { // デフォルトの文字色で表示する ColorPrint(MyTextBox.ForeColor, text); } /// <summary> /// 色付きのテキスト表示 /// </summary> public void ColorPrint(Color textColor, string text) { // テキストを末尾に追加する AddText(textColor, text); // 行数がMyMaxLinesを超えたら先頭行から削除する CheckLines(MyMaxLines); // もし必要なら末尾までスクロールする 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(); } } }

修正したライブラリをコンパイルしたら、「MyLibV02.dll」というファイル名で保存する。今後ライブラリの修正や機能強化のたびに、「V」の後ろの番号を増やしていく予定である。

●プログラム本体

1. NetJobという名前で、プロジェクトを作成する
2. ソリューションエクスプローラの「参照」で、MyLibV02.dllの参照を追加する
3. Form1.csを開き、次のコードを入力する

// プロジェクト：NetJob // ファイル名：Form1.cs using System; using System.Net; using System.Drawing; using System.IO; using System.Windows.Forms; using MarugeProject; namespace NetJob { public partial class Form1 : Form { // コントロールなど private SplitContainer MySplitBox; private RichTextBox MyRichTextBox; private PictureBox MyPictBox; private TextBox MyInputBox; private Button MyGetButton; private RichReporter MyReporter; // フォームのコンストラクタ public Form1() { InitializeComponent(); // タイトルバーにプログラム名を表示する this.Text = Application.ProductName; // ウィンドウサイズを400x400にする this.Width = 400; this.Height = 400; // 上下分割コンテナを作る MySplitBox = new SplitContainer(); MySplitBox.Name = "MySplitBox"; MySplitBox.Anchor = AnchorStyles.Left | AnchorStyles.Right | AnchorStyles.Top | AnchorStyles.Bottom; MySplitBox.Left = 8; MySplitBox.Top = 8; MySplitBox.Width = this.ClientSize.Width - 16; MySplitBox.Height = this.ClientSize.Height - 40; MySplitBox.BorderStyle = BorderStyle.FixedSingle; MySplitBox.Orientation = Orientation.Horizontal; MySplitBox.SplitterDistance = 200; // 分割コンテナの上側にピクチャボックスを配置する MyPictBox = new PictureBox(); MyPictBox.Name = "MyPictBox"; MyPictBox.BorderStyle = BorderStyle.None; MyPictBox.Dock = DockStyle.Fill; MySplitBox.Panel1.Controls.Add(MyPictBox); // 分割コンテナの下側にリッチテキストボックスを配置する MyRichTextBox = new RichTextBox(); MyRichTextBox.Name = "MyRichTextBox"; MyRichTextBox.BorderStyle = BorderStyle.None; MyRichTextBox.Dock = DockStyle.Fill; MySplitBox.Panel2.Controls.Add(MyRichTextBox); // 「画像を読み込む」ボタンを作る MyGetButton = new Button(); MyGetButton.Name = "MyGetButton"; MyGetButton.Anchor = AnchorStyles.Right | AnchorStyles.Bottom; MyGetButton.Left = this.ClientSize.Width - 128; MyGetButton.Top = this.ClientSize.Height - 30; MyGetButton.Width = 120; MyGetButton.Text = "画像を読み込む(&R)"; MyGetButton.Click += MyGetButton_Click; // テキスト入力ボックスを作る MyInputBox = new TextBox(); MyInputBox.Name = "MyInputBox"; MyInputBox.Anchor = AnchorStyles.Left | AnchorStyles.Right | AnchorStyles.Bottom; MyInputBox.Left = 8; MyInputBox.Top = MyGetButton.Top + 2; MyInputBox.Width = this.ClientSize.Width - MyGetButton.Width - 18; MyInputBox.Text = "http://"; // 各コントロールをフォームに配置する this.SuspendLayout(); this.Controls.Add(MySplitBox); this.Controls.Add(MyGetButton); this.Controls.Add(MyInputBox); this.ResumeLayout(); // テキスト出力の準備 MyRichTextBox.DetectUrls = false; MyRichTextBox.Font = new Font("MS UI Gothic", 12); MyReporter = new RichReporter(MyRichTextBox); // 初期メッセージを出力 MyReporter.Print("使用方法：\n"); MyReporter.Print("URLを入力 → 「画像を読み込む」をクリック\n\n"); } // 「画像を読み込む」ボタンをクリック private void MyGetButton_Click(object sender, EventArgs e) { MyRichTextBox.Clear(); MyReporter.Print("接続します\n"); Image image = ReadNetImage(MyInputBox.Text); if (image != null) { MyReporter.Print("成功しました\n"); MyPictBox.Image = image; } else { MyReporter.ColorPrint(Color.Red, "失敗しました\n"); } } // ネットにアクセスして画像を読み込む private Image ReadNetImage(string URL) { Stream stream = null; try { // ネットから画像を読み込み、Image型で返す WebClient client = new WebClient(); stream = client.OpenRead(URL.Trim()); return Image.FromStream(stream); } catch { // 読み込み失敗ならnullを返す return null; } finally { // 成功でも失敗でも、戻る前に必ずストリームを閉じる if (stream != null) { stream.Close(); } } } } }

プログラムを起動し、左下の入力欄に画像ファイルのURLを入力して「画像を読み込む」ボタンを押すと、ピクチャボックスに表示されるはずなのでお試しを。

今回から始まる「ネット接続」シリーズの土台となるプログラムなので、ウィンドウ構成もちょっと凝ってみた。基本は上下に分割されたウィンドウがあって、上部にデータ表示ウィンドウ（今回はピクチャボックス）、下部にレポート出力用のテキストボックスを配置している。

●要点の解説

ネット接続の中心になるのはWebClientクラスだ。このクラスは指定されたURLに接続し、そこからデータを読み出すという縁の下の作業を受け持つ。そのデータをどのように処理するかは、個々のプログラムの仕事である。

今回は画像の取得なので、Image.FromStream()メソッドでストリームからデータを読み出すだけでImage型の画像が作られる。

P009-DLLライブラリを使う

今日の目標→

自作のDLLライブラリを呼び出して使う。

●プロジェクトの作成

通常の「Windowsフォームアプリケーション」テンプレートで、「TextWork5」プロジェクトを作る。前回の作業のせいで、デフォルトは「クラスライブラリ」のテンプレートになってると思うので注意。

●「参照」の追加

プロジェクトが作られたら、自作DLLファイルの参照を追加する。

1. ソリューションエクスプローラの「参照」を右クリック→「参照の追加(R)」
2. 標準リストの中にないDLLは、下の「参照(B)」ボタンを押して自力で探す
3. 前回作った「MyLib.dll」が見つかったら、「追加」ボタンを押す

これで「参照」にMyLibが追加された。

●MyLibを呼び出すコードを入力

Form1.csの最初に、

using ＭarugeProject

と書けば、MyLibで定義した公開メソッドが呼び出せるようになる。

using System; using System.Drawing; using System.Windows.Forms; using ＭarugeProject; namespace TextWork5 { public partial class Form1 : Form { // コントロール private RichTextBox MyTextBox; private Button MyStartButton; private 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 RichReporter(MyTextBox); } // 「開始(S)」ボタンのクリック private void MyStartButton_Click(object sender, EventArgs e) { MyReporter.Print("DLL作成編、"); MyReporter.ColorPrint(Color.Red, "これにて完了\n"); } } }

なんだったら完全修飾名で「ＭarugeProject.RichReporter()」みたいに書いてもよい。

●実は重大なミスが

前回、MyLibのRichReporter.csのコードを書いたとき、

namespace ＭarugeProject

の「Ｍ」が全角でした…。なんか変だと思ったんだよ。しょうがないので、今回のTextWork5のコードでも全角「Ｍ」を使ってます。次回までにMyLibのほうを修正しなくては…。

P008-DLLライブラリの作成

今日の目標→

自作クラスをDLL形式のライブラリにする手順を述べる。 やたら長くなったけど、このライブラリは後でいろいろ機能を追加して育てていく土台になるので頑張る。

●ライブラリ用のプロジェクトを作成

DLLライブラリを作るには、いつもの「Windowsフォームアプリケーション」ではなく、次のように「クラスライブラリ」のテンプレートを選ぶ。

1. メニューバーから「ファイル(F)」→「新しいプロジェクト(P)」で、プロジェクト作成ウィンドウを開く
2. 左のカテゴリで「Visual C#」、右のアイコンで「クラスライブラリ」を選ぶ
3. 名前を「MyLib」と入力して「OK」ボタンをクリックする

●「参照」の追加

プロジェクトができたら、ウィンドウ右上のソリューションエクスプローラで、「参照」をダブルクリックすると、このプロジェクトで使える外部ライブラリの一覧が表示される。このままだと足りない感じなので、次の手順でライブラリを追加しておく。

1. ソリューションエクスプローラの「参照」を右クリック→「参照の追加(R)」
2. 左のカテゴリで「アセンブリ」、サブカテゴリ「フレームワーク」を選ぶ
3. 右のリストで「System.Drawing」を探してチェックマーク
4. 同じく右のリストで「System.Windows.Forms」を探してチェックマーク
5. 「OK」ボタンを押す

これで「参照」にSystem.DrawingとSystem.Windows.Formsが追加された。今はこれで十分だ。後で足りないものがあったら、そのときにまた追加すればよろしい。

●不要なコードを削除

デフォルトで存在する「Class1.cs」は不要なので、ソリューションエクスプローラで消しておく。

Class1.csを右クリック→「削除(V)」

●自作クラスのコードを追加

ライブラリに自作クラスのコードを追加する。手で入力しても良いし、すでに存在するなら次のようにファイルから読み込んでも、どっちでも良い。

1. メニューバーから「プロジェクト(P)」→「既存の項目の追加(G)」でファイルダイアログを開く
2. "TextWork3"プロジェクトのフォルダを探す
3. ファイル"RichReporter.cs"を選択する
4. 「追加」ボタンを押す

●コードのnamespaceを変更

前回も書いたとおり、ライブラリのnamespaceは自分好みに変えて良い、というか変更すべきである。本当は中二病的なカッコいい名前が好きなんだけど、まあ妙にこだわると後で恥ずかしいからな…。というわけで好きなピザにちなんで、

namespace MarugeProject

に決定。読み方は「マルゲプロジェクト」ね。変更後のコードを下記に示す。

using System.Drawing; using System.Windows.Forms; namespace ＭarugeProject { // リッチテキストボックスに文字表示するクラス 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(); } } }

namespace以外に変更した箇所はない。

●プロジェクトをコンパイルしてDLLファイルを作る

クラスライブラリの作成プロジェクトは、いつものように「開始」ボタンで実行はできない。その代わり次の方法でコンパイルする。

メニューバーから「ビルド」→「ソリューションのビルド」を選択

コンパイルが終わると、プロジェクトのフォルダの下、bin\Debugサブフォルダに「MyLib.dll」というファイルが作られる。これがDLL形式のライブラリである。

なお、bin\Debugサブフォルダは一時的な保管場所で、たとえば「ビルド(B)」→「ソリューションのクリーン(C)」メニューを実行すると削除されてしまう。なので完成したDLLファイルは適当な別フォルダにコピーしておくとよいかも。

●次回の予告

うわー記事が長くなりすぎた。今日はここまでといたします。作成したDLLライブラリを呼び出して利用する手順は、次回で書くことにします。

あと、本ブログの記事で作ってるプログラムをアーカイブして、ダウンロードできる方法を考えています。どこにファイルを置くかが問題だ。

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

今日の目標→

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

●プロジェクトの準備

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

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

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

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

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

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

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化して、それを呼び出します。

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

今日の目標→

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

●プロジェクトの作成

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

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

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

// 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クラスを利用する

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

// 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; // リッチテキストボックスを作る 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 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化して利用する方法について説明する。

P005-文字を色付きで表示

今日の目標→

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

●プロジェクトの作成

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

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); // 開始ボタンを作る 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; // 停止ボタンを作る 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(); } // リッチテキストボックスの末尾に色付きのテキストを追加する 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(); } } }

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

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

（実行画面が入る予定）

●文字に色

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

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

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

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

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

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

●余分な行を削除

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

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

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

●最下行までスクロール

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

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

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

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

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

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

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

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

今日の目標→

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

●プロジェクトの作成

1. 「TextWork」という名前で、新規プロジェクトを作る
2. 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(); // テキストボックスを作る 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); // 開始ボタンを作る 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; // 終了ボタンを作る 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) { // 開始メッセージ表示 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クラス）についても、いつか説明したいところ。

（実行画面が入る予定）

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

今日の目標→

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

●プロジェクトの作成

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

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の使い方はそのうちちゃんと説明するので、しばらくお待ちくだされ。

（実行画面が入る予定）

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

今日の目標→

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

●プロジェクトの作成

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

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(); // ピクチャボックスを作る 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; } // フォームへのドラッグ開始 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, "画像が読めません"); } } } }

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

●要点の解説

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

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

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

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

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

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

（実行画面が入る予定）

P001-画像表示プログラム

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

●プロジェクトの作成

1. メインメニューから［ファイル］→［新しいプロジェクト］を選ぶく
2. 開いたウィンドウで、左上のツリーから［Visual C#］を選ぶ
3. 右のテンプレート一覧から［Windowsフォームアプリケーション］を選ぶ
4. 下の名前欄にプログラムの名前を入力（ここではImageViewとした）
5. ［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(); // ピクチャボックスを作る 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(); } // ボタンクリックのイベントハンドラ 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のデザイナー上でマウスで置くこともできるが、個人的には上記のようにぜんぶコードで書くほうが好きだ。そのほうが早いし。

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

（画像が入る予定）

Windowsのユーザー環境設定（その4）

新規アカウント作成時にやっとくべき定番の環境設定。これでラストのはず。

●ファイル名拡張子を見えるようにする

1. タスクバーからエクスプローラーを起動する
2. ［表示］メニューを選ぶ
3. ［ファイル名拡張子］にチェックマークをつける

プログラム開発時にファイル名拡張子が見えないのは、何かと不便なので、見えるようにしておく。これは［表示］→［オプション］で開くウィンドウで設定することもできるが、チェックボックスのほうがお手軽。

●コンソールウィンドウのフォント等をお好みで設定

コンソールウィンドウとは、キャラクタベースのプログラムを実行するとき表示されるウィンドウだ。デフォルトのフォントやサイズをここで設定できる。

1. スタートメニューを右クリック→［コマンドプロンプト］を開く
2. タイトルバー左端のメニューをクリック→［規定値］を選ぶと、［コンソールウィンドウのプロパティ］ウィンドウが開く
3. ［フォント］タブで、フォントを設定できる
4. ［レイアウト］タブで、ウィンドウの位置とサイズを指定できる

ちなみにタイトルバー左端のメニューの［プロパティ］では、コマンドプロンプト自体の設定ができ、それは規定値を上書きする。［規定値］は全キャラクタベースプログラムの基本設定である。

●Microsoft IMEが外部サーバと通信するのを停止

1. スタートメニューからコントロールパネルを開く
2. 右上の検索ボックスに「IME」と入力する
3. 検索結果に出てきた［Microsoft IMEの設定（日本語）］を開く
4. 設定ウィンドウが開くので［詳細設定］をクリック
5. ［クラウド候補を使用する］のチェックをはずす

変換時にいちいちBing（Microsoftの検索エンジン）と通信するのはウザい。まあ予測入力自体もちょっとウザいので、［予測入力を使用する］自体のチェックをはずしてもいい。

Windowsのユーザー環境設定（その3）

Windows10のユーザー環境設定、あとちょっと。

●プライバシー関連の設定

1. スタート画面から「設定」を開く
2. ［プライバシー］を選ぶ
3. 左メニューで［全般］が選択されている。［プライバシーオプションの変更］を全部オフにする。
4. 左メニューで［位置情報］を選ぶ。
   • ［位置情報］をオフにする。
   • ［場所の履歴］にある［クリア］ボタンを押して、位置情報を消去しておく。
   • ［位置情報を使えるようにするアプリを選ぶ］は、全部オフになっている。
   • ［ジオフェンス］も、何かあれば全部オフに。
5. 左メニューで［カメラ］を選ぶ。
   • ［アプリがカメラを使うことを許可する］は、オフにしておけば安心だが、まあテレビ電話の利用などを考慮して、ここはオンにする。
   • ［カメラを使用できるアプリの選択］は、必要なものだけオンにして残りをオフにする。
6. 左メニューで［マイク］を選び、音声入力が必須なアプリだけオンにして、残りはオフにする。
7. 左メニューで［音声認識、手描き入力、入力の設定］を選び、［自分の情報を知らせない］→［オフにする］を実行する。
8. 左メニューで［アカウント情報］を選び、右の［アカウント情報］をオフにする
9. 左メニューで［連絡先］を選び、とりあえず全部オフにする。なにか問題が生じたら、個別のアプリに対して連絡先をオンにする。
10. 左メニューで［カレンダー］を選び全部オフ。問題が生じたら、個別のアプリに対してカレンダーの公開をオンにする。
11. 左メニューで［通話履歴］を選び、全部オフで。
12. 左メニューで［メール］を選び、全部オフで。
13. 左メニューで［メッセージング］を選び、全部オフで。
14. 左メニューで［無線］を選び、全部オフで。
15. 左メニューで［他のデバイス］を選び、全部オフで。
16. 左メニューで［フィードバックと診断］を選び、お好みで設定する。
17. 左メニューで［バックグラウンドアプリ］を選び、使うものだけオン、残りをオフにする。

Windowsのユーザー環境設定（その2）

Windows10のユーザー環境設定の続き。

●デスクトップの色などを設定する

1. スタート画面から、コントロールパネルを開く
2. ［デスクトップのカスタマイズ］を開く
3. ［個人設定］を開く
4. ［デスクトップの背景］を開き、背景を［単色］にして背景色を選ぶ。
5. 左のメニューから［色］を選ぶ
   • ［背景から自動的にアクセントカラーを選ぶ］はオフ。自分で色を選ぶ。
   • ［スタート、タスクバー、アクションセンター、タイトルバーに色を付ける］はオンにするのが良い。オフにするとウィンドウのタイトルバーや枠線が白くなり、重なったウィンドウの境界がわかりにくい。
   • ［スタート、タスクバー、アクションセンターを透明にする］はオンにするほうがかっこいいが、お好みでオフにする選択もアリ。
6. 左のメニューから［ロック画面］を選ぶ
   • ［背景］は、画像でもスライドショーでも、お好みで。
   • ［ロック画面にトリビアやヒントなどの情報を表示する］は、オンにするとロック画面がうざいのでオフにする。
   • ［状態の詳細を表示するアプリを選ぶ］も、うざいので［なし］にする。
   • ［簡易ステータスを表示するアプリを選ぶ］も、すべて［なし］にする
   • ［サインイン画面にWindowsの背景画像を表示する］は、オンにする。こうするとマルチユーザー環境では、サインインの名前を選んだときに各人の選んだ背景が表示されるのでわかりやすい。
   • ［スクリーンタイムアウト設定］はデフォルトで良いため変更しない。
   • ［スクリーンセーバー設定］もデフォルトで良いため変更しない。
7. 左のメニューから［テーマ］を選ぶ
   • ［テーマの設定］は、コントロールパネルに戻るだけなのでいじらなくていい
   • ［サウンドの詳細設定］は、デフォルトで良いので何もしない。
   • ［デスクトップのアイコンの設定］もデフォルト（ゴミ箱だけ表示）で良い。
   • ［マウスポインターの設定］もデフォルトで良い。
8. 左のメニューから［スタート］を選び、お好みでオンオフを設定する。おすすめは「全部オフ」である。

Windowsのユーザー環境設定（その1）

新しいアカウントでWindows10にログインしたら、さっそくユーザー環境を設定する。以下はプログラミングに関係ない部分もあるが、メモ代わりに手順を最初から詳しく書いてみる。

●スタート画面の整理

まずはスタートボタンで「スタート画面」を開くと、初期設定でいろいろなアプリのアイコンが並んでいる。どれもいらないので消す。アイコンを消すには、

アイコンを右クリック→［スタート画面からピンをはずす」

を実行すれば良い。

画面がさっぱりしたら必要なアイコンを追加していく。スタート画面の「すべてのアプリ」を開くと、いろいろなアプリが出てくるので、必要なものだけスタート画面にピン留めする。ピン留めは、

アプリ名を右クリック→［スタート画面にピン留めする」

で可能である。ここでは以下のアプリをピン留めする。

• ［Windowsアクセサリ］→［Snipping Tool］
• ［Windowsアクセサリ］→［ペイント］
• ［Windowsアクセサリ］→［メモ帳］
• ［Windowsシステムツール］→［コントロールパネル］
• ［せ］→［設定］

特に［コントロールパネル］と［設定］は、以後の作業で使うので、忘れずにピン留めしておくべし。

●タスクバーの整理

アプリのアイコンはタスクバーに表示することもできる。スタート画面で次の手順を実行すればよい。

アイコンを右クリック→［その他］→［タスクバーにピン留め］

またタスクバー自体を右クリックすると、タスクバーの機能が設定できる。ほとんどデフォルトのままで良いが、「検索ボックス」は邪魔なので消しておく。

タスクバー右クリック→［検索］→［表示しない］

なお、ナビゲータソフトの「Ｃｏｒｔａｎａ」を一度も起動していないと、検索ボックスの代わりにＣｏｒｔａｎａ起動ボタンがあるので、起動して話を聞いてやる。

プログラミング用アカウントの作成

自作プログラムを管理者権限でデバッグしていると、システムの大事なファイルを壊してしまわないか心配になる。

そこで今後のプログラミングは、すべて一般アカウントで作業する。Windows10で一般アカウントを作る手順を次に示す。

1. スタートメニューを右クリック→［コントロールパネル］を開く
2. ［ユーザーアカウント］カテゴリの［アカウントの種類の変更］を選ぶ
3. ［PC設定で新しいユーザーを追加］を選ぶ
4. ［そのほかのユーザーをこのPCに追加］をクリックすると、ユーザー追加ウィンドウが開く
5. ［このユーザーのサインイン情報がありません］を選ぶ
6. ［Microsoftアカウントを持たないユーザーを追加する］を選ぶ
7. ［このPCを使うのはだれですか？］に、適当な名前を入力する。
8. パスワードは記入しなくてよし。一般ユーザだから、あまり悪さできないし。
9. ［次へ］ボタンをクリックすれば、ユーザ登録完了。
10. いったんログアウトし、新しくつくったアカウントでWindowsにログインできることを確認する。

以後はこのアカウントでWindowsにログインした状態でプログラミングを行う。

Visual Studio（無償版）のインストール

無償版のVisual Studioにはいくつか種類がある。2015年時点で利用できる代表的なものを以下にあげる。

• Visual Studio Express 2012 for Windows Desktop
• Visual Studio Express 2013 for Windows Desktop
• Visual Studio Community 2013
• Visual Studio Express 2015 for Windows Desktop
• Visual Studio Community 2015

各バージョンの数字部分は発表年度で、基本的に新しいものほど機能が充実している。特にこだわりがなければ最新版を使えばよい。

次に「Express」と「Community」の違いだが、Expressは動作環境ごとの開発ツールだ。たとえば、

• PCプログラム用　→    Express for Windows Desktop
• Webプログラム用　→    Express for Web

というように、ターゲットごとに別パッケージが用意されている。

これに対してCommunityは、複数の動作環境に対応した開発ツールだ。こちらはオールインワンで便利だが、規模が大きいため扱いが難しいところもある。

本ブログでは、基本的にPC用のプログラムしか扱わないので、「Visual Studio Express 2015 for Windows Desktop」を利用して話を進めることにする。

インストール手順は次のとおりである（2015年11月現在）。

(1) Microsoft本家のダウンロード用サイトを開く

https://www.visualstudio.com/downloads/download-visual-studio-vs

(2) 中央の左側にバージョン選択メニューがあるので「2015」を選ぶ。

（画像準備中）

(3) メニューから目的の「Visual Studio Express 2015 for Windows Desktop」を選ぶと、画面の右側にダウンロード用ボタンが現れる。

（画像準備中）

(4) 「ダウンロード」ボタンをクリックすると"wdexpress_full.exe"のダウンロードが始まる。これは単なるインストーラであり、ファイルサイズも3MB程度なので、ダウンロードはすぐに完了する。

(5) ダウンロードフォルダを開き、wdexpress_full.exeを実行すると、Visual Studio本体のダウンロードとインストールが始まる。データ量は2GB近くあり、インストールが完了するまで数十分から数時間はかかると覚悟したほうがよい。

インストールが完了したら、 Windowsのスタートメニューに"Visual Studio 2015"というグループが作られているはずだ。その中の"VS 2015 Express for Desktop"というアイコンをクリックすると、いよいよVisual Studioが起動する。

（画像準備中）

趣味のプログラミング熱が高まるの巻

我が家にもWindows10マシンがやってきた。せっかくなのでVisual Studioの一番新しいやつ（無料版）をインストールしていじっていたら、久しぶりにWindowsプログラミング熱が高まってきた。なんかいっちょ面白いプログラムでも作ってみるか。

というわけで本ブログでは、いろんなWindowsプログラミングに挑戦する私の姿をライブでお伝えしていこうと思う。同好の士にとって少しでも参考になることがあれば幸いである。