Graphics.DrawImageAbort Delegasikan

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Sumber:

Graphics.cs

Menyediakan metode panggilan balik untuk memutuskan kapan DrawImage metode harus membatalkan eksekusi sebelum waktunya dan berhenti menggambar gambar.

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 

Parameter

callbackdata

IntPtr

nativeint

Penunjuk internal yang menentukan data untuk metode panggilan balik. Parameter ini tidak diteruskan oleh semua DrawImage kelebihan beban. Anda dapat menguji ketidakhadirannya dengan memeriksa nilai Zero.

Tampilkan Nilai

Boolean

Metode ini mengembalikan true jika memutuskan bahwa DrawImage metode harus secara prematur menghentikan eksekusi. Jika tidak, ia kembali false untuk menunjukkan bahwa DrawImage metode harus melanjutkan eksekusi.

Contoh

Contoh ini adalah implementasi delegasi yang Graphics.DrawImageAbort sederhana. Ini hanya memeriksa untuk melihat apakah DrawImage metode telah meneruskannya data menggunakan parameter callbackdata. (Beberapa DrawImage kelebihan beban hanya memiliki DrawImageAbort parameter dan tidak meneruskan data; beberapa kelebihan beban memiliki DrawImageAbort parameter dan callbackdata dan dapat meneruskan data.) Jika tidak ada data yang diteruskan, data kembali true ke sinyal ke metode pemanggilan DrawImage bahwa itu harus membatalkan gambar. Jika data diteruskan, data akan kembali false ke sinyal bahwa gambar harus dilanjutkan.

Implementasi realistis dari panggilan balik ini akan melibatkan pengawasan aktual dari beberapa kriteria untuk membatalkan atau melanjutkan eksekusi.

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;  
    }  
 }  

Keterangan

Metode ini digunakan bersama dengan DrawImage metode Graphics kelas . Kelebihan metode DrawImage tertentu memanggil metode panggilan balik yang ditentukan aplikasi dari jenis ini untuk mengetahui apakah kelebihan beban harus berhenti atau melanjutkan eksekusi.

Selama eksekusi, kelebihan beban yang relevan DrawImage sering memanggil metode panggilan balik ini untuk mengetahui apakah mereka harus berhenti menggambar gambar yang ditentukan atau apakah mereka harus terus menggambar gambar. Metode Graphics.DrawImageAbort panggilan balik dapat menentukan apakah akan melanjutkan atau tidak berdasarkan algoritma yang dipilih yang disertakan di dalamnya, secara opsional menggunakan data yang diteruskan ke dalamnya oleh parameter callbackdata. Misalnya, algoritma mungkin menentukan apakah gambar telah digulir dari layar dan memberi sinyal pembatalan ke DrawImage metode untuk berhenti menggambar.

Deklarasi pengguna dari metode penanganan peristiwa ini harus memiliki parameter yang sama dengan Graphics.DrawImageAbort deklarasi delegasi.

Metode Ekstensi