カウンタ

XNAXNA

ページ更新日 2009/ 1/ 4
広告

マウスの状態を取得する

概要
 マウスの現在の状態を取得します。各ボタンの操作、マウスの位置やホイールの回転量を表示しています。
マウスの状態を取得する
動作確認バージョン
対応 XNA バージョン
  • 3.0
対応プラットフォーム
  • Windows (XP SP2 以降, Vista)
  • Xbox 360
必要な頂点シェーダバージョン
1.1
必要なピクセルシェーダバージョン
1.1
サンプルの操作方法
動作 キーボード Xbox 360 コントローラー マウス
入力チェック - - すべて
内容

 マウスボタンの押下状態やマウスの位置を取得するには「Mouse.GetState」メソッドを使用します。これらの状態は MouseState 構造体に格納されています。

// マウスの状態を取得
this.mouseState = Mouse.GetState();
Mouse.GetState メソッド
マウスの位置やボタンの押下状態などを取得します。
戻り値 MouseState マウスの状態を取得します
MSDN ライブラリの Web ページへリンク

 今回のサンプルでは Draw メソッド内でマウスの状態を表示しているので MouseState をフィールドとして宣言しています。

/// <summary>
/// マウスの状態を記憶
/// </summary>
private MouseState mouseState = Mouse.GetState();

ボタン

 マウスのボタンが押されているかは「ButtonState」列挙と比較して判断できます。押しているかを調べるには「ButtonState.Pressed」で比較し、放しているかを調べるには「ButtonState.Released」で調べられます。

// マウスの左ボタン
if (this.mouseState.LeftButton == ButtonState.Pressed)
{
    stateMessage = "Pressed";
}
else
{
    stateMessage = "Released";
}

 マウスのボタンは以下のものが使用できます。

  • LeftButton
  • MiddleButton
  • RightButton
  • XButton1
  • XButton2

位置

 マウスの位置は「MouseState.X」「MouseState.Y」で取得できます。この値はスクリーンの左上を原点(0,0)とした値になり、右下に向かうほどプラスに、左上に向かうほどマイナスの値になります。

マウス位置の原点

// マウスの位置
this.spriteBatch.DrawString(this.font,
    "Position : " + this.mouseState.X + ", " + this.mouseState.Y,
    new Vector2(50.0f150.0f), Color.White);

ホイール

 マウスホイールのスクロール量は「MouseState.ScrollWheelValue」で取得できます。スクロール量はその時点での回転量ではなく、以前の値に対して加算減算されていきます。

// ホイールの回転量
this.spriteBatch.DrawString(this.font,
    "ScrollWheelValue : " + this.mouseState.ScrollWheelValue,
    new Vector2(50.0f170.0f), Color.White);

 Xbox 360 ではマウス関連のプログラムを記述することはできますが、マウス自体使用することはできないため、正常な値を取得することはできません。

サンプル実行ファイル (Windows のみ)
ファイル サイズ 対応XNAバージョン プラットフォーム 作成日
xna_tips_getmousestate_3_0_exe.zip 8.6 KB 3.0 Windows (XP SP2 以降, Vista) 2009/01/04
xna_tips_getmousestate_2_0_exe.zip 8.9 KB 2.0 Windows (XP SP2, Vista) 2008/01/01
xna_tips_getmousestate_1_0_ref_exe.zip 9.1 KB 1.0 Refresh Windows (XP SP2, Vista) 2007/07/23
プロジェクト ダウンロード
ファイル サイズ 対応XNAバージョン プラットフォーム 作成日
xna_tips_getmousestate_3_0_project.zip 18.9 KB 3.0 Windows (XP SP2 以降, Vista), Xbox 360 2009/01/04
xna_tips_getmousestate_2_0_project.zip 15.8 KB 2.0 Windows (XP SP2, Vista), Xbox 360 2008/01/01
xna_tips_getmousestate_1_0_ref_project.zip 15.9 KB 1.0 Refresh Windows (XP SP2, Vista), Xbox 360 2007/07/23
全コード
using System;
using System.Collections.Generic;
using Microsoft.Xna.Framework;
using Microsoft.Xna.Framework.Audio;
using Microsoft.Xna.Framework.Content;
using Microsoft.Xna.Framework.GamerServices;
using Microsoft.Xna.Framework.Graphics;
using Microsoft.Xna.Framework.Input;
using Microsoft.Xna.Framework.Media;
using Microsoft.Xna.Framework.Net;
using Microsoft.Xna.Framework.Storage;

namespace GetMouseState
{
    /// <summary>
    /// ゲームメインクラス
    /// </summary>
    public class GameMain : Microsoft.Xna.Framework.Game
    {
        /// <summary>
        /// グラフィックデバイス管理クラス
        /// </summary>
        private GraphicsDeviceManager graphics = null;

        /// <summary>
        /// スプライトのバッチ化クラス
        /// </summary>
        private SpriteBatch spriteBatch = null;

        /// <summary>
        /// スプライトでテキストを描画するためのフォント
        /// </summary>
        private SpriteFont font = null;

        /// <summary>
        /// マウスの状態を記憶
        /// </summary>
        private MouseState mouseState = Mouse.GetState();


        /// <summary>
        /// GameMain コンストラクタ
        /// </summary>
        public GameMain()
        {
            // グラフィックデバイス管理クラスの作成
            this.graphics = new GraphicsDeviceManager(this);

            // ゲームコンテンツのルートディレクトリを設定
            this.Content.RootDirectory = "Content";

            // ウインドウ上でマウスのポインタを表示するようにする
            this.IsMouseVisible = true;
        }

        /// <summary>
        /// ゲームが始まる前の初期化処理を行うメソッド
        /// グラフィック以外のデータの読み込み、コンポーネントの初期化を行う
        /// </summary>
        protected override void Initialize()
        {
            // TODO: ここに初期化ロジックを書いてください

            // コンポーネントの初期化などを行います
            base.Initialize();
        }

        /// <summary>
        /// ゲームが始まるときに一回だけ呼ばれ
        /// すべてのゲームコンテンツを読み込みます
        /// </summary>
        protected override void LoadContent()
        {
            // テクスチャーを描画するためのスプライトバッチクラスを作成します
            this.spriteBatch = new SpriteBatch(this.GraphicsDevice);

            // フォントをコンテンツパイプラインから読み込む
            this.font = this.Content.Load<SpriteFont>("Font");
        }

        /// <summary>
        /// ゲームが終了するときに一回だけ呼ばれ
        /// すべてのゲームコンテンツをアンロードします
        /// </summary>
        protected override void UnloadContent()
        {
            // TODO: ContentManager で管理されていないコンテンツを
            //       ここでアンロードしてください
        }

        /// <summary>
        /// 描画以外のデータ更新等の処理を行うメソッド
        /// 主に入力処理、衝突判定などの物理計算、オーディオの再生など
        /// </summary>
        /// <param name="gameTime">このメソッドが呼ばれたときのゲーム時間</param>
        protected override void Update(GameTime gameTime)
        {
            // Xbox 360 コントローラの BACK ボタンを押したときにゲームを終了させます
            if (GamePad.GetState(PlayerIndex.One).Buttons.Back == ButtonState.Pressed)
                this.Exit();

            // マウスの状態を取得
            this.mouseState = Mouse.GetState();

            // 登録された GameComponent を更新する
            base.Update(gameTime);
        }

        /// <summary>
        /// 描画処理を行うメソッド
        /// </summary>
        /// <param name="gameTime">このメソッドが呼ばれたときのゲーム時間</param>
        protected override void Draw(GameTime gameTime)
        {
            // 画面を指定した色でクリアします
            this.GraphicsDevice.Clear(Color.CornflowerBlue);

            // スプライトの描画準備
            this.spriteBatch.Begin();

            string stateMessage;

            // マウスの左ボタン
            if (this.mouseState.LeftButton == ButtonState.Pressed)
            {
                stateMessage = "Pressed";
            }
            else
            {
                stateMessage = "Released";
            }
            this.spriteBatch.DrawString(this.font, "LeftButton : " + stateMessage,
                new Vector2(50.0f, 50.0f), Color.White);

            // マウスの右ボタン
            if (this.mouseState.RightButton == ButtonState.Pressed)
            {
                stateMessage = "Pressed";
            }
            else
            {
                stateMessage = "Released";
            }
            this.spriteBatch.DrawString(this.font, "RightButton : " + stateMessage,
                new Vector2(50.0f, 70.0f), Color.White);

            // マウスの中ボタン
            if (this.mouseState.MiddleButton == ButtonState.Pressed)
            {
                stateMessage = "Pressed";
            }
            else
            {
                stateMessage = "Released";
            }
            this.spriteBatch.DrawString(this.font, "MiddleButton : " + stateMessage,
                new Vector2(50.0f, 90.0f), Color.White);

            // マウスのXボタン1
            if (this.mouseState.XButton1 == ButtonState.Pressed)
            {
                stateMessage = "Pressed";
            }
            else
            {
                stateMessage = "Released";
            }
            this.spriteBatch.DrawString(this.font, "XButton1 : " + stateMessage,
                new Vector2(50.0f, 110.0f), Color.White);

            // マウスのXボタン2
            if (this.mouseState.XButton2 == ButtonState.Pressed)
            {
                stateMessage = "Pressed";
            }
            else
            {
                stateMessage = "Released";
            }
            this.spriteBatch.DrawString(this.font, "XButton2 : " + stateMessage,
                new Vector2(50.0f, 130.0f), Color.White);

            // マウスの位置
            this.spriteBatch.DrawString(this.font,
                "Position : " + this.mouseState.X + ", " + this.mouseState.Y,
                new Vector2(50.0f, 150.0f), Color.White);

            // ホイールの回転量
            this.spriteBatch.DrawString(this.font,
                "ScrollWheelValue : " + this.mouseState.ScrollWheelValue,
                new Vector2(50.0f, 170.0f), Color.White);

            // スプライトの一括描画
            this.spriteBatch.End();

            // 登録された DrawableGameComponent を描画する
            base.Draw(gameTime);
        }
    }
}
更新履歴
更新日時 更新内容
2009/01/04 XNA Game Studio 3.0 用に修正
2008/05/18 文章・プログラムの校正
2008/01/12 対象プラットフォームに「Xbox 360」が含まれていたのを削除
2008/01/01 XNA Game Studio 2.0 用に修正
2007/07/23 ページ作成
ページトップ▲
Copyright (C) since 2005 Yuichi Onodera (オノデラユウイチ), All rights reserved.