Page
Przegląd
Page jest klasą w Aspose.PDF FOSS dla .NET. Dziedziczy po: IDisposable.
Reprezentuje stronę w dokumencie PDF.
Ta klasa udostępnia 58 metod do pracy z obiektami Page w programach .NET. Dostępne metody to: Accept, AddContent, AddContentStream, AddExtGState, AddFloatingBox, AddGraph, AddGraphics, AddImage, AddStamp, AddTable, AsByteArray, AsXml oraz 28 dodatkowych metod. Wszystkie publiczne elementy są dostępne dla dowolnej aplikacji .NET po zainstalowaniu pakietu Aspose.PDF FOSS dla .NET. Właściwości: Actions, Annotations, ArtBox, Artifacts, Background, BackgroundImage oraz 35 kolejnych.
Właściwości
| Nazwa | Typ | Dostęp | Opis |
|---|---|---|---|
Number | int | Odczyt | Numer strony zaczynający się od 1. |
FieldsInTabOrder | IList<Forms.Field> | Odczyt | Pola formularza, których widżety pojawiają się na tej stronie, uporządkowane według kolejności tabulacji. |
Rect | Rectangle | Odczyt/zapis | Prostokąt strony (domyślnie MediaBox). |
Rectangle | Rectangle | Odczyt/zapis | Prostokąt strony. |
PageInfo | PageInfo | Odczyt/zapis | Kontener informacji o stronie z właściwościami szerokość/wysokość/margines. |
Background | Color? | Odczyt/zapis | Kolor tła strony. |
MediaBox | Rectangle | Odczyt/zapis | Media box tej strony (wymagane zgodnie ze specyfikacją). |
CropBox | Rectangle | Odczyt/zapis | Crop box (domyślnie media box). |
BleedBox | Rectangle | Odczyt/zapis | Pole spadu (domyślnie pole przycięcia). |
TrimBox | Rectangle | Odczyt/zapis | Pole przycięcia (domyślnie pole przycięcia). |
ArtBox | Rectangle | Odczyt/zapis | Pole art box (domyślnie crop box). |
Rotate | Rotation | Odczyt/zapis | Obrót strony jako enum Rotation. |
RotateDegrees | int | Odczyt/zapis | Obrót strony w stopniach jako int (0, 90, 180, 270). |
RotationMatrix | Matrix | Odczyt | Transformacja afinowa, która mapuje nierotowany układ współrzędnych PDF na widoczny dla użytkownika (obrócony) układ strony. |
Duration | double | Odczyt/zapis | Czas wyświetlania strony w sekundach w trybie prezentacji. |
Annotations | AnnotationCollection | Odczyt | Adnotacje na tej stronie. |
Images | XImageCollection | Odczyt | Obiekty XObject obrazów na tej stronie. |
Fonts | FontCollection | Odczyt | Czcionki odwoływane przez tę stronę. |
Resources | Resources | Odczyt | Zasoby strony (czcionki, obrazy) — zapewniają dostęp poprzez jednolity obiekt Resources. |
Patterns | IReadOnlyDictionary<string, Pattern> | Odczyt | Zasoby wzorców na tej stronie (indeksowane według nazwy wzorca). |
Contents | OperatorCollection | Odczyt | Zbiór operatorów strumienia zawartości. |
ContentsAppender | ContentsAppender | Odczyt | Pomocnik buforujący operatory, aby dodać je na początek / na koniec strumienia zawartości tej strony, zastosowany na UpdateData. |
Width | double | Odczyt | Widoczna szerokość strony uwzględniająca obrót. |
Height | double | Odczyt | Widoczna wysokość strony uwzględniająca obrót. |
ColorType | ColorType | Odczyt | Pobiera typ koloru tej strony, analizując operatory strumienia zawartości i przestrzenie barw obrazu. |
Transition | PageTransition? | Odczyt | Efekt przejścia strony, lub null, jeśli nie jest ustawiony. |
Header | HeaderFooter? | Odczyt/zapis | Nagłówek do wyświetlenia na górze tej strony. |
Footer | HeaderFooter? | Odczyt/zapis | Stopka wyświetlana na dole tej strony. |
TocInfo | TocInfo? | Odczyt/zapis | Informacje o spisie treści dla tej strony. |
Paragraphs | Paragraphs | Odczyt/zapis | Zbiór obiektów akapitów do dodania na tej stronie (TextFragment, HtmlFragment, Table, Heading, itp.). |
NoteLineStyle | GraphInfo | Odczyt/zapis | Domyślny styl kreski/wypełnienia używany do rysowania linii separatorów przypisów/przypisów końcowych. |
Artifacts | ArtifactCollection | Odczyt | Zbiór do dodawania artefaktów (znaków wodnych itp.) do tej strony. |
OcgLayers | LayerCollection | Odczyt | Uzyskuje warstwy (Optional Content Groups) odwoływane przez tę stronę. |
Actions | PageActionCollection | Odczyt | Dodatkowe akcje na stronę (otwarcie / zamknięcie / itp.), obsługiwane przez /AA. |
UserUnit | double | Odczyt/zapis | Współczynnik jednostki użytkownika (PDF 32000 §14.8.4 /UserUnit wpis). |
IsAddParagraphsAfterLast | bool | Odczyt/zapis | Czy dodatki do akapitów są dołączane na końcu (zamiast w miejscu przepływu). |
BackgroundImage | Image? | Odczyt/zapis | Obraz tła strony. |
Group | Group? | Odczyt/zapis | Słownik grupy / przestrzeni kolorów mieszania dla tej strony. |
TabOrder | TabOrder | Odczyt/zapis | Kolejność zakładek (PDF 32000 §12.5 /Tabs entry). |
Watermark | Watermark? | Odczyt/zapis | Znak wodny strony. |
Layers | System.Collections.Generic.List<Layer> | Odczyt/zapis | Warstwy strony (Optional Content Groups). |
Metody
| Sygnatura | Opis |
|---|---|
SetRotation(degrees: int) | Ustaw obrót strony w stopniach (0, 90, 180, 270). |
SetMediaBox(rect: Rectangle) | Ustaw ramkę mediów dla tej strony. |
SetCropBox(rect: Rectangle) | Ustaw pole przycięcia dla tej strony. |
SetBleedBox(rect: Rectangle) | Ustaw ramkę spadu dla tej strony. |
SetTrimBox(rect: Rectangle) | Ustaw pole przycięcia dla tej strony. |
SetArtBox(rect: Rectangle) | Ustaw art box dla tej strony. |
Accept(visitor: Annotations.AnnotationSelector) | Przejdź przez każdą adnotację na tej stronie przy użyciu visitor; dopasowania gromadzą się w Selected. |
GetResources() | Akcesor w stylu metody dla Resources — public-API parity. |
SetPageSize(width: double, height: double) | Ustaw rozmiar strony, aktualizując MediaBox. |
GetPageRect(considerRotation: bool) | Pobierz prostokąt strony, opcjonalnie uwzględniając CropBox. |
Accept(visitor: Text.TextAbsorber) | Akceptuj TextAbsorber gościa (pasującego do publicznego API). |
GetText() | Wyodrębnij cały tekst ze strony przy użyciu TextAbsorber. |
Accept(visitor: Text.TextFragmentAbsorber) | Akceptuj TextFragmentAbsorber gościa (pasującego do publicznego API). |
GetTextRotationStatistic() | Policz, ile fragmentów tekstu na tej stronie jest rysowanych pod każdym kątem obrotu. |
Accept(visitor: ImagePlacementAbsorber) | Zaakceptuj ImagePlacementAbsorber odwiedzającego (pasującego do publicznego API). |
SendTo(device: Devices.ImageDevice, outputFileName: string) | Dodaj pieczątkę do tej strony. |
SendTo(device: Devices.ImageDevice, output: Stream) | Renderuj tę stronę przy użyciu określonego urządzenia i zapisz do strumienia. |
AddStamp(stamp: ImageStamp) | Zastosuj pieczątkę obrazu na tej stronie. |
AddStamp(stamp: PdfPageStamp) | Zastosuj pieczątkę strony na tej stronie. |
AddStamp(stamp: Aspose.Pdf.Stamps.Stamp) | Wywołuje AddStamp(stamp) na tej instancji Page. |
AddContentStream(contentBytes: byte[]) | Dołącz strumień zawartości do tej strony. |
PrependContentStream(contentBytes: byte[]) | Dodaj bajty strumienia zawartości przed istniejącą treścią strony (dla elementów tła). |
AddContent(contentStreamBytes: byte[]) | Dołącz bajty strumienia zawartości do tej strony. |
AddTable(table: Table) | Dodaj tabelę do tej strony. |
AddGraph(graph: Drawing.Graph) | Dodaj wykres (zestaw kształtów) do tej strony. |
AddFloatingBox(box: FloatingBox) | Dodaj pływające pole do tej strony. |
AddExtGState(extGState: Content.ExtGState) | Dodaj słownik ExtGState do zasobów tej strony i zwróć nazwę zasobu. |
AddImage(imageData: byte[], rect: Rectangle, blackWhite: bool) | Dodaj obraz do tej strony w określonej pozycji i rozmiarze. |
AddImage(imageStream: Stream, rect: Rectangle) | Dodaj obraz ze strumienia do tej strony w określonej pozycji i rozmiarze. |
AddImage(imagePath: string, rectangle: Rectangle) | Dodaj obraz z ścieżki pliku; prostokąt ogranicza obraz, który zachowuje własne proporcje i jest wyśrodkowany wewnątrz niego. |
AddImage(imageStream: Stream, imageRect: Rectangle, bbox: Rectangle, autoAdjustRectangle: bool) | Dodaj obraz w imageRect z wyraźnym bounding-box. |
AddImage(imageStream: Stream, imageRect: Rectangle, imageWidth: int, imageHeight: int, saveImageProportions: bool) | Dodaj obraz z wyraźnym rozmiarem w pikselach + flagą proporcji (bbox domyślnie odpowiada prostokątowi obrazu). |
AddImage(imageStream: Stream, imageRect: Rectangle, imageWidth: int, imageHeight: int, saveImageProportions: bool, bbox: Rectangle) | Dodaj obraz z wyraźnym rozmiarem w pikselach + bbox. |
AddImage(hocr: string, imageStream: Stream, imageRect: Rectangle) | Wstaw obraz i nałóż ciąg HOCR (OCR) jako niewidoczną warstwę tekstową (tryb renderowania tekstu 3), tak aby strona wyświetlała obraz, ale rozpoznany tekst był przeszukiwalny / możliwy do kopiowania. |
AddImage(hocr: string, imageStream: Stream, imageRect: Rectangle, bbox: Rectangle) | Wstaw obraz i nałóż ciąg HOCR (OCR) jako niewidoczną warstwę tekstową; bbox jest akceptowane dla parzystości API. |
Resize(targetSize: Aspose.Pdf.PageSize) | Zmień rozmiar tej strony do targetSize poprzez aktualizację media-box. |
AsByteArray(resolution: Aspose.Pdf.Devices.Resolution) | Renderuj tę stronę do tablicy bajtów PNG w żądanej rozdzielczości. |
Flatten() | Spłaszcz wszystkie adnotacje na tej stronie — renderuj ich wygląd wizualny do strumienia zawartości strony i usuń je z tablicy adnotacji. |
ConvertToPNGMemoryStream() | Określa, czy strona jest pusta (nie zawiera istotnej treści). |
IsBlank(fillThresholdFactor: double) | Wywołuje IsBlank(fillThresholdFactor) na tej instancji Page. |
MergeLayers(newLayerName: string) | Scal wszystkie warstwy na tej stronie w jedną warstwę o podanej nazwie. |
MergeLayers(newLayerName: string, newOptionalContentGroupId: string) | Połącz wszystkie warstwy na tej stronie, przypisując nowemu OCG podane id. |
HasVectorGraphics() | Czy ta strona rysuje jakiekolwiek grafiki wektorowe, tj. |
TrySaveVectorGraphics(pathToSave: string) | Zapisz grafiki wektorowe z tej strony do pathToSave. |
AsXml() | Diagnostyczna reprezentacja XML tej strony. |
GetNotifications() | Powiadomienia o przełamaniu linii emitowane przez układ przepływu dla tej strony, gdy EnableNotificationLogging został ustawiony przed zapisem. |
MakeGrayscale() | Konwertuj kolory tej strony na odcienie szarości: content-stream colour operators, image XObjects, named colour-space resources oraz annotation appearances. |
IntToRotation(rotation: int) | Konwertuj rotację wyrażoną w stopniach-int na Rotation. |
RotationToInt(rotation: Rotation) | Konwertuj Rotation na stopnie jako int. |
FreeMemory() | Czyści buforowane dane. |
Dispose() | Zwalnia pamięć. |
CalculateContentBBox() | Oblicz najmniejszy prostokąt wyrównany do osi w przestrzeni strony obejmujący całą namalowaną treść na tej stronie (tekst, ścieżki wektorowe, obrazy, obrazy wstawione, rekurencyjnie przez Form XObjects). |
SendTo(device: PageDevice, output: Stream) | Renderuj tę stronę przez PageDevice do strumienia. |
SendTo(device: PageDevice, outputFileName: string) | Renderuj tę stronę przez PageDevice do pliku. |
AddStamp(stamp: Stamp) | Zastosuj stempel poprzez nadpisanie Put(Page). |
AddGraphics(elements: GraphicElementCollection) | Dołącz podane elementy wektorowe (zwykle generowane przez GraphicsAbsorber) do strumienia zawartości tej strony, odtwarzając geometrię każdego elementu w przestrzeni strony. |
AddGraphics(elements: GraphicElementCollection, rectangle: Rectangle) | Dołącz elementy wektorowe; prostokąt jest jedynie wskazówką (elementy są emitowane w całości, zawierając własną geometrię). |
DeleteGraphics(elementsToDelete: GraphicElementCollection) | To samo — usuwanie elementów wektorowych nie jest podłączone. |