Methoden der GraphicAccess4-Schnittstelle

Methode ImportGraphics

Importiert Grafiken aus vorhandenen XML-Dateien in einem Ordner. Galaxy, Ordnerpfad, die Einstellung zum Überschreiben (ja/nein), der Fortschritt des Vorgangs sowie ein Token, das angibt, ob die Operation abgebrochen wird, werden als Parameter an die Funktion ImportGraphics übergeben.

Syntax

Task<IGraphicAccessResult> ImportGraphics(IGalaxy galaxy, string strFolderPath, bool bOverWrite, IGraphicOperationStatus opNotifier = null, CancellationToken cancelToken = default);

Parameter

galaxy

Verweist auf eine Galaxy, in die Grafiken importiert werden oder in der die API ausgeführt wird.

strFolderPath

Ordnerpfad zu den XML-Dateien.

bOverWrite

Boolescher Parameter; legt fest, ob ein ggf. vorhandenes gleichnamiges Symbol überschrieben werden soll

opNotifier

Liefert den Status des Importvorgangs an die aufrufende Funktion (Client) zurück

cancelToken

Die aufrufende Funktion (Client) kann dieses Token setzen, um den Vorgang „Grafik importieren“ abzubrechen. Weitere Informationen zu „CancellationToken“ finden Sie in der MSDN-Hilfe.

Nach dem Importieren wird das Ergebnis auf Task<IGraphicAccessResult> gesetzt, das von „ICommandResult“ abgeleitet ist. Daraufhin erscheint eine Erfolgs- oder Fehlermeldung. Ausführliche Informationen zur ICommandResult-Schnittstelle finden Sie in GRAccess Toolkit API Help.

Eine Erfolgsmeldung besagt nur, dass der Importvorgang erfolgreich abgeschlossen ist. Sie sagt nichts über die Qualität der exportierten XML-Datei oder des importierten Symbols aus. Suchen Sie daher nach jedem Import im SMC Log Viewer nach Warnungen oder Fehlermeldungen.