Class PageAPI
Namespace: Aspose.Page.XPS.Features.EventBasedModifications
Assembly: Aspose.Page.dll (25.1.2)
API sửa đổi phần tử Page.
public class PageAPI : IModificationAPIKế thừa
Triển khai
Thành viên kế thừa
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Thuộc tính
Chiều cao
Trả về/cài đặt chiều cao của trang, được biểu diễn dưới dạng số thực trong các đơn vị của không gian tọa độ hiệu quả.
public float Height { get; set; }Giá trị thuộc tính
Số trang
Trả về số lượng trang trong tài liệu đang hoạt động.
public int PageCount { get; }Giá trị thuộc tính
Tổng số trang
Trả về tổng số trang trong tất cả tài liệu bên trong tài liệu XPS.
public int TotalPageCount { get; }Giá trị thuộc tính
Utils
Lấy đối tượng cung cấp các tiện ích ngoài API thao tác XPS chính thức.
public DocumentUtils Utils { get; }Giá trị thuộc tính
Chiều rộng
Trả về/cài đặt chiều rộng của trang, được biểu diễn dưới dạng số thực trong các đơn vị của không gian tọa độ hiệu quả.
public float Width { get; set; }Giá trị thuộc tính
Phương thức
Thêm<t>(T)
Thêm một phần tử nội dung (Canvas, Path, hoặc Glyphs).
public T Add<t>(T element) where T : XpsContentElementTham số
element T
Phần tử cần thêm.
Trả về
T
Phần tử đã thêm.
Tham số loại
T
Loại của phần tử.
ThêmCanvas()
Thêm một canvas mới vào trang.
public XpsCanvas AddCanvas()Trả về
Canvas đã thêm.
ThêmGlyphs(string, float, FontStyle, float, float, string)
Thêm các glyph mới vào trang.
public XpsGlyphs AddGlyphs(string fontFamily, float fontRenderingEmSize, FontStyle fontStyle, float originX, float originY, string unicodeString)Tham số
fontFamily string
Họ phông chữ.
fontRenderingEmSize float
Kích thước phông chữ.
fontStyle FontStyle
Kiểu phông chữ.
originX float
Tọa độ X gốc của glyphs.
originY float
Tọa độ Y gốc của glyphs.
unicodeString string
Chuỗi sẽ được in.
Trả về
Các glyph đã thêm.
ThêmGlyphs(XpsFont, float, float, float, string)
Thêm các glyph mới vào trang.
public XpsGlyphs AddGlyphs(XpsFont font, float fontRenderingEmSize, float originX, float originY, string unicodeString)Tham số
font XpsFont
Tài nguyên phông chữ.
fontRenderingEmSize float
Kích thước phông chữ.
originX float
Tọa độ X gốc của glyphs.
originY float
Tọa độ Y gốc của glyphs.
unicodeString string
Chuỗi sẽ được in.
Trả về
Các glyph đã thêm.
ThêmOutlineEntry(string, int, int)
Thêm một mục phác thảo vào tài liệu.
public void AddOutlineEntry(string description, int outlineLevel, int targetPageNumber)Tham số
description string
Mô tả mục.
outlineLevel int
Cấp độ phác thảo.
targetPageNumber int
Số trang mục tiêu.
ThêmPath(XpsPathGeometry)
Thêm một đường dẫn mới vào trang.
public XpsPath AddPath(XpsPathGeometry data)Tham số
data XpsPathGeometry
Hình học của đường dẫn.
Trả về
Đường dẫn đã thêm.
TạoArcSegment(PointF, SizeF, float, bool, XpsSweepDirection, bool)
Tạo một đoạn cung tròn mới.
public XpsArcSegment CreateArcSegment(PointF point, SizeF size, float rotationAngle, bool isLargeArc, XpsSweepDirection sweepDirection, bool isStroked = true)Tham số
point PointF
Điểm cuối của cung tròn.
size SizeF
Bán kính x và y của cung tròn dưới dạng cặp x,y.
rotationAngle float
Chỉ ra cách mà elip được xoay tương đối với hệ tọa độ hiện tại.
isLargeArc bool
Xác định xem cung có được vẽ với một quét 180 độ hoặc lớn hơn hay không.
sweepDirection XpsSweepDirection
Hướng mà cung được vẽ.
isStroked bool
Chỉ định xem đường viền cho đoạn này của đường dẫn có được vẽ hay không.
Trả về
Đoạn cung tròn mới.
TạoCanvas()
Tạo một canvas mới.
public XpsCanvas CreateCanvas()Trả về
Canvas mới.
TạoColor(Color)
Tạo một màu mới.
public XpsColor CreateColor(Color color)Tham số
color Color
Một thể hiện màu gốc cho màu RGB.
Trả về
Màu mới.
TạoColor(int, int, int, int)
Tạo một màu mới trong không gian màu sRGB.
public XpsColor CreateColor(int a, int r, int g, int b)Tham số
a int
Thành phần màu alpha.
r int
Thành phần màu đỏ.
g int
Thành phần màu xanh lá.
b int
Thành phần màu xanh dương.
Trả về
Màu mới.
TạoColor(int, int, int)
Tạo một màu mới trong không gian màu sRGB.
public XpsColor CreateColor(int r, int g, int b)Tham số
r int
Thành phần màu đỏ.
g int
Thành phần màu xanh lá.
b int
Thành phần màu xanh dương.
Trả về
Màu mới.
TạoColor(float, float, float, float)
Tạo một màu mới trong không gian màu scRGB.
public XpsColor CreateColor(float a, float r, float g, float b)Tham số
a float
Thành phần màu alpha.
r float
Thành phần màu đỏ.
g float
Thành phần màu xanh lá.
b float
Thành phần màu xanh dương.
Trả về
Màu mới.
TạoColor(float, float, float)
Tạo một màu mới trong không gian màu scRGB.
public XpsColor CreateColor(float r, float g, float b)Tham số
r float
Thành phần màu đỏ.
g float
Thành phần màu xanh lá.
b float
Thành phần màu xanh dương.
Trả về
Màu mới.
TạoColor(string, params float[])
Tạo một màu mới trong không gian màu dựa trên ICC.
public XpsColor CreateColor(string path, params float[] components)Tham số
path string
Đường dẫn đến hồ sơ ICC.
components float[]
Các thành phần màu.
Trả về
Màu mới.
TạoColor(XpsIccProfile, params float[])
Tạo một màu mới trong không gian màu dựa trên ICC.
public XpsColor CreateColor(XpsIccProfile iccProfile, params float[] components)Tham số
iccProfile XpsIccProfile
Tài nguyên hồ sơ ICC.
components float[]
Các thành phần màu.
Trả về
Màu mới.
TạoGlyphs(string, float, FontStyle, float, float, string)
Tạo các glyph mới.
public XpsGlyphs CreateGlyphs(string fontFamily, float fontRenderingEmSize, FontStyle fontStyle, float originX, float originY, string unicodeString)Tham số
fontFamily string
Họ phông chữ.
fontRenderingEmSize float
Kích thước phông chữ.
fontStyle FontStyle
Kiểu phông chữ.
originX float
Tọa độ X gốc của glyphs.
originY float
Tọa độ Y gốc của glyphs.
unicodeString string
Chuỗi sẽ được in.
Trả về
Các glyph mới.
TạoGlyphs(XpsFont, float, float, float, string)
Tạo các glyph mới.
public XpsGlyphs CreateGlyphs(XpsFont font, float fontRenderingEmSize, float originX, float originY, string unicodeString)Tham số
font XpsFont
Tài nguyên phông chữ.
fontRenderingEmSize float
Kích thước phông chữ.
originX float
Tọa độ X gốc của glyphs.
originY float
Tọa độ Y gốc của glyphs.
unicodeString string
Chuỗi sẽ được in.
Trả về
Các glyph mới.
TạoGradientStop(XpsColor, float)
Tạo một điểm dừng gradient mới.
public XpsGradientStop CreateGradientStop(XpsColor color, float offset)Tham số
color XpsColor
Màu của điểm dừng gradient.
offset float
Độ lệch gradient.
Trả về
Điểm dừng gradient mới.
TạoGradientStop(Color, float)
Tạo một điểm dừng gradient mới.
public XpsGradientStop CreateGradientStop(Color color, float offset)Tham số
color Color
Màu của điểm dừng gradient.
offset float
Độ lệch gradient.
Trả về
Điểm dừng gradient mới.
TạoImageBrush(XpsImage, RectangleF, RectangleF)
Tạo một bút vẽ hình ảnh mới.
public XpsImageBrush CreateImageBrush(XpsImage image, RectangleF viewbox, RectangleF viewport)Tham số
image XpsImage
Một tài nguyên hình ảnh.
viewbox RectangleF
Vị trí và kích thước của nội dung nguồn của bút vẽ.
viewport RectangleF
Khu vực trong không gian tọa độ chứa của bút vẽ chính mà (có thể lặp lại) được áp dụng để lấp đầy khu vực mà bút vẽ được áp dụng
Trả về
Bút vẽ hình ảnh mới.
TạoImageBrush(string, RectangleF, RectangleF)
Tạo một bút vẽ hình ảnh mới.
public XpsImageBrush CreateImageBrush(string imagePath, RectangleF viewbox, RectangleF viewport)Tham số
imagePath string
Đường dẫn đến hình ảnh được sử dụng làm gạch bút vẽ.
viewbox RectangleF
Vị trí và kích thước của nội dung nguồn của bút vẽ.
viewport RectangleF
Khu vực trong không gian tọa độ chứa của bút vẽ chính mà (có thể lặp lại) được áp dụng để lấp đầy khu vực mà bút vẽ được áp dụng
Trả về
Bút vẽ hình ảnh mới.
TạoLinearGradientBrush(List<xpsgradientstop>, PointF, PointF)
Tạo một bút vẽ gradient tuyến tính mới.
public XpsLinearGradientBrush CreateLinearGradientBrush(List<xpsgradientstop> gradientStops, PointF startPoint, PointF endPoint)Tham số
gradientStops List<XpsGradientStop>
Danh sách các điểm dừng gradient.
startPoint PointF
Điểm bắt đầu của gradient tuyến tính.
endPoint PointF
Điểm kết thúc của gradient tuyến tính.
Trả về
Bút vẽ gradient tuyến tính mới.
TạoLinearGradientBrush(PointF, PointF)
Tạo một bút vẽ gradient tuyến tính mới.
public XpsLinearGradientBrush CreateLinearGradientBrush(PointF startPoint, PointF endPoint)Tham số
startPoint PointF
Điểm bắt đầu của gradient tuyến tính.
endPoint PointF
Điểm kết thúc của gradient tuyến tính.
Trả về
Bút vẽ gradient tuyến tính mới.
TạoMatrix(float, float, float, float, float, float)
Tạo một ma trận biến đổi affine mới.
public XpsMatrix CreateMatrix(float m11, float m12, float m21, float m22, float m31, float m32)Tham số
m11 float
Phần tử 11.
m12 float
Phần tử 12.
m21 float
Phần tử 21.
m22 float
Phần tử 22.
m31 float
Phần tử 31.
m32 float
Phần tử 32.
Trả về
Ma trận biến đổi affine mới.
TạoPath(XpsPathGeometry)
Tạo một đường dẫn mới.
public XpsPath CreatePath(XpsPathGeometry data)Tham số
data XpsPathGeometry
Hình học của đường dẫn.
Trả về
Đường dẫn mới.
TạoPathFigure(PointF, bool)
Tạo một hình đường dẫn mới.
public XpsPathFigure CreatePathFigure(PointF startPoint, bool isClosed = false)Tham số
startPoint PointF
Điểm bắt đầu cho đoạn đầu tiên của hình đường dẫn.
isClosed bool
Xác định xem đường dẫn có được đóng hay không. Nếu đặt thành true, đường viền sẽ được vẽ “đóng”, tức là, điểm cuối cùng trong đoạn cuối cùng của hình đường dẫn được kết nối với điểm được chỉ định trong thuộc tính StartPoint, nếu không thì đường viền sẽ được vẽ “mở”, và điểm cuối cùng không được kết nối với điểm bắt đầu. Chỉ áp dụng nếu hình đường dẫn được sử dụng trong một phần tử Path xác định một đường viền.
Trả về
Hình đường dẫn mới.
TạoPathFigure(PointF, List, bool)
Tạo một hình đường dẫn mới.
public XpsPathFigure CreatePathFigure(PointF startPoint, List<xpspathsegment> segments, bool isClosed = false)Tham số
startPoint PointF
Điểm bắt đầu cho đoạn đầu tiên của hình đường dẫn.
segments List<XpsPathSegment>
Danh sách các đoạn đường dẫn.
isClosed bool
Xác định xem đường dẫn có được đóng hay không. Nếu đặt thành true, đường viền sẽ được vẽ “đóng”, tức là, điểm cuối cùng trong đoạn cuối cùng của hình đường dẫn được kết nối với điểm được chỉ định trong thuộc tính StartPoint, nếu không thì đường viền sẽ được vẽ “mở”, và điểm cuối cùng không được kết nối với điểm bắt đầu. Chỉ áp dụng nếu hình đường dẫn được sử dụng trong một phần tử Path xác định một đường viền.
Trả về
Hình đường dẫn mới.
TạoPathGeometry(string)
Tạo một hình học đường dẫn mới được chỉ định bằng dạng viết tắt.
public XpsPathGeometry CreatePathGeometry(string abbreviatedGeometry)Tham số
abbreviatedGeometry string
Dạng viết tắt của hình học đường dẫn.
Trả về
Hình học đường dẫn mới.
TạoPathGeometry()
Tạo một hình học đường dẫn mới.
public XpsPathGeometry CreatePathGeometry()Trả về
Hình học đường dẫn mới.
TạoPathGeometry(List<xpspathfigure>)
Tạo một hình học đường dẫn mới với danh sách hình đường dẫn đã chỉ định.
public XpsPathGeometry CreatePathGeometry(List<xpspathfigure> pathFigures)Tham số
pathFigures List<XpsPathFigure>
Danh sách các hình đường dẫn.
Trả về
Hình học đường dẫn mới.
TạoPolyBezierSegment(PointF[], bool)
Tạo một tập hợp các đường cong Bézier bậc ba mới.
public XpsPolyBezierSegment CreatePolyBezierSegment(PointF[] points, bool isStroked = true)Tham số
points PointF[]
Các điểm điều khiển cho nhiều đoạn Bézier.
isStroked bool
Xác định xem đường viền cho đoạn này của đường dẫn có được vẽ hay không.
Trả về
Đoạn đường cong Bézier bậc ba mới.
TạoPolyLineSegment(PointF[], bool)
Tạo một bản vẽ đa giác mới chứa một số lượng đỉnh riêng lẻ tùy ý.
public XpsPolyLineSegment CreatePolyLineSegment(PointF[] points, bool isStroked = true)Tham số
points PointF[]
Một tập hợp các tọa độ cho nhiều đoạn xác định đoạn đường polyline.
isStroked bool
Xác định xem đường viền cho đoạn này của đường dẫn có được vẽ hay không.
Trả về
Đoạn vẽ đa giác mới.
TạoPolyQuadraticBezierSegment(PointF[], bool)
Tạo một tập hợp các đường cong Bézier bậc hai mới từ điểm trước đó trong hình đường dẫn thông qua một tập hợp các đỉnh, sử dụng các điểm điều khiển đã chỉ định.
public XpsPolyQuadraticBezierSegment CreatePolyQuadraticBezierSegment(PointF[] points, bool isStroked = true)Tham số
points PointF[]
Các điểm điều khiển cho nhiều đoạn Bézier bậc hai.
isStroked bool
Xác định xem đường viền cho đoạn này của đường dẫn có được vẽ hay không.
Trả về
Đoạn đường cong Bézier bậc hai mới.
TạoRadialGradientBrush(List<xpsgradientstop>, PointF, PointF, float, float)
Tạo một bút vẽ gradient đối xứng mới.
public XpsRadialGradientBrush CreateRadialGradientBrush(List<xpsgradientstop> gradientStops, PointF center, PointF gradientOrigin, float radiusX, float radiusY)Tham số
gradientStops List<XpsGradientStop>
Danh sách các điểm dừng gradient.
center PointF
Điểm trung tâm của gradient đối xứng (tức là, trung tâm của elip).
gradientOrigin PointF
Điểm gốc của gradient đối xứng.
radiusX float
Bán kính trong chiều x của elip xác định gradient đối xứng.
radiusY float
Bán kính trong chiều y của elip xác định gradient đối xứng.
Trả về
Bút vẽ gradient đối xứng mới.
TạoRadialGradientBrush(PointF, PointF, float, float)
Tạo một bút vẽ gradient đối xứng mới.
public XpsRadialGradientBrush CreateRadialGradientBrush(PointF center, PointF gradientOrigin, float radiusX, float radiusY)Tham số
center PointF
Điểm trung tâm của gradient đối xứng (tức là, trung tâm của elip).
gradientOrigin PointF
Điểm gốc của gradient đối xứng.
radiusX float
Bán kính trong chiều x của elip xác định gradient đối xứng.
radiusY float
Bán kính trong chiều y của elip xác định gradient đối xứng.
Trả về
Bút vẽ gradient đối xứng mới.
TạoSolidColorBrush(XpsColor)
Tạo một bút vẽ màu rắn mới.
public XpsSolidColorBrush CreateSolidColorBrush(XpsColor color)Tham số
color XpsColor
Màu cho các phần tử được lấp đầy.
Trả về
Bút vẽ màu rắn mới.
TạoSolidColorBrush(Color)
Tạo một bút vẽ màu rắn mới.
public XpsSolidColorBrush CreateSolidColorBrush(Color color)Tham số
color Color
Màu cho các phần tử được lấp đầy.
Trả về
Bút vẽ màu rắn mới.
TạoVisualBrush(XpsContentElement, RectangleF, RectangleF)
Tạo một bút vẽ hình ảnh mới.
public XpsVisualBrush CreateVisualBrush(XpsContentElement element, RectangleF viewbox, RectangleF viewport)Tham số
element XpsContentElement
Phần tử XPS (Canvas, Path hoặc Glyphs) cho thuộc tính Hình ảnh của bút vẽ hình ảnh.
viewbox RectangleF
Vị trí và kích thước của nội dung nguồn của bút vẽ.
viewport RectangleF
Khu vực trong không gian tọa độ chứa của bút vẽ chính mà (có thể lặp lại) được áp dụng để lấp đầy khu vực mà bút vẽ được áp dụng
Trả về
Bút vẽ hình ảnh mới.
Chèn<t>(int, T)
Chèn một phần tử (Canvas, Path, hoặc Glyphs) vào trang tại vị trí index.
public T Insert<t>(int index, T element) where T : XpsContentElementTham số
index int
Vị trí mà một element nên được chèn vào.
element T
Phần tử cần chèn.
Trả về
T
Phần tử đã chèn.
Tham số loại
T
Loại của phần tử.
ChènCanvas(int)
Chèn một canvas mới vào trang tại vị trí index.
public XpsCanvas InsertCanvas(int index)Tham số
index int
Vị trí mà một canvas mới nên được chèn vào.
Trả về
Canvas đã chèn.
ChènGlyphs(int, string, float, FontStyle, float, float, string)
Chèn các glyph mới vào trang tại vị trí index.
public XpsGlyphs InsertGlyphs(int index, string fontFamily, float fontSize, FontStyle fontStyle, float originX, float originY, string unicodeString)Tham số
index int
Vị trí mà các glyph mới nên được chèn vào.
fontFamily string
Họ phông chữ.
fontSize float
Kích thước phông chữ.
fontStyle FontStyle
Kiểu phông chữ.
originX float
Tọa độ X gốc của glyphs.
originY float
Tọa độ Y gốc của glyphs.
unicodeString string
Chuỗi sẽ được in.
Trả về
Các glyph đã chèn.
ChènGlyphs(int, XpsFont, float, float, float, string)
Chèn các glyph mới vào trang tại vị trí index.
public XpsGlyphs InsertGlyphs(int index, XpsFont font, float fontSize, float originX, float originY, string unicodeString)Tham số
index int
Vị trí mà các glyph mới nên được chèn vào.
font XpsFont
Tài nguyên phông chữ.
fontSize float
Kích thước phông chữ.
originX float
Tọa độ X gốc của glyphs.
originY float
Tọa độ Y gốc của glyphs.
unicodeString string
Chuỗi sẽ được in.
Trả về
Các glyph đã chèn.
ChènPath(int, XpsPathGeometry)
Chèn một đường dẫn mới vào trang tại vị trí index.
public XpsPath InsertPath(int index, XpsPathGeometry data)Tham số
index int
Vị trí mà một đường dẫn mới nên được chèn vào.
data XpsPathGeometry
Hình học của đường dẫn.
Trả về
Đường dẫn đã chèn.
Xóa<t>(T)
Xóa một phần tử khỏi trang.
public T Remove<t>(T element) where T : XpsContentElementTham số
element T
Phần tử cần xóa.
Trả về
T
Phần tử đã xóa.
Tham số loại
T
Loại của phần tử.
XóaTại(int)
Xóa một phần tử tại vị trí index khỏi trang.
public XpsContentElement RemoveAt(int index)Tham số
index int
Vị trí mà phần tử nên được xóa.
Trả về
Phần tử đã xóa.
