Graphics.DrawImageAbort Delegat

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

Graphics.cs

Udostępnia metodę wywołania zwrotnego do podjęcia decyzji, kiedy DrawImage metoda powinna przedwcześnie anulować wykonywanie i zatrzymać rysowanie obrazu.

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 

Parametry

callbackdata

IntPtr

nativeint

Wewnętrzny wskaźnik określający dane metody wywołania zwrotnego. Ten parametr nie jest przekazywany przez wszystkie DrawImage przeciążenia. Możesz przetestować jego brak, sprawdzając wartość Zero.

Wartość zwracana

Boolean

Ta metoda zwraca wartość true , jeśli zdecyduje, że DrawImage metoda powinna przedwcześnie zatrzymać wykonywanie. W przeciwnym razie zwraca false wartość , aby wskazać, że DrawImage metoda powinna kontynuować wykonywanie.

Przykłady

W tym przykładzie jest uproszczona implementacja delegata Graphics.DrawImageAbort . Sprawdza tylko, czy metoda przekazała dane przy użyciu parametru DrawImage callbackdata. (Niektóre DrawImage przeciążenia mają tylko DrawImageAbort parametr i nie przekazują żadnych danych; niektóre przeciążenia mają parametry DrawImageAbort i callbackdata mogą przekazywać dane). Jeśli żadne dane nie zostały przekazane, zwraca true sygnał do metody wywołującej DrawImage , że powinien anulować rysunek. Jeśli dane zostały przekazane, zwraca false sygnał, że rysunek powinien być kontynuowany.

Realistyczna implementacja tego wywołania zwrotnego wymagałaby rzeczywistej kontroli niektórych kryteriów anulowania lub kontynuowania wykonywania.

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

Uwagi

Ta metoda jest używana w połączeniu z DrawImage metodą Graphics klasy . Niektóre przeciążenia DrawImage metody wywołuje metodę wywołania zwrotnego zdefiniowanego przez aplikację tego typu, aby dowiedzieć się, czy przeciążenia powinny zatrzymać lub kontynuować wykonywanie.

Podczas wykonywania odpowiednie DrawImage przeciążenia często wywołuje tę metodę wywołania zwrotnego, aby dowiedzieć się, czy powinny przestać rysować określony obraz lub czy powinny kontynuować rysowanie obrazu. Metoda Graphics.DrawImageAbort wywołania zwrotnego może określić, czy kontynuować, czy nie, na podstawie wybranego algorytmu dołączonego do niego, opcjonalnie przy użyciu danych przekazanych do niego przez parametr callbackdata. Na przykład algorytm może określić, czy obraz przewinął się z ekranu i zasygnalizował anulowanie metody DrawImage , aby zatrzymać rysowanie.

Deklaracja użytkownika tej metody obsługi zdarzeń musi mieć te same parametry co deklaracja delegata Graphics.DrawImageAbort .

Metody rozszerzania