ToolBarButton.Text プロパティ

ツール バー ボタンに表示されているテキストを取得または設定します。

Public Property Text As String
[C#]
public string Text {get; set;}
[C++]
public: __property String* get_Text();public: __property void set_Text(String*);
[JScript]
public function get Text() : String;public function set Text(String);

プロパティ値

ツール バー ボタンに表示されているテキスト。既定値は空の文字列 ("") です。

解説

テキスト文字列をパラメータとして受け入れる ToolBar コンストラクタによってコントロールを作成していない限り、既定の Text プロパティ値は空の文字列 ("") です。ツール バー ボタンのテキストの方向は、ボタンの親の ToolBar の TextAlign プロパティによって決定されます。このプロパティは ToolBarTextAlign 列挙値の 1 つに設定できます。テキストの方向は、ボタンに割り当てられたイメージに関連します。ボタンに割り当てられていない場合は、ツール バー ボタンの表面に空白が示されます。

使用例

[Visual Basic, C#, C++] ToolBar と 3 つの ToolBarButton コントロールを作成し、ボタンをツール バーに割り当ててから、ボタンの共通プロパティの一部を設定する例を次に示します。このコードは、 MenuItem 、 ImageList 、 ToolTip 、および Form が作成されていることと、 ImageList に少なくとも 1 つの Image が割り当てられていることを前提にしています。

 
Public Sub InitializeMyToolBar()
    ' Create the ToolBar, ToolBarButton controls, and menus.
    Dim toolBarButton1 As New ToolBarButton("Open")
    Dim toolBarButton2 As New ToolBarButton()
    Dim toolBarButton3 As New ToolBarButton()
    Dim toolBar1 As New ToolBar()
Dim menuItem1 As New MenuItem("Print")
Dim contextMenu1 As New ContextMenu(New MenuItem(){menuItem1})
    
    ' Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1)
    toolBar1.Buttons.Add(toolBarButton2)
    toolBar1.Buttons.Add(toolBarButton3)
    
    ' Assign an ImageList to the ToolBar and show ToolTips.
    toolBar1.ImageList = imageList1
    toolBar1.ShowToolTips = True
    
    ' Assign ImageIndex, ContextMenu, Text, ToolTip, and
    ' Style properties of the ToolBarButton controls. 
    toolBarButton2.Style = ToolBarButtonStyle.Separator
    toolBarButton3.Text = "Print"
    toolBarButton3.Style = ToolBarButtonStyle.DropDownButton
    toolBarButton3.ToolTipText = "Print"
    toolBarButton3.ImageIndex = 0
    toolBarButton3.DropDownMenu = contextMenu1
    
    ' Add the ToolBar to a form.
    Controls.Add(toolBar1)
End Sub


[C#] 
public void InitializeMyToolBar()
 {
    // Create the ToolBar, ToolBarButton controls, and menus.
    ToolBarButton toolBarButton1 = new ToolBarButton("Open");
    ToolBarButton toolBarButton2 = new ToolBarButton();
    ToolBarButton toolBarButton3 = new ToolBarButton();
    ToolBar toolBar1 = new ToolBar();
    MenuItem menuItem1 = new MenuItem("Print");
    ContextMenu contextMenu1 = new ContextMenu(new MenuItem[]{menuItem1});

     
    // Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1);
    toolBar1.Buttons.Add(toolBarButton2);
    toolBar1.Buttons.Add(toolBarButton3);
 
    // Assign an ImageList to the ToolBar and show ToolTips.
    toolBar1.ImageList = imageList1;
    toolBar1.ShowToolTips = true;
 
    /* Assign ImageIndex, ContextMenu, Text, ToolTip, and 
       Style properties of the ToolBarButton controls. */
    toolBarButton2.Style = ToolBarButtonStyle.Separator;
    toolBarButton3.Text = "Print";
    toolBarButton3.Style = ToolBarButtonStyle.DropDownButton;
    toolBarButton3.ToolTipText = "Print";
    toolBarButton3.ImageIndex = 0;
    toolBarButton3.DropDownMenu = contextMenu1;
 
    // Add the ToolBar to a form.
    Controls.Add(toolBar1);
 }
 

[C++] 
public:
void InitializeMyToolBar()
 {
    // Create the ToolBar, ToolBarButton controls, and menus.
    ToolBarButton* toolBarButton1 = new ToolBarButton(S"Open");
    ToolBarButton* toolBarButton2 = new ToolBarButton();
    ToolBarButton* toolBarButton3 = new ToolBarButton();
    ToolBar* toolBar1 = new ToolBar();
    MenuItem* menuItem1 = new MenuItem(S"Print");

    MenuItem* temp1 [] = {menuItem1};
    System::Windows::Forms::ContextMenu* contextMenu1 = new System::Windows::Forms::ContextMenu(temp1);

     
    // Add the ToolBarButton controls to the ToolBar.
    toolBar1->Buttons->Add(toolBarButton1);
    toolBar1->Buttons->Add(toolBarButton2);
    toolBar1->Buttons->Add(toolBarButton3);
 
    // Assign an ImageList to the ToolBar and show ToolTips.
    toolBar1->ImageList = imageList1;
    toolBar1->ShowToolTips = true;
 
    /* Assign ImageIndex, ContextMenu, Text, ToolTip, and 
       Style properties of the ToolBarButton controls. */
    toolBarButton2->Style = ToolBarButtonStyle::Separator;
    toolBarButton3->Text = S"Print";
    toolBarButton3->Style = ToolBarButtonStyle::DropDownButton;
    toolBarButton3->ToolTipText = S"Print";
    toolBarButton3->ImageIndex = 0;
    toolBarButton3->DropDownMenu = contextMenu1;
 
    // Add the ToolBar to a form.
    Controls->Add(toolBar1);
 }
 

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

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

参照

ToolBarButton クラス | ToolBarButton メンバ | System.Windows.Forms 名前空間 | Image