ToolStripItem.Alignment

.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

C#

public ToolStripItemAlignment Alignment { get;
 set; }

C++

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

J#

/** @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

C#

// 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;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ToolStripItem クラス
ToolStripItem メンバ
System.Windows.Forms 名前空間

ToolStripItemAlignment 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

ToolStrip 内の ToolStripItem の配置を決定します。

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

Visual Basic (宣言)

Public Enumeration ToolStripItemAlignment

Visual Basic (使用法)

Dim instance As ToolStripItemAlignment

C#

public enum ToolStripItemAlignment

C++

public enum class ToolStripItemAlignment

J#

public enum ToolStripItemAlignment

JScript

public enum ToolStripItemAlignment

メンバ

	メンバ名	説明
	Left	ToolStrip の向きに応じて、ToolStripItem を ToolStrip の左端または上端に固定するよう指定します。System.Windows.Forms.RightToLeft の値が Yes の場合、Left としてマークされた項目は、ToolStrip の右側に揃えられます。
	Right	ToolStrip の向きに応じて、ToolStripItem を ToolStrip の右端または下端に固定するよう指定します。System.Windows.Forms.RightToLeft の値が Yes の場合、Right としてマークされた項目は、ToolStrip の左側に揃えられます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Windows.Forms 名前空間
RightToLeft 列挙体
ToolStripItem.Alignment プロパティ