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

（実行画面が入る予定）