WinFormアプリでのカードゲーム基盤の作成

2024年8月12日

この技術資料では、WinFormアプリケーションで基本的なカードゲームの基盤を構築する方法について説明します。この基盤を利用することで、カードを扱うクラスやプレイヤーの手札を管理するクラス、そしてカードの画像を表示するためのPictureBoxの使用方法を学べます。

1. カードクラスの実装

カードクラスは、カードのスート（ハート、ダイヤ、クラブ、スペード）と値（1〜13）を表します。また、各カードに対応する画像のパスを保持します。

public class Card
{
    public string Suit { get; private set; }
    public int Value { get; private set; }
    public string ImagePath { get; private set; }

    public Card(string suit, int value, string imagePath)
    {
        Suit = suit;
        Value = value;
        ImagePath = imagePath;
    }

    public override string ToString()
    {
        return $"{Suit} の {Value}";
    }
}

2. デッキクラスの実装

デッキクラスは、カードの山を管理します。このクラスは、カードをシャッフルしたり、カードを引く機能を提供します。カードのスートは日本語で表現され、カード画像はimagesフォルダに保存されていると仮定します。

public class Deck
{
    private List<Card> cards;

    public Deck()
    {
        cards = new List<Card>();
        string[] suits = { "ハート", "ダイヤ", "クラブ", "スペード" };

        foreach (var suit in suits)
        {
            for (int i = 1; i <= 13; i++)
            {
                string imagePath = $"images/{suit.ToLower()}_{i}.png";
                cards.Add(new Card(suit, i, imagePath));
            }
        }
    }

    public void Shuffle()
    {
        Random rand = new Random();
        cards = cards.OrderBy(c => rand.Next()).ToList();
    }

    public Card DrawCard()
    {
        if (cards.Count == 0)
            return null;

        var card = cards[0];
        cards.RemoveAt(0);
        return card;
    }

    public int CardsRemaining()
    {
        return cards.Count;
    }
}

3. プレイヤークラスの実装

プレイヤークラスは、プレイヤーの名前と手札を管理します。手札のカードを表示する機能も提供します。

public class Player
{
    public string Name { get; private set; }
    private List<Card> hand;

    public Player(string name)
    {
        Name = name;
        hand = new List<Card>();
    }

    public void AddCardToHand(Card card)
    {
        if (card != null)
        {
            hand.Add(card);
        }
    }

    public void ShowHand(ListBox listBox)
    {
        listBox.Items.Clear();
        foreach (var card in hand)
        {
            listBox.Items.Add(card.ToString());
        }
    }
}

4. WinFormアプリケーションでのフォームデザイン

以下のフォームデザインを作成します。

• PictureBox (pictureBoxCard): 引いたカードの画像を表示。
• ListBox (listBoxHand): プレイヤーの手札を表示。
• Button (btnDrawCard): 「カードを引く」ボタン。
• Button (btnShowHand): 「手札を表示」ボタン。
• Label (lblCardsRemaining): 残りのカードの枚数を表示するラベル。

5. PictureBoxを使用したカード画像の表示

PictureBoxを使用して、引いたカードの画像を表示します。以下のコードでは、カードを引くたびにPictureBoxにカードの画像が表示され、残りのカード枚数が日本語で表示されます。

public partial class MainForm : Form
{
    private Deck deck;
    private Player player;

    public MainForm()
    {
        InitializeComponent();
        deck = new Deck();
        player = new Player("プレイヤー1");
        deck.Shuffle();
    }

    private void btnDrawCard_Click(object sender, EventArgs e)
    {
        var card = deck.DrawCard();
        if (card != null)
        {
            player.AddCardToHand(card);
            lblCardsRemaining.Text = $"残りのカード枚数: {deck.CardsRemaining()}";

            // PictureBoxにカードの画像を表示
            pictureBoxCard.Image = Image.FromFile(card.ImagePath);
        }
        else
        {
            lblCardsRemaining.Text = "カードがもうありません";
        }
    }

    private void btnShowHand_Click(object sender, EventArgs e)
    {
        player.ShowHand(listBoxHand);
    }
}

6. サンプルコードのまとめ

この資料では、WinFormアプリでカードゲームの基盤を作成するための基本的な手順を説明しました。PictureBoxを使用してカード画像を表示し、すべてのテキスト表示を日本語に対応させることで、より分かりやすいサンプルアプリケーションを構築できるようになっています。この基盤を基にして、さらにゲームのロジックやUIを追加することで、フル機能のカードゲームを作成できます。

---

以上が、WinFormアプリでのカードゲーム基盤の技術資料です。この資料を基に、さらに詳細なゲームシステムを作成していくことができます。