Graphics.DrawImageAbort Temsilci

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v11.0.0-preview.5.26302.115

Kaynak:

Graphics.cs

Yöntemin yürütmeyi ne zaman erken iptal etmesi ve görüntü çizmeyi durdurması DrawImage gerektiğine karar vermek için bir geri çağırma yöntemi sağlar.

public: delegate bool Graphics::DrawImageAbort(IntPtr callbackdata);

public delegate bool Graphics.DrawImageAbort(IntPtr callbackdata);

type Graphics.DrawImageAbort = delegate of nativeint -> bool

Public Delegate Function Graphics.DrawImageAbort(callbackdata As IntPtr) As Boolean 

Parametreler

callbackdata

IntPtr

nativeint

Geri çağırma yöntemi için verileri belirten iç işaretçi. Bu parametre tüm DrawImage aşırı yüklemeler tarafından geçirilmedi. değerini Zerodenetleyerek devamsızlığını test edebilirsiniz.

Dönüş Değeri

Boolean

Bu yöntem, yöntemin yürütmeyi erken durdurması true gerektiğine karar verirse döndürürDrawImage. Aksi takdirde, yöntemin yürütmeye false devam etmesi gerektiğini belirtmek için döndürürDrawImage.

Örnekler

Bu örnek, temsilcinin Graphics.DrawImageAbort basit bir uygulamasıdır. Yalnızca yönteminin callbackdata parametresini DrawImage kullanarak veri geçirip geçirmediğini denetler. (Bazı DrawImage aşırı yüklemeler yalnızca bir DrawImageAbort parametreye sahiptir ve veri geçirmez; bazı aşırı yüklemeler hem hem DrawImageAbort de callbackdata parametrelerine sahiptir ve veri geçirebilir.) Hiçbir veri geçirilmediyse, çağrı true yöntemine çizimi iptal etmesi gerektiğini belirten bir sinyal döndürürDrawImage. Veriler geçirildiyse, çizimin devam etmesi gerektiğini belirten bir sinyal döndürür false .

Bu geri çağırmanın gerçekçi bir uygulaması, yürütmeyi iptal etmek veya devam etmek için bazı ölçütlerin gerçek incelemesini içerir.

Private Function DrawImageCallback(callBackData As IntPtr) As Boolean
     ' Test for call that passes callBackData parameter.
     If callBackData.Equals(IntPtr.Zero) Then
         ' If no callBackData passed, abort DrawImage method.
         Return True
     Else
         ' If callBackData passed, continue DrawImage method.
         Return False
     End If
 End Function 'DrawImageCallback

// Define DrawImageAbort callback method.
 private bool DrawImageCallback(IntPtr callbackdata)
 {
    // Test for call that passes callBackData parameter.
    if(callbackdata==IntPtr.Zero)
    {
       // If no callbackdata passed, cancel DrawImage method.
       return true;
    }
    else
    {
       // If callbackdata passed, continue DrawImage method.
       return false;
    }
 }

Açıklamalar

Bu yöntem, sınıfının yöntemiyle DrawImageGraphics birlikte kullanılır. Yönteminin DrawImage bazı aşırı yüklemeleri, aşırı yüklemelerin yürütülmesini durdurması veya devam etmesi gerekip gerekmediğini öğrenmek için bu türdeki uygulama tanımlı geri çağırma yöntemini çağırır.

Yürütme sırasında, ilgili DrawImage aşırı yüklemeler genellikle bu geri çağırma yöntemini çağırarak belirtilen görüntüyü çizmeyi durdurmaları veya görüntüyü çizmeye devam etmesi gerekip gerekmediğini öğrenmeleri gerekir. Graphics.DrawImageAbort Geri çağırma yöntemi, isteğe bağlı olarak callbackdata parametresi tarafından ona geçirilen verileri kullanarak, içinde seçilen bir algoritmaya göre devam edilip edilmeyeceğini belirleyebilir. Örneğin, bir algoritma görüntünün ekranı kaydırıp kaydırmadığını belirleyebilir ve çizimi durdurmak için yöntemine DrawImage bir iptal sinyali verebilir.

Bu olay işleme yönteminin kullanıcı bildirimi, temsilci bildirimiyle aynı parametrelere Graphics.DrawImageAbort sahip olmalıdır.