Label クラス

標準の Windows ラベルを表します。

この型のすべてのメンバの一覧については、Label メンバ を参照してください。

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Windows.Forms.Control
            System.Windows.Forms.Label
               System.Windows.Forms.LinkLabel

Public Class Label
   Inherits Control
[C#]
public class Label : Control
[C++]
public __gc class Label : public Control
[JScript]
public class Label extends Control

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

通常、 Label コントロールは、コントロールについて説明するテキストを表示するために使用されます。たとえば、 Label を使用して TextBox コントロールを説明するテキストを追加し、ユーザーがそのコントロールに入力できるデータの型を示すことができます。 Label コントロールは、 Form に説明テキストを追加し、ユーザーに有用な情報を提供するためにも使用されます。たとえば、 Form の上部に Label を追加し、フォーム上のコントロールにデータを入力する方法をユーザーに説明できます。アプリケーションのステータスの実行時情報を表示するためにも Label コントロールを使用できます。たとえば、フォームに Label コントロールを追加し、一連のファイルの処理中に、各ファイルのステータスを表示できます。

Label はフォーム上のタブ オーダーには含まれますが、フォーカスは受け取りません。タブ オーダーの次のコントロールがフォーカスを受け取ります。たとえば、 UseMnemonic プロパティが true に設定され、コントロールの Text プロパティにニーモニック文字 (アンパサンド (&) の直後の文字) が指定されている場合、ユーザーが Alt キーを押しながらそのニーモニック キーを押すと、フォーカスはタブ オーダーの次のコントロールに移動します。これにより、キーボードを使用してフォーム上でフォーカスを移動できます。 Label コントロールは、テキストを表示するだけではなく、 Image プロパティを使用するか、 ImageIndex プロパティと ImageList プロパティを組み合わせて使用することによって、イメージも表示できます。

メモ    Label の BackColor プロパティを Color.Transparent に設定すると、ラベルを透明にすることができます。透明のラベルを使用する場合は、現在のデバイス座標系だけを使用してコンテナ上に描画します。他のデバイス座標系を使用すると、 Label の後ろにあるコントロールが適切に描画されない場合があります。

使用例

境界線が 3 次元で、イメージを表示する Label コントロールの作成例を次に示します。イメージは ImageList プロパティと ImageIndex プロパティを使用して表示されます。このコントロールには、ニーモニック文字を指定したキャプションも表示されます。このコードの例では、 PreferredHeight プロパティと PreferredWidth プロパティを使用して、 Label コントロールのサイズを適切に設定します。また、この例は、 imageList1 という名前の ImageList が作成され、2 つのイメージが読み込まれていることを前提にしています。このコードがフォーム内にあり、そのフォームのコードに System.Drawing 名前空間が追加されていることも前提にしています。

 
Public Sub CreateMyLabel()
    ' Create an instance of a Label.
    Dim label1 As New Label()
       
    ' Set the border to a three-dimensional border.
    label1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D
    ' Set the ImageList to use for displaying an image.
    label1.ImageList = imageList1
    ' Use the second image in imageList1.
    label1.ImageIndex = 1
    ' Align the image to the top left corner.
    label1.ImageAlign = ContentAlignment.TopLeft
     
    ' Specify that the text can display mnemonic characters.
    label1.UseMnemonic = True
    ' Set the text of the control and specify a mnemonic character.
    label1.Text = "First &Name:"
       
    ' Set the size of the control based on the PreferredHeight and PreferredWidth values. 
    label1.Size = New Size(label1.PreferredWidth, label1.PreferredHeight)

    '...Code to add the control to the form...
End Sub


[C#] 
public void CreateMyLabel()
{
   // Create an instance of a Label.
   Label label1 = new Label();

   // Set the border to a three-dimensional border.
   label1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D;
   // Set the ImageList to use for displaying an image.
   label1.ImageList = imageList1;
   // Use the second image in imageList1.
   label1.ImageIndex = 1;
   // Align the image to the top left corner.
   label1.ImageAlign = ContentAlignment.TopLeft;

   // Specify that the text can display mnemonic characters.
   label1.UseMnemonic = true;
   // Set the text of the control and specify a mnemonic character.
   label1.Text = "First &Name:";
   
   /* Set the size of the control based on the PreferredHeight and PreferredWidth values. */
   label1.Size = new Size (label1.PreferredWidth, label1.PreferredHeight);

   //...Code to add the control to the form...
}


[C++] 
public:
 void CreateMyLabel()
 {
    // Create an instance of a Label.
    Label* label1 = new Label();
 
    // Set the border to a three-dimensional border.
    label1->BorderStyle = System::Windows::Forms::BorderStyle::Fixed3D;
    // Set the ImageList to use for displaying an image.
    label1->ImageList = imageList1;
    // Use the second image in imageList1.
    label1->ImageIndex = 1;
    // Align the image to the top left corner.
    label1->ImageAlign = ContentAlignment::TopLeft;
 
    // Specify that the text can display mnemonic characters.
    label1->UseMnemonic = true;
    // Set the text of the control and specify a mnemonic character.
    label1->Text = S"First &Name:";
    
    /* Set the size of the control based on the PreferredHeight and PreferredWidth values. */
    label1->Size = System::Drawing::Size (label1->PreferredWidth, label1->PreferredHeight);
 
    //...Code to add the control to the form...
 }
 

[JScript] 
public function CreateMyLabel()
{
   // Create an instance of a Label.
   var label1 : Label = new Label();

   // Set the border to a three-dimensional border.
   label1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D;
   // Set the ImageList to use for displaying an image.
   label1.ImageList = imageList1;
   // Use the second image in imageList1.
   label1.ImageIndex = 1;
   // Align the image to the top left corner.
   label1.ImageAlign = ContentAlignment.TopLeft;

   // Specify that the text can display mnemonic characters.
   label1.UseMnemonic = true;
   // Set the text of the control and specify a mnemonic character.
   label1.Text = "First &Name:";
   
   /* Set the size of the control based on the PreferredHeight and PreferredWidth values. */
   label1.Size = new System.Drawing.Size (label1.PreferredWidth, label1.PreferredHeight);

   //...Code to add the control to the form...
}

必要条件

名前空間: System.Windows.Forms

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

参照

Label メンバ | System.Windows.Forms 名前空間 | Control | TextBox