Class ImageSavingArgs
Nom dels espais: Aspose.Words.Saving Assemblea: Aspose.Words.dll (25.4.0)
Proporciona dades per a l’esdeveniment Aspose.Words.Saving.IImageSavingCallback.ImageSaving(Aspose.Words.Saving.ImageSavingArgs.
Per saber-ne més, visita el Save a Document Article de documentació.
public class ImageSavingArgsInheritance
Membres heretats
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
Per default, quan Aspose.Words emmagatzema un document en HTML, emmagatzema cada imatge en un fitxer separat. Aspose.Words utilitza el nom de fitxer del document i un nombre únic per generar un nom de fitxer únic per a cada imatge trobada en el document.
Aspose.Words.Saving.ImaginsavingArgs permet redefinir com es generen els noms de fitxers d’imatge o circumventar completament l’emmagatzematge d’imatges en arxius proporcionant els vostres propis objectes de flux.
Per aplicar la seva pròpia lògica per generar noms de fitxers d’imatge utilitzeu Aspose.Words.Saving.ImageSavingArgs.ImageFileName, Aspose.Words.Saving.ImageSavingArgs.CurrentShape i Aspose.Words.Saving.ImageSavingArgs.IsImage propietats disponibles.
Per guardar imatges en fluxos en lloc de fitxers, utilitzeu la propietat Aspose.Words.Saving.ImageSavingArgs.ImageStream.
Properties
CurrentShape
Obté l’objecte Aspose.Words.Drawing.ShapeBase corresponent a la forma o forma de grupAixò està a punt de ser salvat.
public ShapeBase CurrentShape { get; }Valor de la propietat
Remarks
Aspose.Words.Saving.IImageCallback es pot llançar mentre s’emmagatzema una forma o un format de grup. Això és el que fa que la propietat tingui un tipus de format d’espectacle. Es pot comprovar si és un model de col·lectiu comparant __ WL26.Drawing.ShapeBase. ShapeType amb __ L23.Draving .Shapes.Group o mitjançant el llançament a una de les classes derivades: __ l22.
Aspose.Words utilitza el nom de fitxer de document i un nombre únic per generar un nom de fitxer únic per a cada imatge que es troba en el document. Podeu utilitzar la propietat Aspose.Words.Saving.ImageSavingArgs.CurrentShape per generar un nom de fitxer “millor” examinant propietats de forma com Aspose.Words.Drawing.ImageData.Title (nom de forma únic), Aspose.Words.Drawing.ImageData.SourceFullName (nom de forma únic) i Aspose.Words.Drawing.ShapeBase.Name.
Per comprovar la disponibilitat de la imatge utilitzeu la propietat Aspose.Words.Saving.ImageSavingArgs.IsImageAvailable.
Document
Recull l’objecte de document que actualment s’està salvant.
public Document Document { get; }Valor de la propietat
ImageFileName
Obté o col·loca el nom del fitxer (sense ruta) on s’emmagatzemarà la imatge.
public string ImageFileName { get; set; }Valor de la propietat
Remarks
Aquesta propietat li permet redefinir com es generen els noms de fitxers d’imatge durant l’exportació a HTML.
Quan l’esdeveniment és llançat, aquesta propietat conté el nom de fitxer que va ser generat per Aspose.Words. Es pot canviar el valor d’aquesta propietat per salvar la imatge en un fitxer diferent.
Aspose.Words genera automàticament un nom de fitxer únic per a cada imatge incorporada quan s’exporta al format HTML. Com es genera el nom de fitxer d’imatge depèn de si s’emmagatzema el document a un fitxer o a un flux.
Quan s’emmagatzema un document en un fitxer, el nom de fitxer d’imatge generat sembla .
Quan s’emmagatzema un document en un flux, el nom de fitxer d’imatge generat sembla .
Aspose.Words.Saving.ImaginsavingArgs.ImageFileName ha de contenir només el nom de fitxer sense la ruta. __ WL27__ determina el camí per salvar i el valor de l’atribute per escriure a HTML utilitzant el nombre de document, el _wl26.HtmlSaveOptions. ImagesFolder i wL22-Saver.
Aspose.Words.Saving.ImageSavingArgs.CurrentShape Aspose.Words.Saving.ImageSavingArgs.IsImageAvailable Aspose.Words.Saving.ImageSavingArgs.ImageStream Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder Aspose.Words.Saving.HtmlSaveOptions.ImagesFolderAlias
ImageStream
Permet especificar el flux en què s’emmagatzemarà la imatge.
public Stream ImageStream { get; set; }Valor de la propietat
Remarks
Aquesta propietat li permet guardar imatges a fluxos en lloc de fitxers durant HTML.
Quan aquesta propietat és , l’imatge es salvarà a un fitxer especificat en la propietat Aspose.Words.Saving.ImageSavingArgs.ImageFileName.
Utilitzant Aspose.Words.Saving.IImageSavingCallback no es pot substituir una imatge per una altra.
Aspose.Words.Saving.ImageSavingArgs.ImageFileName Aspose.Words.Saving.ImageSavingArgs.KeepImageStreamOpen
IsImageAvailable
Retorna ’true’ si la imatge actual està disponible per a l’exportaci.
public bool IsImageAvailable { get; }Valor de la propietat
Remarks
Algunes imatges en el document poden ser inaccessibles, per exemple, perquè la imatge és enllaçada i el enllaç és inaccessible o no indica una imatge vàlida. en aquest cas Aspose.Words exporta una icona amb una creu vermella. Aquesta propietat torna si la imatge original és disponible; torna si la imatge original no és disponible i s’ofereix una icona “no imatge” per salvar.
Quan es salva una forma de grup o una forma que no requereix cap imatge aquesta propietat és sempre .
Veure també
ImageSavingArgs . CurrentShape
KeepImageStreamOpen
Especifica si Aspose.Words ha de mantenir el flux obert o tancat després de salvar una imatge.
public bool KeepImageStreamOpen { get; set; }Valor de la propietat
Remarks
Default és i Aspose.Words tancarà el flux que proporcioneu a la propietat Aspose.Words.Saving.ImageSavingArgs.ImageStream després d’escriure una imatge en ella.
Aspose.Words.Saving.ImageSavingArgs.ImageStream
