Class PageAPI
Namespace: Aspose.Page.XPS.Features.EventBasedModifications
Assembly: Aspose.Page.dll (25.1.2)
واجهة برمجة التطبيقات لتعديل عنصر Page.
public class PageAPI : IModificationAPIالوراثة
التنفيذ
الأعضاء الموروثة
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
الخصائص
الارتفاع
يرجع/يحدد ارتفاع الصفحة، معبرًا عنه كرقم حقيقي بـ وحدات مساحة الإحداثيات الفعالة.
public float Height { get; set; }قيمة الخاصية
عدد الصفحات
يرجع عدد الصفحات في المستند النشط.
public int PageCount { get; }قيمة الخاصية
إجمالي عدد الصفحات
يرجع العدد الإجمالي للصفحات في جميع المستندات داخل مستند XPS.
public int TotalPageCount { get; }قيمة الخاصية
الأدوات
يحصل على الكائن الذي يوفر أدوات تتجاوز واجهة برمجة التطبيقات الرسمية للتلاعب بـ XPS.
public DocumentUtils Utils { get; }قيمة الخاصية
العرض
يرجع/يحدد عرض الصفحة، معبرًا عنه كرقم حقيقي في وحدات مساحة الإحداثيات الفعالة.
public float Width { get; set; }قيمة الخاصية
الطرق
إضافة<t>(T)
يضيف عنصر محتوى (Canvas، Path، أو Glyphs).
public T Add<t>(T element) where T : XpsContentElementالمعلمات
element T
العنصر الذي سيتم إضافته.
العائدات
T
العنصر المضاف.
معلمات النوع
T
نوع العنصر.
إضافةCanvas()
يضيف قماشًا جديدًا إلى الصفحة.
public XpsCanvas AddCanvas()العائدات
القماش المضاف.
إضافةGlyphs(string، float، FontStyle، float، float، string)
يضيف رموزًا جديدة إلى الصفحة.
public XpsGlyphs AddGlyphs(string fontFamily, float fontRenderingEmSize, FontStyle fontStyle, float originX, float originY, string unicodeString)المعلمات
fontFamily string
عائلة الخط.
fontRenderingEmSize float
حجم الخط.
fontStyle FontStyle
نمط الخط.
originX float
إحداثيات الأصل X للرموز.
originY float
إحداثيات الأصل Y للرموز.
unicodeString string
السلسلة التي سيتم طباعتها.
العائدات
الرموز المضافة.
إضافةGlyphs(XpsFont، float، float، float، string)
يضيف رموزًا جديدة إلى الصفحة.
public XpsGlyphs AddGlyphs(XpsFont font, float fontRenderingEmSize, float originX, float originY, string unicodeString)المعلمات
font XpsFont
موارد الخط.
fontRenderingEmSize float
حجم الخط.
originX float
إحداثيات الأصل X للرموز.
originY float
إحداثيات الأصل Y للرموز.
unicodeString string
السلسلة التي سيتم طباعتها.
العائدات
الرموز المضافة.
إضافةOutlineEntry(string، int، int)
يضيف إدخال مخطط إلى المستند.
public void AddOutlineEntry(string description, int outlineLevel, int targetPageNumber)المعلمات
description string
وصف الإدخال.
outlineLevel int
مستوى المخطط.
targetPageNumber int
رقم الصفحة المستهدفة.
إضافةPath(XpsPathGeometry)
يضيف مسارًا جديدًا إلى الصفحة.
public XpsPath AddPath(XpsPathGeometry data)المعلمات
data XpsPathGeometry
الهندسة الخاصة بالمسار.
العائدات
المسار المضاف.
إنشاءArcSegment(PointF، SizeF، float، bool، XpsSweepDirection، bool)
ينشئ مقطع قوس بيضاوي جديد.
public XpsArcSegment CreateArcSegment(PointF point, SizeF size, float rotationAngle, bool isLargeArc, XpsSweepDirection sweepDirection, bool isStroked = true)المعلمات
point PointF
نقطة نهاية القوس البيضاوي.
size SizeF
نصف القطر X و Y للقوس البيضاوي كزوج x، y.
rotationAngle float
تشير إلى كيفية دوران البيضاوي بالنسبة لنظام الإحداثيات الحالي.
isLargeArc bool
تحدد ما إذا كان القوس مرسومًا بزاوية 180 أو أكثر.
sweepDirection XpsSweepDirection
الاتجاه الذي يتم رسم القوس فيه.
isStroked bool
تحدد ما إذا كان يتم رسم الخط لهذا الجزء من المسار.
العائدات
مقطع قوس بيضاوي جديد.
إنشاءCanvas()
ينشئ قماشة جديدة.
public XpsCanvas CreateCanvas()العائدات
قماشة جديدة.
إنشاءColor(Color)
ينشئ لونًا جديدًا.
public XpsColor CreateColor(Color color)المعلمات
color Color
مثال لون أصلي للون RGB.
العائدات
لون جديد.
إنشاءColor(int، int، int، int)
ينشئ لونًا جديدًا في مساحة اللون sRGB.
public XpsColor CreateColor(int a, int r, int g, int b)المعلمات
a int
مكون اللون ألفا.
r int
مكون اللون الأحمر.
g int
مكون اللون الأخضر.
b int
مكون اللون الأزرق.
العائدات
لون جديد.
إنشاءColor(int، int، int)
ينشئ لونًا جديدًا في مساحة اللون sRGB.
public XpsColor CreateColor(int r, int g, int b)المعلمات
r int
مكون اللون الأحمر.
g int
مكون اللون الأخضر.
b int
مكون اللون الأزرق.
العائدات
لون جديد.
إنشاءColor(float، float، float، float)
ينشئ لونًا جديدًا في مساحة اللون scRGB.
public XpsColor CreateColor(float a, float r, float g, float b)المعلمات
a float
مكون اللون ألفا.
r float
مكون اللون الأحمر.
g float
مكون اللون الأخضر.
b float
مكون اللون الأزرق.
العائدات
لون جديد.
إنشاءColor(float، float، float)
ينشئ لونًا جديدًا في مساحة اللون scRGB.
public XpsColor CreateColor(float r, float g, float b)المعلمات
r float
مكون اللون الأحمر.
g float
مكون اللون الأخضر.
b float
مكون اللون الأزرق.
العائدات
لون جديد.
إنشاءColor(string، params float[])
ينشئ لونًا جديدًا في مساحة اللون المستندة إلى ICC.
public XpsColor CreateColor(string path, params float[] components)المعلمات
path string
المسار إلى ملف تعريف ICC.
components float[]
مكونات اللون.
العائدات
لون جديد.
إنشاءColor(XpsIccProfile، params float[])
ينشئ لونًا جديدًا في مساحة اللون المستندة إلى ICC.
public XpsColor CreateColor(XpsIccProfile iccProfile, params float[] components)المعلمات
iccProfile XpsIccProfile
موارد ملف تعريف ICC.
components float[]
مكونات اللون.
العائدات
لون جديد.
إنشاءGlyphs(string، float، FontStyle، float، float، string)
ينشئ رموزًا جديدة.
public XpsGlyphs CreateGlyphs(string fontFamily, float fontRenderingEmSize, FontStyle fontStyle, float originX, float originY, string unicodeString)المعلمات
fontFamily string
عائلة الخط.
fontRenderingEmSize float
حجم الخط.
fontStyle FontStyle
نمط الخط.
originX float
إحداثيات الأصل X للرموز.
originY float
إحداثيات الأصل Y للرموز.
unicodeString string
السلسلة التي سيتم طباعتها.
العائدات
رموز جديدة.
إنشاءGlyphs(XpsFont، float، float، float، string)
ينشئ رموزًا جديدة.
public XpsGlyphs CreateGlyphs(XpsFont font, float fontRenderingEmSize, float originX, float originY, string unicodeString)المعلمات
font XpsFont
موارد الخط.
fontRenderingEmSize float
حجم الخط.
originX float
إحداثيات الأصل X للرموز.
originY float
إحداثيات الأصل Y للرموز.
unicodeString string
السلسلة التي سيتم طباعتها.
العائدات
رموز جديدة.
إنشاءGradientStop(XpsColor، float)
ينشئ نقطة تدرج جديدة.
public XpsGradientStop CreateGradientStop(XpsColor color, float offset)المعلمات
color XpsColor
لون نقطة التدرج.
offset float
الإزاحة في التدرج.
العائدات
نقطة تدرج جديدة.
إنشاءGradientStop(Color، float)
ينشئ نقطة تدرج جديدة.
public XpsGradientStop CreateGradientStop(Color color, float offset)المعلمات
color Color
لون نقطة التدرج.
offset float
الإزاحة في التدرج.
العائدات
نقطة تدرج جديدة.
إنشاءImageBrush(XpsImage، RectangleF، RectangleF)
ينشئ فرشاة صورة جديدة.
public XpsImageBrush CreateImageBrush(XpsImage image, RectangleF viewbox, RectangleF viewport)المعلمات
image XpsImage
موارد صورة.
viewbox RectangleF
موضع وأبعاد محتوى مصدر الفرشاة.
viewport RectangleF
المنطقة في مساحة الإحداثيات الحاوية للفرشاة الأساسية التي يتم تطبيقها (ربما بشكل متكرر) لملء المنطقة التي يتم تطبيق الفرشاة عليها.
العائدات
فرشاة صورة جديدة.
إنشاءImageBrush(string، RectangleF، RectangleF)
ينشئ فرشاة صورة جديدة.
public XpsImageBrush CreateImageBrush(string imagePath, RectangleF viewbox, RectangleF viewport)المعلمات
imagePath string
المسار إلى الصورة التي سيتم أخذها كفرشاة.
viewbox RectangleF
موضع وأبعاد محتوى مصدر الفرشاة.
viewport RectangleF
المنطقة في مساحة الإحداثيات الحاوية للفرشاة الأساسية التي يتم تطبيقها (ربما بشكل متكرر) لملء المنطقة التي يتم تطبيق الفرشاة عليها.
العائدات
فرشاة صورة جديدة.
إنشاءLinearGradientBrush(List<xpsgradientstop>، PointF، PointF)
ينشئ فرشاة تدرج خطي جديدة.
public XpsLinearGradientBrush CreateLinearGradientBrush(List<xpsgradientstop> gradientStops, PointF startPoint, PointF endPoint)المعلمات
gradientStops List<XpsGradientStop>
قائمة نقاط التدرج.
startPoint PointF
نقطة البداية للتدرج الخطي.
endPoint PointF
نقطة النهاية للتدرج الخطي.
العائدات
فرشاة تدرج خطي جديدة.
إنشاءLinearGradientBrush(PointF، PointF)
ينشئ فرشاة تدرج خطي جديدة.
public XpsLinearGradientBrush CreateLinearGradientBrush(PointF startPoint, PointF endPoint)المعلمات
startPoint PointF
نقطة البداية للتدرج الخطي.
endPoint PointF
نقطة النهاية للتدرج الخطي.
العائدات
فرشاة تدرج خطي جديدة.
إنشاءMatrix(float، float، float، float، float، float)
ينشئ مصفوفة تحويل جديدة.
public XpsMatrix CreateMatrix(float m11, float m12, float m21, float m22, float m31, float m32)المعلمات
m11 float
العنصر 11.
m12 float
العنصر 12.
m21 float
العنصر 21.
m22 float
العنصر 22.
m31 float
العنصر 31.
m32 float
العنصر 32.
العائدات
مصفوفة تحويل جديدة.
إنشاءPath(XpsPathGeometry)
ينشئ مسارًا جديدًا.
public XpsPath CreatePath(XpsPathGeometry data)المعلمات
data XpsPathGeometry
الهندسة الخاصة بالمسار.
العائدات
مسار جديد.
إنشاءPathFigure(PointF، bool)
ينشئ شكل مسار جديد.
public XpsPathFigure CreatePathFigure(PointF startPoint, bool isClosed = false)المعلمات
startPoint PointF
نقطة البداية للجزء الأول من شكل المسار.
isClosed bool
تحدد ما إذا كان المسار مغلقًا. إذا تم تعيينه على true، يتم رسم الخط “مغلق”، أي أن النقطة الأخيرة في الجزء الأخير من شكل المسار تتصل بالنقطة المحددة في سمة StartPoint، وإلا يتم رسم الخط “مفتوح”، و النقطة الأخيرة غير متصلة بالنقطة الأولى. ينطبق فقط إذا تم استخدام شكل المسار في عنصر Path الذي يحدد خطًا.
العائدات
شكل مسار جديد.
إنشاءPathFigure(PointF، List، bool)
ينشئ شكل مسار جديد.
public XpsPathFigure CreatePathFigure(PointF startPoint, List<xpspathsegment> segments, bool isClosed = false)المعلمات
startPoint PointF
نقطة البداية للجزء الأول من شكل المسار.
segments List<XpsPathSegment>
قائمة مقاطع المسار.
isClosed bool
تحدد ما إذا كان المسار مغلقًا. إذا تم تعيينه على true، يتم رسم الخط “مغلق”، أي أن النقطة الأخيرة في الجزء الأخير من شكل المسار تتصل بالنقطة المحددة في سمة StartPoint، وإلا يتم رسم الخط “مفتوح”، و النقطة الأخيرة غير متصلة بالنقطة الأولى. ينطبق فقط إذا تم استخدام شكل المسار في عنصر Path الذي يحدد خطًا.
العائدات
شكل مسار جديد.
إنشاءPathGeometry(string)
ينشئ هندسة مسار جديدة محددة بشكل مختصر.
public XpsPathGeometry CreatePathGeometry(string abbreviatedGeometry)المعلمات
abbreviatedGeometry string
شكل مختصر لهندسة المسار.
العائدات
هندسة مسار جديدة.
إنشاءPathGeometry()
ينشئ هندسة مسار جديدة.
public XpsPathGeometry CreatePathGeometry()العائدات
هندسة مسار جديدة.
إنشاءPathGeometry(List<xpspathfigure>)
ينشئ هندسة مسار جديدة مع قائمة محددة من أشكال المسار.
public XpsPathGeometry CreatePathGeometry(List<xpspathfigure> pathFigures)المعلمات
pathFigures List<XpsPathFigure>
قائمة أشكال المسار.
العائدات
هندسة مسار جديدة.
إنشاءPolyBezierSegment(PointF[]، bool)
ينشئ مجموعة جديدة من منحنيات بيزير التكعيبية.
public XpsPolyBezierSegment CreatePolyBezierSegment(PointF[] points, bool isStroked = true)المعلمات
points PointF[]
نقاط التحكم لمقاطع بيزير المتعددة.
isStroked bool
تحدد ما إذا كان يتم رسم الخط لهذا الجزء من المسار.
العائدات
مقطع منحنيات بيزير التكعيبية جديد.
إنشاءPolyLineSegment(PointF[]، bool)
ينشئ رسمًا مضلعًا جديدًا يحتوي على عدد غير محدد من الرؤوس الفردية.
public XpsPolyLineSegment CreatePolyLineSegment(PointF[] points, bool isStroked = true)المعلمات
points PointF[]
مجموعة من الإحداثيات لمقاطع متعددة تحدد مقطع الخط المتعدد.
isStroked bool
تحدد ما إذا كان يتم رسم الخط لهذا الجزء من المسار.
العائدات
مقطع رسم مضلع جديد.
إنشاءPolyQuadraticBezierSegment(PointF[]، bool)
ينشئ مجموعة جديدة من منحنيات بيزير التربيعية من النقطة السابقة في شكل المسار عبر مجموعة من الرؤوس، باستخدام نقاط التحكم المحددة.
public XpsPolyQuadraticBezierSegment CreatePolyQuadraticBezierSegment(PointF[] points, bool isStroked = true)المعلمات
points PointF[]
نقاط التحكم لمقاطع بيزير التربيعية المتعددة.
isStroked bool
تحدد ما إذا كان يتم رسم الخط لهذا الجزء من المسار.
العائدات
مقطع منحنيات بيزير التربيعية جديد.
إنشاءRadialGradientBrush(List<xpsgradientstop>، PointF، PointF، float، float)
ينشئ فرشاة تدرج شعاعي جديدة.
public XpsRadialGradientBrush CreateRadialGradientBrush(List<xpsgradientstop> gradientStops, PointF center, PointF gradientOrigin, float radiusX, float radiusY)المعلمات
gradientStops List<XpsGradientStop>
قائمة نقاط التدرج.
center PointF
نقطة المركز للتدرج الشعاعي (أي، مركز البيضاوي).
gradientOrigin PointF
نقطة الأصل للتدرج الشعاعي.
radiusX float
نصف القطر في بعد X للبيضاوي الذي يحدد التدرج الشعاعي.
radiusY float
نصف القطر في بعد Y للبيضاوي الذي يحدد التدرج الشعاعي.
العائدات
فرشاة تدرج شعاعي جديدة.
إنشاءRadialGradientBrush(PointF، PointF، float، float)
ينشئ فرشاة تدرج شعاعي جديدة.
public XpsRadialGradientBrush CreateRadialGradientBrush(PointF center, PointF gradientOrigin, float radiusX, float radiusY)المعلمات
center PointF
نقطة المركز للتدرج الشعاعي (أي، مركز البيضاوي).
gradientOrigin PointF
نقطة الأصل للتدرج الشعاعي.
radiusX float
نصف القطر في بعد X للبيضاوي الذي يحدد التدرج الشعاعي.
radiusY float
نصف القطر في بعد Y للبيضاوي الذي يحدد التدرج الشعاعي.
العائدات
فرشاة تدرج شعاعي جديدة.
إنشاءSolidColorBrush(XpsColor)
ينشئ فرشاة لون صلب جديدة.
public XpsSolidColorBrush CreateSolidColorBrush(XpsColor color)المعلمات
color XpsColor
اللون للعناصر المملوءة.
العائدات
فرشاة لون صلب جديدة.
إنشاءSolidColorBrush(Color)
ينشئ فرشاة لون صلب جديدة.
public XpsSolidColorBrush CreateSolidColorBrush(Color color)المعلمات
color Color
اللون للعناصر المملوءة.
العائدات
فرشاة لون صلب جديدة.
إنشاءVisualBrush(XpsContentElement، RectangleF، RectangleF)
ينشئ فرشاة بصرية جديدة.
public XpsVisualBrush CreateVisualBrush(XpsContentElement element, RectangleF viewbox, RectangleF viewport)المعلمات
element XpsContentElement
عنصر XPS (Canvas، Path أو Glyphs) لخاصية بصرية للفرشاة البصرية.
viewbox RectangleF
موضع وأبعاد محتوى مصدر الفرشاة.
viewport RectangleF
المنطقة في مساحة الإحداثيات الحاوية للفرشاة الأساسية التي يتم تطبيقها (ربما بشكل متكرر) لملء المنطقة التي يتم تطبيق الفرشاة عليها.
العائدات
فرشاة بصرية جديدة.
إدراج<t>(int، T)
يُدرج عنصرًا (Canvas، Path، أو Glyphs) إلى الصفحة في موضع index.
public T Insert<t>(int index, T element) where T : XpsContentElementالمعلمات
index int
الموضع الذي يجب إدراج عنصر element فيه.
element T
العنصر الذي سيتم إدراجه.
العائدات
T
العنصر المدخل.
معلمات النوع
T
نوع العنصر.
إدراجCanvas(int)
يُدرج قماشًا جديدًا إلى الصفحة في موضع index.
public XpsCanvas InsertCanvas(int index)المعلمات
index int
الموضع الذي يجب إدراج قماش جديد فيه.
العائدات
القماش المدخل.
إدراجGlyphs(int، string، float، FontStyle، float، float، string)
يُدرج رموزًا جديدة إلى الصفحة في موضع index.
public XpsGlyphs InsertGlyphs(int index, string fontFamily, float fontSize, FontStyle fontStyle, float originX, float originY, string unicodeString)المعلمات
index int
الموضع الذي يجب إدراج رموز جديدة فيه.
fontFamily string
عائلة الخط.
fontSize float
حجم الخط.
fontStyle FontStyle
نمط الخط.
originX float
إحداثيات الأصل X للرموز.
originY float
إحداثيات الأصل Y للرموز.
unicodeString string
السلسلة التي سيتم طباعتها.
العائدات
الرموز المدخلة.
إدراجGlyphs(int، XpsFont، float، float، float، string)
يُدرج رموزًا جديدة إلى الصفحة في موضع index.
public XpsGlyphs InsertGlyphs(int index, XpsFont font, float fontSize, float originX, float originY, string unicodeString)المعلمات
index int
الموضع الذي يجب إدراج رموز جديدة فيه.
font XpsFont
موارد الخط.
fontSize float
حجم الخط.
originX float
إحداثيات الأصل X للرموز.
originY float
إحداثيات الأصل Y للرموز.
unicodeString string
السلسلة التي سيتم طباعتها.
العائدات
الرموز المدخلة.
إدراجPath(int، XpsPathGeometry)
يُدرج مسارًا جديدًا إلى الصفحة في موضع index.
public XpsPath InsertPath(int index, XpsPathGeometry data)المعلمات
index int
الموضع الذي يجب إدراج مسار جديد فيه.
data XpsPathGeometry
الهندسة الخاصة بالمسار.
العائدات
المسار المدخل.
إزالة<t>(T)
يُزيل عنصرًا من الصفحة.
public T Remove<t>(T element) where T : XpsContentElementالمعلمات
element T
العنصر الذي سيتم إزالته.
العائدات
T
العنصر المزال.
معلمات النوع
T
نوع العنصر.
إزالةAt(int)
يُزيل عنصرًا في موضع index من الصفحة.
public XpsContentElement RemoveAt(int index)المعلمات
index int
الموضع الذي يجب إزالة العنصر منه.
العائدات
العنصر المزال.
