Shape.SuspendPaint メソッド

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

図形の描画ロジックを中断します。

名前空間 : Microsoft.VisualBasic.PowerPacks
アセンブリ : Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)

構文

'宣言
Public Sub SuspendPaint
'使用
Dim instance As Shape

instance.SuspendPaint()

public void SuspendPaint()

public:
void SuspendPaint()

public function SuspendPaint()

解説

SuspendPaint メソッドと ResumePaint メソッドを一緒に使用して、図形の複数の属性を調整するときに、複数の Paint イベントが発生しないようにします。たとえば、通常は、SuspendPaint メソッドを呼び出してから、図形の Size、Location、BorderColor、または BorderStyle の各プロパティを設定し、さらに ResumePaint メソッドを呼び出して、これらの変更を有効にします。

例

SuspendPaint メソッドおよび ResumePaint メソッドを使用して OvalShape コントロールを操作する方法を次の例に示します。この例では、OvalShape1 という名前の OvalShape コントロールがフォームに配置されている必要があります。

Private Sub OvalShape1_Click(ByVal sender As System.Object, _
 ByVal e As System.EventArgs) Handles OvalShape1.Click
    ' Suspend painting.
    OvalShape1.SuspendPaint()
    ' Set some properties.
    OvalShape1.BackStyle = PowerPacks.BackStyle.Opaque
    OvalShape1.BackColor = Color.Blue
    OvalShape1.FillStyle = PowerPacks.FillStyle.Plaid
    OvalShape1.FillColor = Color.Red
    ' Resume painting and execute any pending requests.
    OvalShape1.ResumePaint(True)
End Sub

private void ovalShape1_Click(System.Object sender, System.EventArgs e)
{
    // Suspend painting.
    ovalShape1.SuspendPaint();
    // Set some properties.
    ovalShape1.BackStyle = BackStyle.Opaque;
    ovalShape1.BackColor = Color.Blue;
    ovalShape1.FillStyle = FillStyle.Plaid;
    ovalShape1.FillColor = Color.Red;
    // Resume painting and execute any pending requests.
    ovalShape1.ResumePaint(true);
}