ToolStripItem.Alignment プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ToolStripItem.Alignment プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

項目が ToolStrip の先頭または末尾のいずれに合わせて配置されるかを示す値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property Alignment As
 ToolStripItemAlignment

Visual Basic (使用法)

Dim instance As ToolStripItem
Dim value As ToolStripItemAlignment

value = instance.Alignment

instance.Alignment = value

public ToolStripItemAlignment Alignment { get;
 set; }

C++

public:
property ToolStripItemAlignment Alignment {
    ToolStripItemAlignment get ();
    void set (ToolStripItemAlignment value);
}

/** @property */
public ToolStripItemAlignment get_Alignment ()

/** @property */
public void set_Alignment (ToolStripItemAlignment
 value)

JScript

public function get Alignment
 () : ToolStripItemAlignment

public function set Alignment
 (value : ToolStripItemAlignment)

プロパティ値
ToolStripItemAlignment 値の 1 つ。既定値は Left です。

例外

例外の種類	条件
InvalidEnumArgumentException	代入された値が、ToolStripItemAlignment 値ではありません。

解説

Alignment プロパティを ToolStripItem.RightToLeft プロパティと共に使用して、ToolStrip 内の項目の配置を制御したり、既に配置されている項目を確認したりします。

ToolStripItem.RightToLeft プロパティが No の場合、Left として設定された項目は ToolStrip に左揃えで配置され、Right として設定された項目は右揃えで配置されます。

ToolStripItem.RightToLeft プロパティが Yes の場合、Left として設定された項目は ToolStrip に右揃えで配置され、Right として設定された項目は左揃えで配置されます。

使用例

Alignment プロパティを設定する方法を次のコード例に示します。このコード例は、ToolStripItem クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' This utility method creates a RolloverItem 
' and adds it to a ToolStrip control.
 Private Function CreateRolloverItem( _
 ByVal owningToolStrip As ToolStrip, _
 ByVal txt As String, _
 ByVal f As Font, _
 ByVal imgKey As String,
 _
 ByVal tir As TextImageRelation, _
 ByVal backImgKey As String)
 As RolloverItem

     Dim item As New RolloverItem()

     item.Alignment = ToolStripItemAlignment.Left
     item.AllowDrop = False
     item.AutoSize = True

     item.BackgroundImage = owningToolStrip.ImageList.Images(backImgKey)
     item.BackgroundImageLayout = ImageLayout.Center
     item.DisplayStyle = ToolStripItemDisplayStyle.ImageAndText
     item.DoubleClickEnabled = True
     item.Enabled = True
     item.Font = f

     ' These assignments are equivalent. Each assigns an
     ' image from the owning toolstrip's image list.
     item.ImageKey = imgKey
     'item.Image = owningToolStrip.ImageList.Images[infoIconKey];
     'item.ImageIndex = owningToolStrip.ImageList.Images.IndexOfKey(infoIconKey);
     item.ImageScaling = ToolStripItemImageScaling.None

     item.Owner = owningToolStrip
     item.Padding = New Padding(2)
     item.Text = txt
     item.TextAlign = ContentAlignment.MiddleLeft
     item.TextDirection = ToolStripTextDirection.Horizontal
     item.TextImageRelation = tir

     Return item
 End Function

// This utility method creates a RolloverItem 
// and adds it to a ToolStrip control.
private RolloverItem CreateRolloverItem(
    ToolStrip owningToolStrip,
    string txt,
    Font f,
    string imgKey,
    TextImageRelation tir,
    string backImgKey)
{
    RolloverItem item = new RolloverItem();

    item.Alignment = ToolStripItemAlignment.Left;
    item.AllowDrop = false;
    item.AutoSize = true;

    item.BackgroundImage = owningToolStrip.ImageList.Images[backImgKey];
    item.BackgroundImageLayout = ImageLayout.Center;
    item.DisplayStyle = ToolStripItemDisplayStyle.ImageAndText;
    item.DoubleClickEnabled = true;
    item.Enabled = true;
    item.Font = f;

    // These assignments are equivalent. Each assigns an
    // image from the owning toolstrip's image list.
    item.ImageKey = imgKey;
    //item.Image = owningToolStrip.ImageList.Images[infoIconKey];
    //item.ImageIndex = owningToolStrip.ImageList.Images.IndexOfKey(infoIconKey);
    item.ImageScaling = ToolStripItemImageScaling.None;

    item.Owner = owningToolStrip;
    item.Padding = new Padding(2);
    item.Text = txt;
    item.TextAlign = ContentAlignment.MiddleLeft;
    item.TextDirection = ToolStripTextDirection.Horizontal;
    item.TextImageRelation = tir;

    return item;
}