Page
Обзор
Page — это класс в Aspose.PDF FOSS для .NET. Наследуется от: IDisposable.
Представляет страницу в PDF-документе.
Этот класс предоставляет 58 методов для работы с объектами Page в программах .NET. Доступные методы включают: Accept, AddContent, AddContentStream, AddExtGState, AddFloatingBox, AddGraph, AddGraphics, AddImage, AddStamp, AddTable, AsByteArray, AsXml и 28 дополнительных методов. Все публичные члены доступны любому приложению .NET после установки пакета Aspose.PDF FOSS для .NET. Свойства: Actions, Annotations, ArtBox, Artifacts, Background, BackgroundImage и 35 дополнительных.
Свойства
| Имя: | Тип: | Доступ | Описание: |
|---|---|---|---|
Number | int | Чтение | Нумерация страниц, начиная с 1. |
FieldsInTabOrder | IList<Forms.Field> | Чтение | Поля формы, чьи виджеты отображаются на этой странице, упорядоченные по порядку переключения (Tab). |
Rect | Rectangle | Чтение/запись | Прямоугольник страницы (по умолчанию MediaBox). |
Rectangle | Rectangle | Чтение/запись | Прямоугольник страницы. |
PageInfo | PageInfo | Чтение/запись | Контейнер информации о странице с свойствами ширины/высоты/отступа. |
Background | Color? | Чтение/запись | Цвет фона страницы. |
MediaBox | Rectangle | Чтение/запись | Media box для этой страницы (требуется по спецификации). |
CropBox | Rectangle | Чтение/запись | Crop box (по умолчанию — media box). |
BleedBox | Rectangle | Чтение/запись | Поле bleed box (по умолчанию — crop box). |
TrimBox | Rectangle | Чтение/запись | Поле trim box (по умолчанию — crop box). |
ArtBox | Rectangle | Чтение/запись | Поле art box (по умолчанию — crop box). |
Rotate | Rotation | Чтение/запись | Поворот страницы как перечисление Rotation. |
RotateDegrees | int | Чтение/запись | Поворот страницы в градусах как int (0, 90, 180, 270). |
RotationMatrix | Matrix | Чтение | Аффинное преобразование, которое отображает неповёрнутую систему координат PDF в пользовательски видимую (повёрнутую) систему страницы. |
Duration | double | Чтение/запись | Продолжительность отображения страницы в секундах в режиме презентации. |
Annotations | AnnotationCollection | Чтение | Аннотации на этой странице. |
Images | XImageCollection | Чтение | Объекты Image XObjects на этой странице. |
Fonts | FontCollection | Чтение | Шрифты, используемые на этой странице. |
Resources | Resources | Чтение | Ресурсы страницы (шрифты, изображения) — предоставляют доступ через единый объект Resources. |
Patterns | IReadOnlyDictionary<string, Pattern> | Чтение | Ресурсы шаблонов на этой странице (по имени шаблона). |
Contents | OperatorCollection | Чтение | Коллекция операторов потока контента. |
ContentsAppender | ContentsAppender | Чтение | Помощник, который буферизует операторы для добавления в начало/конец потока контента этой страницы, применяемый к UpdateData. |
Width | double | Чтение | Ширина видимой страницы с учётом вращения. |
Height | double | Чтение | Высота видимой страницы с учётом вращения. |
ColorType | ColorType | Чтение | Получает тип цвета этой страницы, анализируя операторы потока содержимого и цветовые пространства изображений. |
Transition | PageTransition? | Чтение | Эффект перехода страницы, или null, если не установлен. |
Header | HeaderFooter? | Чтение/запись | Заголовок, отображаемый в верхней части этой страницы. |
Footer | HeaderFooter? | Чтение/запись | Нижний колонтитул, отображаемый внизу этой страницы. |
TocInfo | TocInfo? | Чтение/запись | Информация о содержании (TOC) для этой страницы. |
Paragraphs | Paragraphs | Чтение/запись | Коллекция объектов абзацев для добавления на эту страницу (TextFragment, HtmlFragment, Table, Heading и т.д.). |
NoteLineStyle | GraphInfo | Чтение/запись | Стиль обводки/заливки по умолчанию, используемый для рисования линий-разделителей сносок/конечных сносок. |
Artifacts | ArtifactCollection | Чтение | Коллекция для добавления артефактов (водяных знаков и т. п.) на эту страницу. |
OcgLayers | LayerCollection | Чтение | Получает слои (Optional Content Groups), на которые ссылается эта страница. |
Actions | PageActionCollection | Чтение | Дополнительные действия на странице (открыть / закрыть / и т.д.), поддерживаемые /AA. |
UserUnit | double | Чтение/запись | Коэффициент пользовательской единицы (PDF 32000 §14.8.4 запись /UserUnit). |
IsAddParagraphsAfterLast | bool | Чтение/запись | Определяет, добавляются ли добавления абзацев в конец (против позиции в потоке). |
BackgroundImage | Image? | Чтение/запись | Фоновое изображение страницы. |
Group | Group? | Чтение/запись | Словарь группового/смешанного цветового пространства для этой страницы. |
TabOrder | TabOrder | Чтение/запись | Порядок табуляции (PDF 32000 §12.5 /Tabs entry). |
Watermark | Watermark? | Чтение/запись | Водяной знак страницы. |
Layers | System.Collections.Generic.List<Layer> | Чтение/запись | Слои страницы (Optional Content Groups). |
Методы
| Подпись | Описание: |
|---|---|
SetRotation(degrees: int) | Установите вращение страницы в градусах (0, 90, 180, 270). |
SetMediaBox(rect: Rectangle) | Установите медиабокс для этой страницы. |
SetCropBox(rect: Rectangle) | Установить обрезную рамку для этой страницы. |
SetBleedBox(rect: Rectangle) | Установите bleed box для этой страницы. |
SetTrimBox(rect: Rectangle) | Установите обрезную рамку для этой страницы. |
SetArtBox(rect: Rectangle) | Установите art box для этой страницы. |
Accept(visitor: Annotations.AnnotationSelector) | Обойдите каждую аннотацию на этой странице через visitor; совпадения собираются в Selected. |
GetResources() | Метод-стильный аксессор для Resources — паритет public-API. |
SetPageSize(width: double, height: double) | Установите размер страницы, обновив MediaBox. |
GetPageRect(considerRotation: bool) | Получить прямоугольник страницы, при необходимости учитывая CropBox. |
Accept(visitor: Text.TextAbsorber) | Примите TextAbsorber посетителя (соответствующего публичному API). |
GetText() | Извлеките весь текст со страницы, используя TextAbsorber. |
Accept(visitor: Text.TextFragmentAbsorber) | Примите TextFragmentAbsorber посетителя (соответствующего публичному API). |
GetTextRotationStatistic() | Подсчитайте, сколько текстовых фрагментов на этой странице отрисовано под каждым углом поворота. |
Accept(visitor: ImagePlacementAbsorber) | Принять ImagePlacementAbsorber посетителя (соответствующего публичному API). |
SendTo(device: Devices.ImageDevice, outputFileName: string) | Добавить штамп на эту страницу. |
SendTo(device: Devices.ImageDevice, output: Stream) | Отобразить эту страницу с использованием указанного устройства и записать в поток. |
AddStamp(stamp: ImageStamp) | Применить изображение-штамп к этой странице. |
AddStamp(stamp: PdfPageStamp) | Применить штамп-страницы к этой странице. |
AddStamp(stamp: Aspose.Pdf.Stamps.Stamp) | Вызывает AddStamp(stamp) у этого экземпляра Page. |
AddContentStream(contentBytes: byte[]) | Добавить поток содержимого к этой странице. |
PrependContentStream(contentBytes: byte[]) | Добавьте байты потока содержимого перед существующим содержимым страницы (для фоновых элементов). |
AddContent(contentStreamBytes: byte[]) | Добавьте байты потока содержимого к этой странице. |
AddTable(table: Table) | Добавьте таблицу на эту страницу. |
AddGraph(graph: Drawing.Graph) | Добавьте граф (коллекцию фигур) на эту страницу. |
AddFloatingBox(box: FloatingBox) | Добавьте плавающий блок на эту страницу. |
AddExtGState(extGState: Content.ExtGState) | Добавьте словарь ExtGState в ресурсы этой страницы и верните имя ресурса. |
AddImage(imageData: byte[], rect: Rectangle, blackWhite: bool) | Добавьте изображение на эту страницу в указанном положении и размере. |
AddImage(imageStream: Stream, rect: Rectangle) | Добавьте изображение из потока на эту страницу в указанном положении и размере. |
AddImage(imagePath: string, rectangle: Rectangle) | Добавить изображение из пути к файлу; прямоугольник ограничивает изображение, которое сохраняет своё соотношение сторон, центрированное внутри него. |
AddImage(imageStream: Stream, imageRect: Rectangle, bbox: Rectangle, autoAdjustRectangle: bool) | Добавить изображение в imageRect с явно заданным ограничивающим прямоугольником. |
AddImage(imageStream: Stream, imageRect: Rectangle, imageWidth: int, imageHeight: int, saveImageProportions: bool) | Добавить изображение с явно указанным размером в пикселях + флагом пропорций (bbox по умолчанию соответствует прямоугольнику изображения). |
AddImage(imageStream: Stream, imageRect: Rectangle, imageWidth: int, imageHeight: int, saveImageProportions: bool, bbox: Rectangle) | Добавить изображение с явно указанным размером в пикселях + bbox. |
AddImage(hocr: string, imageStream: Stream, imageRect: Rectangle) | Вставьте изображение и наложите строку HOCR (OCR) в виде невидимого текстового слоя (режим рендеринга текста 3), чтобы страница отображала изображение, но распознанный текст был доступен для поиска/копирования. |
AddImage(hocr: string, imageStream: Stream, imageRect: Rectangle, bbox: Rectangle) | Вставьте изображение и наложите строку HOCR (OCR) в виде невидимого текстового слоя; bbox принимается для паритета API. |
Resize(targetSize: Aspose.Pdf.PageSize) | Измените размер этой страницы до targetSize с помощью обновления media-box. |
AsByteArray(resolution: Aspose.Pdf.Devices.Resolution) | Отрендерите эту страницу в массив байтов PNG с запрошенным разрешением. |
Flatten() | Сведите все аннотации на этой странице в один слой — отобразите их визуальное представление в поток содержимого страницы и удалите их из массива аннотаций. |
ConvertToPNGMemoryStream() | Определяет, является ли страница пустой (не содержит значимого содержимого). |
IsBlank(fillThresholdFactor: double) | Вызывает IsBlank(fillThresholdFactor) у этого экземпляра Page. |
MergeLayers(newLayerName: string) | Объединить все слои на этой странице в один слой с указанным именем. |
MergeLayers(newLayerName: string, newOptionalContentGroupId: string) | Объедините все слои на этой странице, присвоив новому OCG указанный идентификатор. |
HasVectorGraphics() | Рисует ли эта страница какие-либо векторные графики, т. е. |
TrySaveVectorGraphics(pathToSave: string) | Сохраните векторные графики с этой страницы в pathToSave. |
AsXml() | Диагностическое представление XML этой страницы. |
GetNotifications() | Уведомления о переносах строк, генерируемые потоковым макетом для этой страницы, когда EnableNotificationLogging был установлен перед сохранением. |
MakeGrayscale() | Преобразовать цвета этой страницы в градации серого: операторы цветов в контент-стриме, XObject-изображения, именованные ресурсы цветового пространства и внешние виды аннотаций. |
IntToRotation(rotation: int) | Преобразовать вращение, заданное целым числом градусов, в Rotation. |
RotationToInt(rotation: Rotation) | Преобразовать Rotation в градусы в виде целого числа. |
FreeMemory() | Очищает кэшированные данные. |
Dispose() | Освобождает память. |
CalculateContentBBox() | Вычислить наименьший прямоугольник, выровненный по осям, в пространстве страницы, охватывающий всё нарисованное содержимое на этой странице (текст, векторные пути, изображения, встроенные изображения, рекурсивно через Form XObjects). |
SendTo(device: PageDevice, output: Stream) | Отрисовать эту страницу через PageDevice в поток. |
SendTo(device: PageDevice, outputFileName: string) | Отрисовать эту страницу через PageDevice в файл. |
AddStamp(stamp: Stamp) | Применить штамп через его переопределение Put(Page). |
AddGraphics(elements: GraphicElementCollection) | Добавить указанные векторные элементы (обычно создаваемые GraphicsAbsorber) в поток содержимого этой страницы, воспроизводя геометрию каждого элемента в пространстве страницы. |
AddGraphics(elements: GraphicElementCollection, rectangle: Rectangle) | Добавить векторные элементы; прямоугольник является рекомендацией (элементы выводятся полностью, несут собственную геометрию). |
DeleteGraphics(elementsToDelete: GraphicElementCollection) | То же самое — удаление векторных элементов не реализовано. |
