PictureBox.WaitOnLoad プロパティ

定義

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

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

プロパティ値

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

次のコード例では、 プロパティの使用方法を WaitOnLoad 示します。 この例を実行するには、次のコードを、名前付き と という名前startLoadButtonpictureBox1PictureBox を含む 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

注釈

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

適用対象