Class ImageSavingArgs
Nazwa przestrzeń: Aspose.Words.Saving Zgromadzenie: Aspose.Words.dll (25.4.0)
Zapewnia dane na temat wydarzenia Aspose.Words.Saving.IImageSavingCallback.ImageSaving(Aspose.Words.Saving.ImageSavingArgs).
Aby dowiedzieć się więcej, odwiedź Save a Document Artykuł dokumentacyjny .
public class ImageSavingArgsInheritance
Dziedziczeni członkowie
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
Podstawowo, gdy Aspose.Words przechowuje dokument do HTML, przechowuje każdy obraz do odrębnego pliku. Aspose.Words używa nazwy pliku dokumentu i unikalnego numeru do generowania unikalnego nazwy pliku dla każdego obrazu znajdującego się w dokumencie.
Aspose.Words.Saving.ImageSachingArgs umożliwia ponowne zdefiniowanie sposobu generowania nazw plików obrazu lub całkowicie obejmować oszczędzanie obrazów w plikach poprzez dostarczanie własnych obiektów strumieniowych.
Aby zastosować własną logikę do generowania nazw plików obrazu użyj Aspose.Words.Saving.ImageSavingArgs.ImageFileName, Aspose.Words.Saving.ImageSavingArgs.CurrentShape i Aspose.Words.Saving.ImageSavingArgs.IsImageDostępne właściwości.
Aby zapisać obrazy w strumieniach zamiast plików, użyj właściwości Aspose.Words.Saving.ImageSavingArgs.ImageStream.
Properties
CurrentShape
Otrzymuje obiekt Aspose.Words.Drawing.ShapeBase odpowiadający kształtu lub kształtu grupyTo jest gotowe do zbawienia.
public ShapeBase CurrentShape { get; }Wartość nieruchomości
Remarks
Aspose.Words.Saving.IImageCallback może zostać usunięty podczas przechowywania kształtu lub formy grupowej. To jest powód, dla którego nieruchomość ma typ Wl26.Drawing.ShapeBase. Możesz sprawdzić, czy jest to kształt grupowy porównywalny _ www.wl26.draw.shape.thape Type z __wL27.dry.type.group lub przez wyrzucanie go do jednej z klas pochodnych: _wll22.drow.
Aspose.Words używa nazwy pliku dokumentu i unikalnego numeru do generowania unikalnego nazwy pliku dla każdego obrazu znajdującego się w dokumencie.Możesz użyć właściwości Aspose.Words.Saving.ImageSavingArgs.CurrentShape do generowania “najlepszego” nazwy pliku poprzez zbadanie właściwości kształtu, takich jak Aspose.Words.Drawing.ImageData.Title (tylko kształt), Aspose.Words.Drawing.ImageData.SourceFullName (tylko kształt) i Aspose.Words.Drawing.ShapeBase.Name.
Niektóre obrazy w dokumencie mogą być niedostępne. Aby sprawdzić dostępność obrazu, użyj Aspose.Words.Saving.ImageSavingArgs.IsImageDostępna nieruchomość.
Document
Otrzymuje obiekt dokumentu, który jest obecnie zapisywany.
public Document Document { get; }Wartość nieruchomości
ImageFileName
Otrzymuje lub ustawia nazwę pliku (bez ścieżki), do której zostanie zapisany obraz.
public string ImageFileName { get; set; }Wartość nieruchomości
Remarks
Ta właściwość pozwala ponownie zdefiniować, w jaki sposób nazwy plików obrazu są generowane podczas eksportu do HTML.
Gdy wydarzenie zostanie usunięte, ta właściwość zawiera nazwę pliku, która została generowana przez Aspose.Words. Możesz zmienić wartość tej właściwości, aby zapisać obraz w inny plik.
Aspose.Words automatycznie generuje unikalną nazwę pliku dla każdego wbudowanego obrazu przy eksportowaniu do formatu HTML. Sposób generowania nazwy pliku obrazu zależy od tego, czy zapisujesz dokument do pliku, czy do strumienia.
Podczas przechowywania dokumentu do pliku, nazwa pliku obrazu generowanego wygląda jak .
Podczas przechowywania dokumentu do strumienia, nazwa pliku obrazu generowanego wygląda jak .
Aspose.Words.Saving.ImageSaveArgs.ImagicFileName musi zawierać tylko nazwę pliku bez ścieżki. Wl26 określa drogę do przechowywania i wartość atrybutu do pisania do HTML za pomocą nazwy plików dokumentów, __ WL27_.HtmlSavOptions.
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
Pozwala określić strumień, do którego zostanie zapisany obraz.
public Stream ImageStream { get; set; }Wartość nieruchomości
Remarks
Ta właściwość pozwala zapisać obrazy do strumieni zamiast plików w czasie HTML.
Wartość domyślna jest . Kiedy ta właściwość jest , obraz zostanie zapisany do pliku określonego w Aspose.Words.Saving.ImageSavingArgs.ImageFileName właściwość.
Za pomocą Aspose.Words.Saving.IImageSavingCallback nie można zastąpić jednego obrazu innym.
Aspose.Words.Saving.ImageSavingArgs.ImageFileName Aspose.Words.Saving.ImageSavingArgs.KeepImageStreamOpen
IsImageAvailable
Zwraca się “prawdziwy”, jeśli aktualny obraz jest dostępny do eksportu.
public bool IsImageAvailable { get; }Wartość nieruchomości
Remarks
Niektóre obrazy w dokumencie mogą być niedostępne, na przykład, ponieważ obraz jest połączony, a link jest niedostępny lub nie wskazuje na ważny obraz. W tym przypadku Aspose.Words eksportuje ikonę z czerwonym krzyżem.
Podczas przechowywania kształtu grupowego lub kształtu, który nie wymaga żadnego obrazu, to właściwość jest zawsze .
Zobacz również
ImageSavingArgs . CurrentShape
KeepImageStreamOpen
Określa, czy Aspose.Words powinien zachować strumień otwarty lub zamknięty po zapisaniu obrazu.
public bool KeepImageStreamOpen { get; set; }Wartość nieruchomości
Remarks
Podstawowe jest i Aspose.Words zamknie strumień dostarczony w Aspose.Words.Saving.ImageSavingArgs.ImageStream właściwości po napisaniu obrazu w nim.
Aspose.Words.Saving.ImageSavingArgs.ImageStream
