WinForms Labelで複数行テキストを表示する方法

1. 概要

本資料では、WinFormsアプリケーションにおいて、Labelコントロールを使用して複数行のテキストを表示する方法について説明します。
主に、改行コードの利用、AutoSizeプロパティの設定、サイズ調整方法に関して解説します。

2. 対象環境

  • 開発環境: Visual Studio (例: Visual Studio 2019以降)
  • フレームワーク: .NET Framework または .NET Core（WinForms対応バージョン）
  • 対象OS: Windows

3. 複数行表示の基本的な手順

3.1 改行コードの利用

LabelのTextプロパティに直接改行コード (\r\n) を含めることで、複数行のテキストを表示できます。
例えば、以下のように記述します。

label1.Text = "1行目\r\n2行目\r\n3行目";

3.2 AutoSizeプロパティの設定

LabelのAutoSizeプロパティがtrueの場合、ラベルのサイズがテキストに合わせて自動調整されるため、表示領域が狭くなり、改行が適切に反映されない場合があります。
複数行表示を確実に行うためには、AutoSizeをfalseに設定し、Sizeプロパティで必要な大きさを指定してください。

label1.AutoSize = false;
label1.Size = new Size(200, 60);  // 適宜サイズを調整

4. サンプルコード

以下は、WinFormsアプリケーションのフォームロードイベント内で複数行のテキストをLabelに表示するサンプルコードです。

using System;
using System.Drawing;
using System.Windows.Forms;

namespace MultiLineLabelSample
{
    public partial class MainForm : Form
    {
        public MainForm()
        {
            InitializeComponent();
            SetupLabel();
        }

        private void SetupLabel()
        {
            // Labelの生成と設定
            Label multiLineLabel = new Label();
            multiLineLabel.Location = new Point(20, 20);
            multiLineLabel.AutoSize = false;           // 自動サイズ調整を無効にする
            multiLineLabel.Size = new Size(200, 60);     // 表示領域を設定
            multiLineLabel.Text = "1行目\r\n2行目\r\n3行目";
            multiLineLabel.BorderStyle = BorderStyle.FixedSingle;  // 枠線を表示（任意）

            // フォームにLabelを追加
            this.Controls.Add(multiLineLabel);
        }
    }
}

5. 注意事項

  • 改行コードの環境依存性:
    Windows環境では\r\nが改行コードとして一般的ですが、他の環境での動作を考慮する場合、環境に応じた改行コードの使用を検討してください。
  • サイズ調整:
    複数行表示を行う場合、表示領域が不足するとテキストが切れてしまう可能性があるため、Sizeプロパティで十分な領域を確保してください。また、場合によってはTextAlignプロパティでテキストの配置を調整すると見栄えが良くなります。

6. まとめ

WinFormsのLabelで複数行のテキストを表示するには、以下のポイントに注意します。

  • Textプロパティに改行コード (\r\n) を挿入する。
  • AutoSizeプロパティをfalseに設定し、適切なSizeを指定する。

以上の手順に従うことで、WinFormsアプリケーションで見やすい複数行テキストの表示が可能になります。

C#,WindowsFormアプリ

Posted by hidepon