Class ImageSavingArgs

Class ImageSavingArgs

Nome do espaço: Aspose.Words.Saving Assembleia: Aspose.Words.dll (25.4.0)

Fornece dados para o evento Aspose.Words.Saving.IImageSavingCallback.ImageSaving(Aspose.Words.Saving.ImageSavingArgs).

Para saber mais, visite o Save a Document Artigo de Documentação.

public class ImageSavingArgs

Inheritance

object ImageSavingArgs

Membros herdados

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Remarks

Por padrão, quando Aspose.Words salva um documento para HTML, ele salva cada imagem em um arquivo separado. Aspose.Words usa o nome do arquivo do documento e um número único para gerar um nome de arquivo único para cada imagem encontrada no documento.

Aspose.Words.Saving.ImageSachingArgs permite redefinir como os nomes de arquivo de imagem são gerados ou para circular completamente a salvação de imagens em arquivos, fornecendo seus próprios objetos de fluxo.

Para aplicar a sua própria lógica para gerar nomes de arquivo de imagem, use os Aspose.Words.Saving.ImageSavingArgs.ImageFileName, Aspose.Words.Saving.ImageSavingArgs.CurrentShape e Aspose.Words.Saving.ImageSavingArgs.IsImageAs propriedades disponíveis.

Para salvar imagens em fluxos em vez de arquivos, use a propriedade Aspose.Words.Saving.ImageSavingArgs.ImageStream.

Properties

CurrentShape

Obtenha o Objeto Aspose.Words.Drawing.ShapeBase correspondente à forma ou forma de grupoIsso está a ser salvo.

public ShapeBase CurrentShape { get; }

Valor da propriedade

ShapeBase

Remarks

É por isso que a propriedade tem Aspose.Words.Drawing.ShapeBase tipo.Você pode verificar se é uma forma de grupo comparando www.wl26_.shape -base. ShapeType com wwl26.shap.type.group ou jogando-o em uma das classes derivadas: wll26_.

Aspose.Words usa o nome do arquivo do documento e um número único para gerar um nome de arquivo único para cada imagem encontrada no documento. Você pode usar a propriedade Aspose.Words.Saving.ImageSavingArgs.CurrentShape para gerar um nome de arquivo “melhor” examinando propriedades de forma como Aspose.Words.Drawing.ImageData.Title (só forma), Aspose.Words.Drawing.ImageData.SourceFullName (só forma) e Aspose.Words.Drawing.ShapeBase.Name.

Para verificar a disponibilidade da imagem, use a propriedade Aspose.Words.Saving.ImageSavingArgs.IsImageAvailable.

Document

Obtenha o objeto do documento que está atualmente sendo salvo.

public Document Document { get; }

Valor da propriedade

Document

ImageFileName

Recebe ou coloca o nome do arquivo (sem caminho) para onde a imagem será salvida.

public string ImageFileName { get; set; }

Valor da propriedade

string

Remarks

Esta propriedade permite redefinir como os nomes de arquivo de imagem são gerados durante a exportação para o HTML.

Quando o evento é lançado, esta propriedade contém o nome do arquivo que foi gerado por Aspose.Words. Você pode alterar o valor desta propriedade para salvar a imagem em um arquivo diferente.

Aspose.Words gera automaticamente um nome de arquivo único para cada imagem incorporada quando exportado para o formato HTML. Como o nome de arquivo de imagem é gerado depende de se você salvar o documento para um arquivo ou para um fluxo.

Ao salvar um documento para um arquivo, o nome do arquivo de imagem gerado parece .

Ao salvar um documento para um fluxo, o nome do arquivo de imagem gerado parece .

Aspose.Words.Saving.ImaginsavingArgs.ImageFileName deve conter apenas o nome do arquivo sem a estrada. __ WL27__ determina o caminho para salvar e o valor do atributo para escrever para HTML usando o documento nome de arquivos, o wl26.HtmlSaveOptions.imagesFolder e __ wl27 .Swing.htmlSaverOpções.

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

Permite especificar o fluxo para onde a imagem será salvida.

public Stream ImageStream { get; set; }

Valor da propriedade

Stream

Remarks

Esta propriedade permite que você salve imagens para fluxos em vez de arquivos durante o HTML.

Quando esta propriedade é , a imagem será salvo para um arquivo especificado na propriedade Aspose.Words.Saving.ImageSavingArgs.ImageFileName.

Usando Aspose.Words.Saving.IImageSavingCallback você não pode substituir uma imagem por outra.

Aspose.Words.Saving.ImageSavingArgs.ImageFileName Aspose.Words.Saving.ImageSavingArgs.KeepImageStreamOpen

IsImageAvailable

Retorna “verdadeiro” se a imagem atual estiver disponível para exportação.

public bool IsImageAvailable { get; }

Valor da propriedade

bool

Remarks

Algumas imagens no documento podem não estar disponíveis, por exemplo, porque a imagem está ligada e o link é inacessível ou não indica uma imagem válida. neste caso, Aspose.Words exporta um ícone com uma cruz vermelha. Esta propriedade retorna se a imagem original está disponível; retorna se a imagem original não está disponível e um ícone “não imagem” será oferecido para salvar.

Quando salvar uma forma de grupo ou uma forma que não requer qualquer imagem esta propriedade é sempre .

Veja também

ImageSavingArgs . CurrentShape

KeepImageStreamOpen

Determina se Aspose.Words deve manter o fluxo aberto ou fechado depois de salvar uma imagem.

public bool KeepImageStreamOpen { get; set; }

Valor da propriedade

bool

Remarks

Default é e Aspose.Words irá fechar o fluxo que você fornece na propriedade Aspose.Words.Saving.ImageSavingArgs.ImageStream depois de escrever uma imagem nele.

Avaliação.Saving.ImageSavingArgs.ImageStream

 Português