Control.Invalidate メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

コントロールの特定の領域を無効にし、そのコントロールに描画メッセージを送信します。

オーバーロード

Invalidate(Region, Boolean)	コントロールの指定した領域を無効にし (そのコントロールの次の描画操作で再描画される領域を示す更新領域に追加し)、描画メッセージがそのコントロールに送信されるようにします。 オプションとして、そのコントロールに割り当てられている子コントロールも無効にします。
Invalidate(Rectangle, Boolean)	コントロールの指定した領域を無効にし (そのコントロールの次の描画操作で再描画される領域を示す更新領域に追加し)、描画メッセージがそのコントロールに送信されるようにします。 オプションとして、そのコントロールに割り当てられている子コントロールも無効にします。
Invalidate(Region)	コントロールの指定した領域を無効にし (そのコントロールの次の描画操作で再描画される領域を示す更新領域に追加し)、描画メッセージがそのコントロールに送信されるようにします。
Invalidate(Boolean)	コントロールの特定の領域を無効にし、そのコントロールに描画メッセージを送信します。 オプションとして、そのコントロールに割り当てられている子コントロールも無効にします。
Invalidate()	コントロールの表面全体を無効化して、コントロールを再描画します。
Invalidate(Rectangle)	コントロールの指定した領域を無効にし (そのコントロールの次の描画操作で再描画される領域を示す更新領域に追加し)、描画メッセージがそのコントロールに送信されるようにします。

Invalidate(Region, Boolean)

コントロールの指定した領域を無効にし (そのコントロールの次の描画操作で再描画される領域を示す更新領域に追加し)、描画メッセージがそのコントロールに送信されるようにします。 オプションとして、そのコントロールに割り当てられている子コントロールも無効にします。

C#

public void Invalidate (System.Drawing.Region? region, bool invalidateChildren);

パラメーター

region

Region

無効化する Region。

invalidateChildren

Boolean

コントロールの子コントロールを無効にする場合は true。それ以外の場合は false。

注釈

メソッドを Invalidate 呼び出しても、同期ペイントは強制されません。同期ペイントを強制するには、 メソッドを呼び出した後に Update メソッドを Invalidate 呼び出します。 このメソッドがパラメーターなしで呼び出されると、クライアント領域全体が更新リージョンに追加されます。

こちらもご覧ください

• Refresh()
• Update()

Invalidate(Rectangle, Boolean)

コントロールの指定した領域を無効にし (そのコントロールの次の描画操作で再描画される領域を示す更新領域に追加し)、描画メッセージがそのコントロールに送信されるようにします。 オプションとして、そのコントロールに割り当てられている子コントロールも無効にします。

C#

public void Invalidate (System.Drawing.Rectangle rc, bool invalidateChildren);

パラメーター

rc

Rectangle

無効化する領域を表す Rectangle。

invalidateChildren

Boolean

コントロールの子コントロールを無効にする場合は true。それ以外の場合は false。

注釈

メソッドを Invalidate 呼び出しても、同期ペイントは強制されません。同期ペイントを強制するには、 メソッドを呼び出した後に Update メソッドを Invalidate 呼び出します。 このメソッドがパラメーターなしで呼び出されると、クライアント領域全体が更新リージョンに追加されます。

こちらもご覧ください

• Refresh()
• Update()

Invalidate(Region)

コントロールの指定した領域を無効にし (そのコントロールの次の描画操作で再描画される領域を示す更新領域に追加し)、描画メッセージがそのコントロールに送信されるようにします。

C#

public void Invalidate (System.Drawing.Region? region);

パラメーター

region

Region

無効化する Region。

注釈

メソッドを Invalidate 呼び出しても、同期ペイントは強制されません。同期ペイントを強制するには、 メソッドを呼び出した後に Update メソッドを Invalidate 呼び出します。 このメソッドがパラメーターなしで呼び出されると、クライアント領域全体が更新リージョンに追加されます。

こちらもご覧ください

• Refresh()
• Update()

Invalidate(Boolean)

コントロールの特定の領域を無効にし、そのコントロールに描画メッセージを送信します。 オプションとして、そのコントロールに割り当てられている子コントロールも無効にします。

C#

public void Invalidate (bool invalidateChildren);

パラメーター

invalidateChildren

Boolean

コントロールの子コントロールを無効にする場合は true。それ以外の場合は false。

注釈

メソッドを Invalidate 呼び出しても、同期ペイントは強制されません。同期ペイントを強制するには、 メソッドを呼び出した後に Update メソッドを Invalidate 呼び出します。 このメソッドがパラメーターなしで呼び出されると、クライアント領域全体が更新リージョンに追加されます。

こちらもご覧ください

• Refresh()
• Update()

Invalidate()

コントロールの表面全体を無効化して、コントロールを再描画します。

C#

public void Invalidate ();

例

次のコード例では、ユーザーがイメージまたはイメージ ファイルをフォームにドラッグし、ドロップされた時点で表示できるようにします。 メソッドは OnPaint 、フォームが塗りつぶされるたびにイメージを再描画するためにオーバーライドされます。それ以外の場合、イメージは次の再描画までしか保持されません。 イベント処理メソッドは DragEnter 、フォームにドラッグされるデータの種類を決定し、適切なフィードバックを提供します。 イベント処理メソッドは DragDrop 、データから を作成できる場合 Image に、フォームにイメージを表示します。 と のDragEventArgs.X値は画面座標であるため、この例では メソッドをPointToClient使用してクライアント座標に変換DragEventArgs.Yします。

C#

private Image picture;
private Point pictureLocation;

public Form1()
{
   // Enable drag-and-drop operations and 
   // add handlers for DragEnter and DragDrop.
   this.AllowDrop = true;
   this.DragDrop += new DragEventHandler(this.Form1_DragDrop);
   this.DragEnter += new DragEventHandler(this.Form1_DragEnter);
}

protected override void OnPaint(PaintEventArgs e)
{
   // If there is an image and it has a location, 
   // paint it when the Form is repainted.
   base.OnPaint(e);
   if(this.picture != null && this.pictureLocation != Point.Empty)
   {
      e.Graphics.DrawImage(this.picture, this.pictureLocation);
   }
}

private void Form1_DragDrop(object sender, DragEventArgs e)
{
   // Handle FileDrop data.
   if(e.Data.GetDataPresent(DataFormats.FileDrop) )
   {
      // Assign the file names to a string array, in 
      // case the user has selected multiple files.
      string[] files = (string[])e.Data.GetData(DataFormats.FileDrop);
      try
      {
         // Assign the first image to the picture variable.
         this.picture = Image.FromFile(files[0]);
         // Set the picture location equal to the drop point.
         this.pictureLocation = this.PointToClient(new Point(e.X, e.Y) );
      }
      catch(Exception ex)
      {
         MessageBox.Show(ex.Message);
         return;
      }
   }

   // Handle Bitmap data.
   if(e.Data.GetDataPresent(DataFormats.Bitmap) )
   {
      try
      {
         // Create an Image and assign it to the picture variable.
         this.picture = (Image)e.Data.GetData(DataFormats.Bitmap);
         // Set the picture location equal to the drop point.
         this.pictureLocation = this.PointToClient(new Point(e.X, e.Y) );
      }
      catch(Exception ex)
      {
         MessageBox.Show(ex.Message);
         return;
      }
   }
   // Force the form to be redrawn with the image.
   this.Invalidate();
}

private void Form1_DragEnter(object sender, DragEventArgs e)
{
   // If the data is a file or a bitmap, display the copy cursor.
   if (e.Data.GetDataPresent(DataFormats.Bitmap) || 
      e.Data.GetDataPresent(DataFormats.FileDrop) ) 
   {
      e.Effect = DragDropEffects.Copy;
   }
   else
   {
      e.Effect = DragDropEffects.None;
   }
}

注釈

メソッドを Invalidate 呼び出しても、同期ペイントは強制されません。同期ペイントを強制するには、 メソッドを呼び出した後に Update メソッドを Invalidate 呼び出します。 このメソッドがパラメーターなしで呼び出されると、クライアント領域全体が更新リージョンに追加されます。

こちらもご覧ください

• Refresh()
• Update()

Invalidate(Rectangle)

コントロールの指定した領域を無効にし (そのコントロールの次の描画操作で再描画される領域を示す更新領域に追加し)、描画メッセージがそのコントロールに送信されるようにします。

C#

public void Invalidate (System.Drawing.Rectangle rc);

パラメーター

rc

Rectangle

無効化する領域を表す Rectangle。

注釈

メソッドを Invalidate 呼び出しても、同期ペイントは強制されません。同期ペイントを強制するには、 メソッドを呼び出した後に Update メソッドを Invalidate 呼び出します。 このメソッドがパラメーターなしで呼び出されると、クライアント領域全体が更新リージョンに追加されます。

こちらもご覧ください

• Refresh()
• Update()