DirectInput を使用するための基本設定
この Tips では「Microsoft Visual Studio 2005 Standard Edition」を使用して説明しますが、Visual Studio 2005 で C# が使えれば基本的に他の種類でも設定はほとんど同じです。
とりあえずここからの説明は、「Visual Studio 2005 の使い方をある程度覚えた」「C# 言語をある程度理解している」「フォームのプロパティ設定、イベントの追加の仕方が分かる」ことを前程に説明していきます。
また、必要なコンポーネント(Visual Studio や DirectX SDK)などはひととおりインストールしていることとします。
最初にプロジェクトを「Windows アプリケーション」で新規に作成します。フォーム名は「Form1」から「MainForm」へと変更しておきます。
Visual Studio 2005 で DirectX 関連のプログラミングを行うには、「参照設定」に DirectX コンポーネントを追加しなくてはなりません。
「DirectInput」を使用するのですから、DirectInput 関連のクラスを使用することになります。しかし、今の状態だとコードを記述してもビルド時にクラスを認識してくれません。まずはじめにクラスを「参照」できる状態にします。
ソリューションエクスプローラの「参照設定」を右クリックして「参照の追加」を選択します。

しばらくしてダイアログが表示されたら、「.NET」タブを選択して、以下の項目を選択します。
- Microsoft.DirectX
- Microsoft.DirectX.DirectInput

「OK」ボタンを押すと「参照設定」に追加されたことがわかります。

次に、DirectInput を使用した時の状態を表示するために、フォームに「ラベル」を配置しましょう。あまり複雑にコントロールを配置すると大変なので、今回はこれでいいです。
ラベルはフォームの左上あたりにでも配置してください。

このラベルを外部のクラスから扱えるようにするために、ラベルのプロパティを追加します。アクセス権限を直接変える方法もありますが、どちらでもかまいません。(一般的にはプロパティを介したほうがいいと言われている)
MainForm.cs
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
namespace MDXSample
{
/// <summary>
///
/// </summary>
public partial class MainForm : Form
{
/// <summary>
/// ラベル
/// </summary>
public Label InputLabel
{
get { return this.label1; }
}
/// <summary>
///
/// </summary>
public MainForm()
{
InitializeComponent();
}
}
}
|
ではメインクラスのコード編集に移りますが、今回作成するコードはあくまでもサンプルとして説明しやすくなるように書き換えたものです。実際にソフト制作するときは、そのソフトにあわせたコードを書くようにして下さい。今回書くコードはどのソフトでも使用できるテンプレートではありません。
まずクラスをひとつ作成しましょう。基本的にサンプルはこのクラスにコードを書くようにします。プロジェクトを右クリックし、クラスを追加します。

下のようなダイアログが表示されますので、ファイル名を「MainSample.cs」としておきます。この名前がそのままクラス名となります。もちろん分かる人は自由に名前を付けてもらって結構です。

「.cs」ファイルが作成され、画面に表示されました。

では、MainSample.cs のコードファイルを書き換えます。下のコードを参考にしてください。
「///」と記述してある部分はコメントです。ただ、「//」と違い「XML」というものが関係していますが、深く考えずにコメントだと思ってもらってかまいません。詳しく知りたい人は調べてみてください。
MainSample.cs
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using Microsoft.DirectX;
using Microsoft.DirectX.DirectInput;
namespace MDXSample
{
/// <summary>
///
/// </summary>
public class MainSample : IDisposable
{
/// <summary>
///
/// </summary>
private MainForm _form = null;
/// <summary>
///
/// </summary>
/// <param name="topLevelForm"></param>
/// <returns></returns>
/// <remarks>
///
/// </remarks>
public bool InitializeApplication(MainForm topLevelForm)
{
this._form = topLevelForm;
return true;
}
/// <summary>
///
/// </summary>
public void MainLoop()
{
}
/// <summary>
///
/// </summary>
public void Dispose()
{
}
}
}
|
InitializeApplication メソッドは、DirectInput 関連のデータなどを初期化するためのメソッドです。フォームが表示される前に1度だけ呼ばれます。初期化、作成に失敗した場合は false を返すようにすると、アプリケーションがそのまま終了するようになります。
メインフォームは「MainLoop」メソッドで使用するので、フィールドとして持つようにします。
MainLoop メソッドは、入力デバイスの状態を常に受け取るために使用されます。このメソッドは Program クラスで毎回呼ばれるようにします。
Dispose メソッドは、DirectInput 関連の作成したリソースなどを解放するためのメソッドです。フォームが閉じた後に1度だけ呼ばれます。
このメソッドは「IDisposable インターフェース」を継承しているので、Program クラスで必ず呼ばれるように設定しています。
念のためビルドしてみて、エラーがなければ次のセクションに進んでください。エラーがあると下のようにエラー内容が出るので、そこを修正してください。

初心者は意外と「;(セミコロン)」を忘れやすい
次に Program.cs ファイルのコードを書き換えます。このように書き換えておけば、今後このファイルは DirectInput の Tips でほとんど書き換えることはありません。
説明は各行のコメントを見てください。
Program.cs
using System;
using System.Collections.Generic;
using System.Threading;
using System.Windows.Forms;
namespace MDXSample
{
/// <summary>
///
/// </summary>
static class Program
{
/// <summary>
///
/// </summary>
[STAThread]
static void Main()
{
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
using (MainForm frm = new MainForm())
using (MainSample sample = new MainSample())
{
if (sample.InitializeApplication(frm))
{
frm.Show();
while (frm.Created)
{
sample.MainLoop();
Thread.Sleep(1);
Application.DoEvents();
}
}
else
{
}
}
}
}
}
|
ビルド&実行で何も問題なければ、この Tips は終了です。DirectX らしい処理は何もしていませんが、これらの設定は以降の Tips の基本として使いますので、覚えておいてください。
ちなみに実行すると下のようになります。

サンプルプロジェクトです。
|