Graphics.DrawImageAbort Delegát

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v8.0.0

Zdroj:

Graphics.cs

Poskytuje metodu zpětného volání pro rozhodnutí, kdy DrawImage by metoda měla předčasně zrušit provádění a zastavit kreslení obrázku.

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

Interní ukazatel, který určuje data pro metodu zpětného volání. Tento parametr není předán všemi DrawImage přetíženími. Jeho nepřítomnost můžete otestovat tak, že zkontrolujete hodnotu Zero.

Návratová hodnota

Boolean

Tato metoda vrátí true hodnotu, pokud se rozhodne, že DrawImage by metoda měla předčasně zastavit provádění. V opačném případě se vrátí false a značí DrawImage , že by metoda měla pokračovat v provádění.

Příklady

Tento příklad je zjednodušená implementace delegáta Graphics.DrawImageAbort . Pouze zkontroluje, jestli DrawImage jí metoda předala data pomocí parametru callbackdata. (Některá DrawImage přetížení mají pouze DrawImageAbort parametr a nepředávají žádná data; některá přetížení mají parametry i DrawImageAbort a callbackdata můžou předávat data.) Pokud nebyla předána žádná data, vrátí true se k signálu volající DrawImage metodě, že by měla výkres zrušit. Pokud byla data předána, vrátí false se signál, že by výkres měl pokračovat.

Realistická implementace tohoto zpětného volání by zahrnovala skutečné prozkoumání některých kritérií pro zrušení nebo pokračování provádění.

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

Poznámky

Tato metoda se používá ve spojení s DrawImage metodou Graphics třídy . Určitá přetížení DrawImage metody volají metodu zpětného volání definované aplikací tohoto typu ke zjištění, zda by přetížení mělo zastavit nebo pokračovat v provádění.

Během provádění příslušné DrawImage přetížení často volají tuto metodu zpětného volání, aby zjistili, zda by měly zastavit kreslení zadaného obrázku, nebo zda by měly pokračovat ve kreslení obrázku. Metoda Graphics.DrawImageAbort zpětného volání může určit, zda pokračovat nebo ne na základě zvoleného algoritmu, který je součástí, volitelně pomocí dat předaných do ní parametrem callbackdata. Algoritmus může například určit, jestli se obrázek posune mimo obrazovku, a signalizovat zrušení DrawImage metody pro zastavení kreslení.

Deklarace uživatele této metody zpracování událostí musí mít stejné parametry jako deklarace delegáta Graphics.DrawImageAbort .

Metody rozšíření