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

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

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

ToolStripItem.Owner プロパティ

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

この項目の所有者を取得または設定します。

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

Visual Basic (宣言)

Public Property Owner As
 ToolStrip

Visual Basic (使用法)

Dim instance As ToolStripItem
Dim value As ToolStrip

value = instance.Owner

instance.Owner = value

public ToolStrip Owner { get; set;
 }

C++

public:
property ToolStrip^ Owner {
    ToolStrip^ get ();
    void set (ToolStrip^ value);
}

/** @property */
public ToolStrip get_Owner ()

/** @property */
public void set_Owner (ToolStrip value)

JScript

public function get Owner
 () : ToolStrip

public function set Owner
 (value : ToolStrip)

プロパティ値
ToolStripItem を所有しているか、これから所有する ToolStrip。

解説

Owner プロパティを使用して、すべての ToolStripItem に共通し、ToolStrip 自体で定義されている ImageList などのオブジェクトを検索します。

項目が ToolStripOverflow に該当しても、Owner は同じままです。DisplayedItems コレクション内の特定の要素に対しては、Owner を null 参照 (Visual Basic では Nothing) に設定できますが、Items コレクションの場合は設定できません。

使用例

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

Visual Basic

' This method defines the painting behavior of the control.
' It performs the following operations:
'
' Computes the layout of the item's image and text.
' Draws the item's background image.
' Draws the item's image.
' Draws the item's text.
'
' Drawing operations are implemented in the 
' RolloverItemRenderer class.
Protected Overrides Sub
 OnPaint(e As PaintEventArgs)
   MyBase.OnPaint(e)
   
   If Not (Me.Owner Is
 Nothing) Then
      ' Find the dimensions of the image and the text 
      ' areas of the item. 
      Me.ComputeImageAndTextLayout()
      
      ' Draw the background. This includes drawing a highlighted 
      ' border when the mouse is in the client area.
      Dim ea As New ToolStripItemRenderEventArgs(e.Graphics,
 Me)
      Me.Owner.Renderer.DrawItemBackground(ea)
      
      ' Draw the item's image. 
      Dim irea As New ToolStripItemImageRenderEventArgs(e.Graphics,
 Me, imageRect)
      Me.Owner.Renderer.DrawItemImage(irea)
      
      ' If the item is on a drop-down, give its
      ' text a different highlighted color.
      Dim highlightColor As Color = IIf(Me.IsOnDropDown,
 Color.Salmon, SystemColors.ControlLightLight)
      
      ' Draw the text, and highlight it if the 
      ' the rollover state is true.
      Dim rea As New ToolStripItemTextRenderEventArgs(e.Graphics,
 Me, MyBase.Text, textRect, IIf(Me.rolloverValue,
 highlightColor, MyBase.ForeColor), MyBase.Font, MyBase.TextAlign)
      Me.Owner.Renderer.DrawItemText(rea)
   End If
 End Sub

// This method defines the painting behavior of the control.
// It performs the following operations:
//
// Computes the layout of the item's image and text.
// Draws the item's background image.
// Draws the item's image.
// Draws the item's text.
//
// Drawing operations are implemented in the 
// RolloverItemRenderer class.
protected override void OnPaint(PaintEventArgs
 e)
{
    base.OnPaint(e);

    if (this.Owner != null)
    {
        // Find the dimensions of the image and the text 
        // areas of the item. 
        this.ComputeImageAndTextLayout();

        // Draw the background. This includes drawing a highlighted
 
        // border when the mouse is in the client area.
        ToolStripItemRenderEventArgs ea = new ToolStripItemRenderEventArgs(
             e.Graphics,
             this);
        this.Owner.Renderer.DrawItemBackground(ea);

        // Draw the item's image. 
        ToolStripItemImageRenderEventArgs irea =
            new ToolStripItemImageRenderEventArgs(
            e.Graphics,
            this,
            imageRect );
        this.Owner.Renderer.DrawItemImage(irea);

        // If the item is on a drop-down, give its
        // text a different highlighted color.
        Color highlightColor = 
            this.IsOnDropDown ?
            Color.Salmon : SystemColors.ControlLightLight;

        // Draw the text, and highlight it if the 
        // the rollover state is true.
        ToolStripItemTextRenderEventArgs rea =
            new ToolStripItemTextRenderEventArgs(
            e.Graphics,
            this,
            base.Text,
            textRect,
            this.rolloverValue ? highlightColor : base.ForeColor
,
            base.Font,
            base.TextAlign);
        this.Owner.Renderer.DrawItemText(rea);
    }
}