Bezeichnung
ccontext:CopyPath -- Kopiert einen Pfad
Übersicht
handle = ccontext:CopyPath()
Beschreibung
Erstellt eine Kopie des aktuellen Pfads und gibt sie als Cairo-Pfadobjekt an den Benutzer zurück. Verwenden Sie cpath:Get(), um die einzelnen Pfadelemente abzurufen.

Diese Funktion gibt immer ein gültiges Handle zurück, das Ergebnis enthält jedoch keine Daten, wenn eine der folgenden Bedingungen zutrifft:

  1. Wenn nicht genügend Speicher zum Kopieren des Pfads vorhanden ist. In diesem Fall wird der Pfadstatus auf #CAIRO_STATUS_NO_MEMORY gesetzt.

  2. Wenn sich der Cairo-Kontext bereits in einem Fehlerzustand befindet. In diesem Fall enthält der Pfadstatus denselben Status, der von ccontext:Status() zurückgegeben würde.

Diese Funktion gibt die Kopie des aktuellen Pfads zurück. Der Aufrufer hat das zurückgegebenen Objekt zugewiesen und sollte cpath:Free() aufrufen, wenn er damit fertig ist.

Eingaben
Keine

Rückgabewerte
handle
die Kopie des aktuellen Pfades

Navigation zeigen