Image

Ajouter une image

func (f *File) AddPicture(sheet, cell, picture string, opts *GraphicOptions) error

AddPicture permet d'ajouter une image à une feuille de calcul selon un format d'image défini (décalage, échelle, rapport hauteur/largeur et paramètres d'impression) et un chemin d'accès au fichier. Les types d'image pris en charge sont: BMP, EMF, EMZ, GIF, ICO, JPEG, JPG, PNG, SVG, TIF, TIFF, WMF et WMZ. Cette fonction est compatible avec les accès simultanés. Notez qu'elle ne prend en charge que l'ajout d'images placées sur les cellules actuelles, et non l'ajout d'images placées dans les cellules, ni la création de cellules d'image intégrées à Kingsoft WPS Office.

Par exemple:

package main

import (
    "fmt"
    _ "image/gif"
    _ "image/jpeg"
    _ "image/png"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // Ajouter une image.
    if err := f.AddPicture("Sheet1", "A2", "image.png", nil); err != nil {
        fmt.Println(err)
        return
    }
    // Insérer une mise à l'échelle de l'image dans la cellule avec un lien hypertexte.
    enable, disable := true, false
    if err := f.AddPicture("Sheet1", "D2", "image.jpg",
        &excelize.GraphicOptions{
            ScaleX:        0.5,
            ScaleY:        0.5,
            Hyperlink:     "#Sheet2!D8",
            HyperlinkType: "Location",
        },
    ); err != nil {
        fmt.Println(err)
        return
    }
    // Insérer un décalage d'image dans la cellule avec un lien hypertexte externe, un support d'impression et de positionnement.
    if err := f.AddPicture("Sheet1", "H2", "image.gif",
        &excelize.GraphicOptions{
            OffsetX:         15,
            OffsetY:         10,
            Hyperlink:       "https://github.com/xuri/excelize",
            HyperlinkType:   "External",
            PrintObject:     &enable,
            LockAspectRatio: false,
            Locked:          &disable,
            Positioning:     "oneCell",
        },
    ); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

Le paramètre optionnel AltText est utilisé pour ajouter un texte alternatif à un objet graphique.

Le paramètre facultatif PrintObject indique si l'image est imprimée lors de l'impression de la feuille de calcul, la valeur par défaut est true.

Le paramètre optionnel Locked indique si verrouiller l'image. Le verrouillage d'un objet n'a d'effet que si la feuille est protégée.

Le paramètre optionnel LockAspectRatio indique si verrouiller le rapport hauteur/largeur de l'image, la valeur par défaut de celui-ci est false.

Le paramètre facultatif AutoFit spécifie si make image size auto s'adapte à la cellule, la valeur par défaut est false.

Le paramètre facultatif OffsetX spécifie le décalage horizontal de l'image avec la cellule, la valeur par défaut est 0.

Le paramètre facultatif OffsetY spécifie le décalage vertical de l'image avec la cellule, la valeur par défaut est 0.

Le paramètre optionnel ScaleX spécifie l'échelle horizontale du graphique. Sa valeur doit être un nombre à virgule flottante supérieur à 0, avec une précision de deux décimales. La valeur par défaut est 1.0, ce qui correspond à 100%.

Le paramètre optionnel ScaleY spécifie l'échelle verticale du graphique. Sa valeur doit être un nombre à virgule flottante supérieur à 0, avec une précision de deux décimales. La valeur par défaut est 1.0, ce qui correspond à 100%.

Le paramètre facultatif Hyperlink spécifie le lien hypertexte de l'image.

Le paramètre facultatif HyperlinkType définit deux types de lien hypertexte External pour le site Web ou Location pour se déplacer vers l'une des cellules de ce classeur. Lorsque le HyperlinkType est Location, les coordonnées doivent commencer par #.

Le paramètre optionnel Positioning définit 3 types de position d'un objet graphique dans une feuille de calcul: oneCell (déplacer mais ne pas redimensionner avec les cellules), twoCell (déplacer et redimensionner avec les cellules) et absolute (Ne pas déplacer ou dimensionner avec les cellules). Si vous ne définissez pas ce paramètre, le positionnement par défaut consiste à déplacer et dimensionner avec les cellules.

func (f *File) AddPictureFromBytes(sheet, cell string, pic *Picture) error

AddPictureFromBytes fournit la méthode pour ajouter une image dans une feuille selon le format d'image défini (décalage, échelle, paramètres de format et paramètres d'impression), la description textuelle, le nom de l'extension et le contenu du fichier dans le type []byte. Types d'images pris en charge: EMF, EMZ, GIF, ICO, JPEG, JPG, PNG, SVG, TIF, TIFF, WMF et WMZ. Veuillez noter que cette fonction ne prend en charge que l'ajout d'images placées sur les cellules actuelles, et non l'ajout d'images placées dans les cellules, ni la création de cellules d'images intégrées Kingsoft WPS Office.

Par exemple:

package main

import (
    "fmt"
    _ "image/jpeg"
    "os"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    file, err := os.ReadFile("image.jpg")
    if err != nil {
        fmt.Println(err)
        return
    }
    if err := f.AddPictureFromBytes("Sheet1", "A2", &excelize.Picture{
        Extension: ".jpg",
        File:      file,
        Format:    &excelize.GraphicOptions{AltText: "Excel Logo"},
    }); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

Obtenir une image

func (f *File) GetPictures(sheet, cell string) ([]Picture, error)

GetPicture fournit une fonction permettant d'incorporer le nom de la base de l'image et le contenu brut dans XLSX en fonction de la feuille de calcul et du nom de la cellule. Cette fonction est sécurisée pour la concurrence. Cette fonction renvoie le nom du fichier dans XLSX et le contenu des fichiers sous la forme de types de données []byte. Notez que cette fonction ne prend actuellement pas en charge la récupération de toutes les propriétés de la propriété Format de l'image, et que la valeur des propriétés ScaleX et ScaleY est un nombre à virgule flottante supérieur à 0 avec une précision de deux décimales.

Par exemple:

f, err := excelize.OpenFile("Book1.xlsx")
if err != nil {
    fmt.Println(err)
    return
}
defer func() {
    if err := f.Close(); err != nil {
        fmt.Println(err)
    }
}()
pics, err := f.GetPictures("Sheet1", "A2")
if err != nil {
    fmt.Println(err)
}
for idx, pic := range pics {
    name := fmt.Sprintf("image%d%s", idx+1, pic.Extension)
    if err := os.WriteFile(name, pic.File, 0644); err != nil {
        fmt.Println(err)
    }
}

Supprimer l'image

func (f *File) DeletePicture(sheet, cell string) error

DeletePicture fournit une fonction pour supprimer des graphiques dans XLSX par feuille de calcul et nom de cellule donnés. Notez que le fichier image ne sera pas supprimé du document actuellement.