ToolStripItemPlacementとは何？わかりやすく解説 Weblio辞書

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

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

ToolStripItem.Placement プロパティ

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

項目の現在のレイアウトを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Placement As ToolStripItemPlacement

Visual Basic (使用法)

Dim instance As ToolStripItem
Dim value As ToolStripItemPlacement

value = instance.Placement

public ToolStripItemPlacement Placement { get;
 }

C++

public:
property ToolStripItemPlacement Placement {
    ToolStripItemPlacement get ();
}

/** @property */
public ToolStripItemPlacement get_Placement ()

JScript

public function get Placement
 () : ToolStripItemPlacement

プロパティ値
ToolStripItemPlacement 値の 1 つ。

使用例

Placement プロパティを使ったカスタムレンダリングの方法を、次のコード例に示します。このコード例は、ToolStripItem クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' This method defines the behavior for rendering the
' background of a ToolStripItem. If the item is a
' RolloverItem, it paints the item's BackgroundImage 
' centered in the client area. If the mouse is in the 
' item's client area, a border is drawn around it.
' If the item is on a drop-down or if it is on the
' overflow, a gradient is painted in the background.
Protected Overrides Sub
 OnRenderItemBackground(ByVal e As ToolStripItemRenderEventArgs)
    MyBase.OnRenderItemBackground(e)

    Dim item As RolloverItem = e.Item 

    ' If the ToolSTripItem is of type RolloverItem, 
    ' perform custom rendering for the background.
    If Not (item Is Nothing)
 Then
        If item.Placement = ToolStripItemPlacement.Overflow OrElse
 item.IsOnDropDown Then
            Dim b As New
 LinearGradientBrush(item.ContentRectangle, Color.Salmon, Color.DarkRed, 0.0F, False)
            Try
                e.Graphics.FillRectangle(b, item.ContentRectangle)
            Finally
                b.Dispose()
            End Try
        End If

        ' The RolloverItem control only supports 
        ' the ImageLayout.Center setting for the
        ' BackgroundImage property.
        If item.BackgroundImageLayout = ImageLayout.Center Then
            ' Get references to the item's ContentRectangle
            ' and BackgroundImage, for convenience.
            Dim cr As Rectangle = item.ContentRectangle
            Dim bgi As Image = item.BackgroundImage

            ' Compute the center of the item's ContentRectangle.
            Dim centerX As Integer
 = (cr.Width - bgi.Width) / 2
            Dim centerY As Integer
 = (cr.Height - bgi.Height) / 2

            ' If the item is selected, draw the background
            ' image as usual. Otherwise, draw it as disabled.
            If item.Selected Then
                e.Graphics.DrawImage(bgi, centerX, centerY)
            Else
                ControlPaint.DrawImageDisabled(e.Graphics, bgi, centerX, centerY,
 item.BackColor)
            End If
        End If

        ' If the item is in the rollover state, 
        ' draw a border around it.
        If item.Rollover Then
            ControlPaint.DrawFocusRectangle(e.Graphics, item.ContentRectangle)
        End If
    End If
End Sub

// This method defines the behavior for rendering the
// background of a ToolStripItem. If the item is a
// RolloverItem, it paints the item's BackgroundImage 
// centered in the client area. If the mouse is in the 
// item's client area, a border is drawn around it.
// If the item is on a drop-down or if it is on the
// overflow, a gradient is painted in the background.
protected override void OnRenderItemBackground(
    ToolStripItemRenderEventArgs e)
{
    base.OnRenderItemBackground(e);

    RolloverItem item = e.Item as RolloverItem;

    // If the ToolSTripItem is of type RolloverItem, 
    // perform custom rendering for the background.
    if (item != null)
    {
        if (item.Placement == ToolStripItemPlacement.Overflow
 ||
            item.IsOnDropDown)
        {
            using (LinearGradientBrush b = new
 LinearGradientBrush(
                item.ContentRectangle,
                Color.Salmon,
                Color.DarkRed,
                0f,
                false))
            {
                e.Graphics.FillRectangle(b, item.ContentRectangle);
            }
        }

        // The RolloverItem control only supports 
        // the ImageLayout.Center setting for the
        // BackgroundImage property.
        if (item.BackgroundImageLayout == ImageLayout.Center)
        {
            // Get references to the item's ContentRectangle
            // and BackgroundImage, for convenience.
            Rectangle cr = item.ContentRectangle;
            Image bgi = item.BackgroundImage;

            // Compute the center of the item's ContentRectangle.
            int centerX = (cr.Width - bgi.Width) / 2;
            int centerY = (cr.Height - bgi.Height) / 2;

            // If the item is selected, draw the background
            // image as usual. Otherwise, draw it as disabled.
            if (item.Selected)
            {
                e.Graphics.DrawImage(bgi, centerX, centerY);
            }
            else
            {
                ControlPaint.DrawImageDisabled(
                        e.Graphics,
                        bgi,
                        centerX,
                        centerY,
                        item.BackColor);
            }
        }

        // If the item is in the rollover state, 
        // draw a border around it.
        if (item.Rollover)
        {
            ControlPaint.DrawFocusRectangle(
                e.Graphics,
                item.ContentRectangle);
        }
    }
}

プラットフォーム

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 名前空間

ToolStripItemPlacement 列挙体

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

ToolStripItem をレイアウトする位置を指定します。

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

Visual Basic (宣言)

Public Enumeration ToolStripItemPlacement

Visual Basic (使用法)

Dim instance As ToolStripItemPlacement

public enum ToolStripItemPlacement

C++

public enum class ToolStripItemPlacement

public enum ToolStripItemPlacement

JScript

public enum ToolStripItemPlacement

メンバ

	メンバ名	説明
	Main	ToolStripItem をメイン ToolStrip 上にレイアウトするよう指定します。
	None	ToolStripItem を画面上にレイアウトしないよう指定します。
	Overflow	ToolStripItem をオーバーフロー ToolStrip にレイアウトするよう指定します。