Control.SetBoundsCore メソッドとは何？わかりやすく解説 Weblio辞書

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

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

Control.SetBoundsCore メソッド

このコントロールの指定した境界を設定する作業を実行します。

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

Visual Basic (宣言)

Protected Overridable Sub
 SetBoundsCore ( _
    x As Integer, _
    y As Integer, _
    width As Integer, _
    height As Integer, _
    specified As BoundsSpecified _
)

Visual Basic (使用法)

Dim x As Integer
Dim y As Integer
Dim width As Integer
Dim height As Integer
Dim specified As BoundsSpecified

Me.SetBoundsCore(x, y, width, height, specified)

protected virtual void SetBoundsCore (
    int x,
    int y,
    int width,
    int height,
    BoundsSpecified specified
)

C++

protected:
virtual void SetBoundsCore (
    int x, 
    int y, 
    int width, 
    int height, 
    BoundsSpecified specified
)

protected void SetBoundsCore (
    int x, 
    int y, 
    int width, 
    int height, 
    BoundsSpecified specified
)

JScript

protected function SetBoundsCore (
    x : int, 
    y : int, 
    width : int, 
    height : int, 
    specified : BoundsSpecified
)

パラメータ

x: コントロールの新しい Left プロパティ値。

y: コントロールの新しい Top プロパティ値。

width: コントロールの新しい Width プロパティ値。

height: コントロールの新しい Height プロパティ値。

specified: BoundsSpecified 値のビットごとの組み合わせ。

解説

通常、specified パラメータに含まれない境界に対応するパラメータは、現在の値で渡されます。たとえば、Location プロパティの Height または Width、あるいは X または Y の各プロパティは、コントロールの現在のインスタンスに参照渡しできます。ただし、渡されたすべての値は有効で、コントロールに適用されます。

boundsSpecified パラメータは、アプリケーションによって変更された Bounds コントロールの要素を表します。たとえば、コントロールの Size を変更した場合、boundsSpecified パラメータ値は BoundsSpecified の Size 値になります。ただし、設定される Dock プロパティに応じて Size が調整される場合、boundsSpecified パラメータの値は BoundsSpecified の None 値になります。

継承時の注意 派生クラスで SetBoundsCore をオーバーライドする場合は、基本クラスの SetBoundsCore メソッドを呼び出して、強制的にコントロールの境界を変更してください。派生クラスでは、SetBoundsCore メソッドにサイズの制限を追加できます。

使用例

SetBoundsCore メソッドをオーバーライドして、コントロールを固定サイズのままにするコード例を次に示します。この例では、Control クラスから直接的または間接的に派生したクラスが存在している必要があります。

Visual Basic

Protected Overrides Sub
 SetBoundsCore(x As Integer, _
  y As Integer, width As
 Integer, _
  height As Integer, specified As
 BoundsSpecified)
   ' Set a fixed height and width for the control.
   MyBase.SetBoundsCore(x, y, 150, 75, specified)
End Sub

protected override void SetBoundsCore(int
 x, int y, 
   int width, int height, BoundsSpecified specified)
{
   // Set a fixed height and width for the control.
   base.SetBoundsCore(x, y, 150, 75, specified);
}

C++

protected:
   virtual void SetBoundsCore( int x, int
 y, int width, int height, BoundsSpecified
 specified ) override
   {
      // Set a fixed height and width for the control.
      UserControl::SetBoundsCore( x, y, 150, 75, specified );
   }

protected void SetBoundsCore(int
 x, int y, int width, int
 height,
    BoundsSpecified specified)
{
    // Set a fixed height and width for the control.
    super.SetBoundsCore(x, y, 150, 75, specified);
} //SetBoundsCore