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 示します。 この例を実行するには、次のコードを、名前付き と という名前startLoadButtonpictureBox1の PictureBox を含む Windows フォームに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 設定すると、イメージが同期的に読み込まれます。 これにより、イメージが読み込まれるまで、ユーザー インターフェイスが他の入力からブロックされます。 WaitOnLoadが false (既定値) で、 メソッドをLoadAsync使用してイメージを読み込むと、InitialImage指定したイメージが読み込まれるときにイメージが表示され、ユーザーは読み込みプロセス中にインターフェイスを操作できます。