PictureBox.WaitOnLoad プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

イメージが同期的に読み込まれるかどうかを示す値を取得または設定します。

public:
 property bool WaitOnLoad { bool get(); void set(bool value); };

public bool WaitOnLoad { get; set; }

member this.WaitOnLoad : bool with get, set

Public Property WaitOnLoad As Boolean

プロパティ値

Boolean

イメージの読み込み処理が同期的に完了した場合は true。それ以外の場合は false。 既定値は、false です。

例

次のコード例は、このプロパティの使用方法を WaitOnLoad 示しています。 この例を実行するには、次のコードを、名前付きフォームと名前startLoadButton付きpictureBox1フォームを含むPictureBoxWindows フォームにButton貼り付けます。 ボタンの Click イベントがこの例のメソッドに startLoadButton_Click 関連付けられていることを確認します。 イメージ ファイルのパスは、システムで有効なパスに変更する必要があります。

private void startButton_Click(object sender, EventArgs e)
{
    // Ensure WaitOnLoad is false.
    pictureBox1.WaitOnLoad = false;

    // Load the image asynchronously.
    pictureBox1.LoadAsync(@"http://localhost/print.gif");
}

Private Sub startLoadButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles startLoadButton.Click

    ' Ensure WaitOnLoad is false.
    pictureBox1.WaitOnLoad = False

    ' Load the image asynchronously.
    pictureBox1.LoadAsync("http://localhost/print.gif")

End Sub

注釈

イメージが WaitOnLoad 同期的に true 読み込まれるようプロパティを設定します。 これにより、イメージが読み込まれるまで、ユーザー インターフェイスが他の入力からブロックされます。 (既定値) のfalse場合WaitOnLoad、メソッドをLoadAsync使用してイメージを読み込むと、InitialImage指定したイメージが読み込まれるときにイメージが表示され、読み込みプロセス中にユーザーがインターフェイスと対話できます。