Bildarbeitsmappe einfügen

Eigenschaften und Konfiguration für die Aktivität Insert Image Workbook, die ein Bild in eine Excel-Arbeitsmappe an einem angegebenen Zellanker mit optionalem Pixel-Offset und Skalierung einfügt.

UiPath.Excel.Activities.InsertImage

Beschreibung

Fügt ein Bild in ein Arbeitsmappenblatt ein, das an einer Zelle verankert ist. Die obere linke Ecke des Bilds wird in der Ankerzelle platziert, verschoben um die Werte, die Sie in Bild links und Bild oben festgelegt haben.

Hinweis:

Das einzige unterstützte Arbeitsmappenformat ist .xlsx.

Die folgenden Bildformate werden unterstützt:

• PNG
• JPEG
• GIF
• BMP
• TIFF
• WebP
• PCX

Projektkompatibilität

Windows | Plattformübergreifend

Konfiguration

• Datei – Der vollständige Pfad der Ressourcenarbeitsmappe. Um zu einem lokalen Pfad zu wechseln, wählen Sie das Plus-Symbol und dann Lokale Datei verwenden aus. Das aktuelle Feld ändert sich zu Datei (lokaler Pfad), wo Sie den vollständigen Pfad der Arbeitsmappe angeben können.
• Bilddatei – Die Ressourcendatei des einzufügenden Bilds. Um zu einem lokalen Pfad zu wechseln, wählen Sie das Plus-Symbol und dann Lokale Datei verwenden aus. Das aktuelle Feld ändert sich zu Bild (lokaler Pfad), wo Sie den vollständigen Pfad des Bilds angeben können.
• Blattname – Das Blatt, in das das Bild eingefügt werden soll. Wenn das Blatt nicht vorhanden ist, wird es automatisch erstellt. Der Standardwert ist Sheet1.
• Zelle – Die Ankerzelle für die linke obere Ecke des Bilds. Der Standardwert ist A1.

Verwenden der Arbeitsmappe

• Arbeitsmappe – Die vorhandene zu verwendende Arbeitsmappe.

Eingabe

• Bild links – Der horizontale Offset von der Ankerzelle in Pixel. Der Wert muss 0 oder größer sein. Der Standardwert ist 0.
• Bild oben – Der vertikale Offset von der Ankerzelle in Pixeln. Der Wert muss 0 oder größer sein. Der Standardwert ist 0.
• Bildbreite – Die Breite des Bilds in Pixeln. Der Wert muss 0 oder größer sein.
• Bildhöhe – Die Höhe des Bilds in Pixel. Der Wert muss 0 oder größer sein.

Die Werte Bildbreite und Bildhöhe bestimmen, wie das Bild skaliert wird:

Bildbreite	Bildhöhe	Ergebnis
Nicht festgelegt	Nicht festgelegt	Das Bild behält seine ursprünglichen Abmessungen bei.
Set (Satz)	Nicht festgelegt	Die Höhe skaliert proprietär, wobei das Seitenverhältnis erhalten bleibt.
Nicht festgelegt	Set (Satz)	Die Breite skaliert proprietär, wobei das Seitenverhältnis erhalten bleibt.
Set (Satz)	Set (Satz)	Das Bild verwendet die genauen von Ihnen festgelegten Abmessungen. Das Seitenverhältnis wird nicht beibehalten.

Hinweis:

Das Bild ist in der Zelle verankert, die Sie in Cell angeben, wodurch Ihre Position eingeschränkt ist:

• Bild links und Bild oben sind auf die Breite und Höhe der Ankerzelle begrenzt, sodass ein Offset, der größer als die Zelle ist, das Bild stattdessen am Rand der Zelle platziert.
• Wenn Sie die Größe der Ankerzelle ändern, wird das Bild mit verschoben, behält aber seine eigenen Abmessungen bei.

Die Aktivität unterstützt weder das Ankern eines Bilds zwischen zwei Zellen noch das Platzieren eines Bilds an einer festen Position, die unabhängig von einer Zelle ist.

Optionen

• Kennwort – Das Kennwort der Arbeitsmappe, falls erforderlich