Class PageAPI
Namespace: Aspose.Page.XPS.Features.EventBasedModifications
Assembly: Aspose.Page.dll (25.1.2)
L’API di modifica dell’elemento Page.
public class PageAPI : IModificationAPIEreditarietà
Implementa
Membri ereditati
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Proprietà
Altezza
Restituisce/imposta l’altezza della pagina, espressa come numero reale in unità dello spazio delle coordinate effettive.
public float Height { get; set; }Valore della Proprietà
NumeroDiPagine
Restituisce il numero di pagine nel documento attivo.
public int PageCount { get; }Valore della Proprietà
NumeroTotaleDiPagine
Restituisce il numero totale di pagine in tutti i documenti all’interno del documento XPS.
public int TotalPageCount { get; }Valore della Proprietà
Utils
Ottiene l’oggetto che fornisce utilità oltre l’API formale di manipolazione XPS.
public DocumentUtils Utils { get; }Valore della Proprietà
Larghezza
Restituisce/imposta la larghezza della pagina, espressa come numero reale in unità dello spazio delle coordinate effettive.
public float Width { get; set; }Valore della Proprietà
Metodi
Aggiungi<t>(T)
Aggiunge un elemento di contenuto (Canvas, Path o Glyphs).
public T Add<t>(T element) where T : XpsContentElementParametri
element T
Elemento da aggiungere.
Restituisce
T
Elemento aggiunto.
Parametri di Tipo
T
Il tipo dell’elemento.
AggiungiCanvas()
Aggiunge un nuovo canvas alla pagina.
public XpsCanvas AddCanvas()Restituisce
Canvas aggiunto.
AggiungiGlyphs(string, float, FontStyle, float, float, string)
Aggiunge nuovi glifi alla pagina.
public XpsGlyphs AddGlyphs(string fontFamily, float fontRenderingEmSize, FontStyle fontStyle, float originX, float originY, string unicodeString)Parametri
fontFamily string
Famiglia di font.
fontRenderingEmSize float
Dimensione del font.
fontStyle FontStyle
Stile del font.
originX float
Coordinata X di origine dei glifi.
originY float
Coordinata Y di origine dei glifi.
unicodeString string
Stringa da stampare.
Restituisce
Glifi aggiunti.
AggiungiGlyphs(XpsFont, float, float, float, string)
Aggiunge nuovi glifi alla pagina.
public XpsGlyphs AddGlyphs(XpsFont font, float fontRenderingEmSize, float originX, float originY, string unicodeString)Parametri
font XpsFont
Risorsa font.
fontRenderingEmSize float
Dimensione del font.
originX float
Coordinata X di origine dei glifi.
originY float
Coordinata Y di origine dei glifi.
unicodeString string
Stringa da stampare.
Restituisce
Glifi aggiunti.
AggiungiVoceDiOutline(string, int, int)
Aggiunge una voce di outline al documento.
public void AddOutlineEntry(string description, int outlineLevel, int targetPageNumber)Parametri
description string
La descrizione della voce.
outlineLevel int
Il livello di outline.
targetPageNumber int
Il numero di pagina target.
AggiungiPath(XpsPathGeometry)
Aggiunge un nuovo percorso alla pagina.
public XpsPath AddPath(XpsPathGeometry data)Parametri
data XpsPathGeometry
La geometria del percorso.
Restituisce
Percorso aggiunto.
CreaArcSegment(PointF, SizeF, float, bool, XpsSweepDirection, bool)
Crea un nuovo segmento ad arco ellittico.
public XpsArcSegment CreateArcSegment(PointF point, SizeF size, float rotationAngle, bool isLargeArc, XpsSweepDirection sweepDirection, bool isStroked = true)Parametri
point PointF
Il punto finale dell’arco ellittico.
size SizeF
Il raggio x e y dell’arco ellittico come coppia x,y.
rotationAngle float
Indica come l’ellisse è ruotata rispetto al sistema di coordinate corrente.
isLargeArc bool
Determina se l’arco è disegnato con un’ampiezza di 180 o maggiore.
sweepDirection XpsSweepDirection
La direzione in cui l’arco è disegnato.
isStroked bool
Specifica se il tratto per questo segmento del percorso è disegnato.
Restituisce
Nuovo segmento ad arco ellittico.
CreaCanvas()
Crea un nuovo canvas.
public XpsCanvas CreateCanvas()Restituisce
Nuovo canvas.
CreaColore(Color)
Crea un nuovo colore.
public XpsColor CreateColor(Color color)Parametri
color Color
Un’istanza di colore nativo per il colore RGB.
Restituisce
Nuovo colore.
CreaColore(int, int, int, int)
Crea un nuovo colore nello spazio colore sRGB.
public XpsColor CreateColor(int a, int r, int g, int b)Parametri
a int
Il componente di colore alpha.
r int
Il componente di colore rosso.
g int
Il componente di colore verde.
b int
Il componente di colore blu.
Restituisce
Nuovo colore.
CreaColore(int, int, int)
Crea un nuovo colore nello spazio colore sRGB.
public XpsColor CreateColor(int r, int g, int b)Parametri
r int
Il componente di colore rosso.
g int
Il componente di colore verde.
b int
Il componente di colore blu.
Restituisce
Nuovo colore.
CreaColore(float, float, float, float)
Crea un nuovo colore nello spazio colore scRGB.
public XpsColor CreateColor(float a, float r, float g, float b)Parametri
a float
Il componente di colore alpha.
r float
Il componente di colore rosso.
g float
Il componente di colore verde.
b float
Il componente di colore blu.
Restituisce
Nuovo colore.
CreaColore(float, float, float)
Crea un nuovo colore nello spazio colore scRGB.
public XpsColor CreateColor(float r, float g, float b)Parametri
r float
Il componente di colore rosso.
g float
Il componente di colore verde.
b float
Il componente di colore blu.
Restituisce
Nuovo colore.
CreaColore(string, params float[])
Crea un nuovo colore nello spazio colore basato su ICC.
public XpsColor CreateColor(string path, params float[] components)Parametri
path string
Il percorso per il profilo ICC.
components float[]
Componenti di colore.
Restituisce
Nuovo colore.
CreaColore(XpsIccProfile, params float[])
Crea un nuovo colore nello spazio colore basato su ICC.
public XpsColor CreateColor(XpsIccProfile iccProfile, params float[] components)Parametri
iccProfile XpsIccProfile
La risorsa del profilo ICC.
components float[]
Componenti di colore.
Restituisce
Nuovo colore.
CreaGlyphs(string, float, FontStyle, float, float, string)
Crea nuovi glifi.
public XpsGlyphs CreateGlyphs(string fontFamily, float fontRenderingEmSize, FontStyle fontStyle, float originX, float originY, string unicodeString)Parametri
fontFamily string
Famiglia di font.
fontRenderingEmSize float
Dimensione del font.
fontStyle FontStyle
Stile del font.
originX float
Coordinata X di origine dei glifi.
originY float
Coordinata Y di origine dei glifi.
unicodeString string
Stringa da stampare.
Restituisce
Nuovi glifi.
CreaGlyphs(XpsFont, float, float, float, string)
Crea nuovi glifi.
public XpsGlyphs CreateGlyphs(XpsFont font, float fontRenderingEmSize, float originX, float originY, string unicodeString)Parametri
font XpsFont
Risorsa font.
fontRenderingEmSize float
Dimensione del font.
originX float
Coordinata X di origine dei glifi.
originY float
Coordinata Y di origine dei glifi.
unicodeString string
Stringa da stampare.
Restituisce
Nuovi glifi.
CreaGradientStop(XpsColor, float)
Crea un nuovo gradiente di stop.
public XpsGradientStop CreateGradientStop(XpsColor color, float offset)Parametri
color XpsColor
Il colore del gradiente di stop.
offset float
L’offset del gradiente.
Restituisce
Nuovo gradiente di stop.
CreaGradientStop(Color, float)
Crea un nuovo gradiente di stop.
public XpsGradientStop CreateGradientStop(Color color, float offset)Parametri
color Color
Il colore del gradiente di stop.
offset float
L’offset del gradiente.
Restituisce
Nuovo gradiente di stop.
CreaImageBrush(XpsImage, RectangleF, RectangleF)
Crea un nuovo pennello immagine.
public XpsImageBrush CreateImageBrush(XpsImage image, RectangleF viewbox, RectangleF viewport)Parametri
image XpsImage
Una risorsa immagine.
viewbox RectangleF
La posizione e le dimensioni del contenuto sorgente del pennello.
viewport RectangleF
La regione nello spazio delle coordinate contenente il tile principale del pennello che viene (possibilmente ripetutamente) applicato per riempire la regione a cui è applicato il pennello.
Restituisce
Nuovo pennello immagine.
CreaImageBrush(string, RectangleF, RectangleF)
Crea un nuovo pennello immagine.
public XpsImageBrush CreateImageBrush(string imagePath, RectangleF viewbox, RectangleF viewport)Parametri
imagePath string
Il percorso all’immagine da utilizzare come tile del pennello.
viewbox RectangleF
La posizione e le dimensioni del contenuto sorgente del pennello.
viewport RectangleF
La regione nello spazio delle coordinate contenente il tile principale del pennello che viene (possibilmente ripetutamente) applicato per riempire la regione a cui è applicato il pennello.
Restituisce
Nuovo pennello immagine.
CreaLinearGradientBrush(List<xpsgradientstop>, PointF, PointF)
Crea un nuovo pennello gradiente lineare.
public XpsLinearGradientBrush CreateLinearGradientBrush(List<xpsgradientstop> gradientStops, PointF startPoint, PointF endPoint)Parametri
gradientStops List<XpsGradientStop>
La lista di stop del gradiente.
startPoint PointF
Il punto di partenza del gradiente lineare.
endPoint PointF
Il punto finale del gradiente lineare.
Restituisce
Nuovo pennello gradiente lineare.
CreaLinearGradientBrush(PointF, PointF)
Crea un nuovo pennello gradiente lineare.
public XpsLinearGradientBrush CreateLinearGradientBrush(PointF startPoint, PointF endPoint)Parametri
startPoint PointF
Il punto di partenza del gradiente lineare.
endPoint PointF
Il punto finale del gradiente lineare.
Restituisce
Nuovo pennello gradiente lineare.
CreaMatrix(float, float, float, float, float, float)
Crea una nuova matrice di trasformazione affine.
public XpsMatrix CreateMatrix(float m11, float m12, float m21, float m22, float m31, float m32)Parametri
m11 float
Elemento 11.
m12 float
Elemento 12.
m21 float
Elemento 21.
m22 float
Elemento 22.
m31 float
Elemento 31.
m32 float
Elemento 32.
Restituisce
Nuova matrice di trasformazione affine.
CreaPath(XpsPathGeometry)
Crea un nuovo percorso.
public XpsPath CreatePath(XpsPathGeometry data)Parametri
data XpsPathGeometry
La geometria del percorso.
Restituisce
Nuovo percorso.
CreaPathFigure(PointF, bool)
Crea una nuova figura di percorso.
public XpsPathFigure CreatePathFigure(PointF startPoint, bool isClosed = false)Parametri
startPoint PointF
Il punto di partenza per il primo segmento della figura di percorso.
isClosed bool
Specifica se il percorso è chiuso. Se impostato su true, il tratto è disegnato “chiuso”, cioè, l’ultimo punto nell’ultimo segmento della figura di percorso è connesso con il punto specificato nell’attributo StartPoint, altrimenti il tratto è disegnato “aperto”, e l’ultimo punto non è connesso al punto di partenza. Applicabile solo se la figura di percorso è utilizzata in un elemento Path che specifica un tratto.
Restituisce
Nuova figura di percorso.
CreaPathFigure(PointF, List, bool)
Crea una nuova figura di percorso.
public XpsPathFigure CreatePathFigure(PointF startPoint, List<xpspathsegment> segments, bool isClosed = false)Parametri
startPoint PointF
Il punto di partenza per il primo segmento della figura di percorso.
segments List<XpsPathSegment>
Lista di segmenti di percorso.
isClosed bool
Specifica se il percorso è chiuso. Se impostato su true, il tratto è disegnato “chiuso”, cioè, l’ultimo punto nell’ultimo segmento della figura di percorso è connesso con il punto specificato nell’attributo StartPoint, altrimenti il tratto è disegnato “aperto”, e l’ultimo punto non è connesso al punto di partenza. Applicabile solo se la figura di percorso è utilizzata in un elemento Path che specifica un tratto.
Restituisce
Nuova figura di percorso.
CreaPathGeometry(string)
Crea una nuova geometria di percorso specificata con forma abbreviata.
public XpsPathGeometry CreatePathGeometry(string abbreviatedGeometry)Parametri
abbreviatedGeometry string
Forma abbreviata della geometria del percorso.
Restituisce
Nuova geometria di percorso.
CreaPathGeometry()
Crea una nuova geometria di percorso.
public XpsPathGeometry CreatePathGeometry()Restituisce
Nuova geometria di percorso.
CreaPathGeometry(List<xpspathfigure>)
Crea una nuova geometria di percorso con una lista specificata di figure di percorso.
public XpsPathGeometry CreatePathGeometry(List<xpspathfigure> pathFigures)Parametri
pathFigures List<XpsPathFigure>
Lista di figure di percorso.
Restituisce
Nuova geometria di percorso.
CreaPolyBezierSegment(PointF[], bool)
Crea un nuovo insieme di curve Bézier cubiche.
public XpsPolyBezierSegment CreatePolyBezierSegment(PointF[] points, bool isStroked = true)Parametri
points PointF[]
Punti di controllo per più segmenti Bézier.
isStroked bool
Specifica se il tratto per questo segmento del percorso è disegnato.
Restituisce
Nuovo segmento di curve Bézier cubiche.
CreaPolyLineSegment(PointF[], bool)
Crea un nuovo disegno poligonale contenente un numero arbitrario di vertici individuali.
public XpsPolyLineSegment CreatePolyLineSegment(PointF[] points, bool isStroked = true)Parametri
points PointF[]
Un insieme di coordinate per i segmenti multipli che definiscono il segmento della polilinea.
isStroked bool
Specifica se il tratto per questo segmento del percorso è disegnato.
Restituisce
Nuovo segmento di disegno poligonale.
CreaPolyQuadraticBezierSegment(PointF[], bool)
Crea un nuovo insieme di curve Bézier quadratiche dal punto precedente nella figura di percorso attraverso un insieme di vertici, utilizzando punti di controllo specificati.
public XpsPolyQuadraticBezierSegment CreatePolyQuadraticBezierSegment(PointF[] points, bool isStroked = true)Parametri
points PointF[]
Punti di controllo per più segmenti Bézier quadratici.
isStroked bool
Specifica se il tratto per questo segmento del percorso è disegnato.
Restituisce
Nuovo segmento di curve Bézier quadratiche.
CreaRadialGradientBrush(List<xpsgradientstop>, PointF, PointF, float, float)
Crea un nuovo pennello gradiente radiale.
public XpsRadialGradientBrush CreateRadialGradientBrush(List<xpsgradientstop> gradientStops, PointF center, PointF gradientOrigin, float radiusX, float radiusY)Parametri
gradientStops List<XpsGradientStop>
La lista di stop del gradiente.
center PointF
Il punto centrale del gradiente radiale (cioè, il centro dell’ellisse).
gradientOrigin PointF
Il punto di origine del gradiente radiale.
radiusX float
Il raggio nella dimensione x dell’ellisse che definisce il gradiente radiale.
radiusY float
Il raggio nella dimensione y dell’ellisse che definisce il gradiente radiale.
Restituisce
Nuovo pennello gradiente radiale.
CreaRadialGradientBrush(PointF, PointF, float, float)
Crea un nuovo pennello gradiente radiale.
public XpsRadialGradientBrush CreateRadialGradientBrush(PointF center, PointF gradientOrigin, float radiusX, float radiusY)Parametri
center PointF
Il punto centrale del gradiente radiale (cioè, il centro dell’ellisse).
gradientOrigin PointF
Il punto di origine del gradiente radiale.
radiusX float
Il raggio nella dimensione x dell’ellisse che definisce il gradiente radiale.
radiusY float
Il raggio nella dimensione y dell’ellisse che definisce il gradiente radiale.
Restituisce
Nuovo pennello gradiente radiale.
CreaSolidColorBrush(XpsColor)
Crea un nuovo pennello di colore solido.
public XpsSolidColorBrush CreateSolidColorBrush(XpsColor color)Parametri
color XpsColor
Il colore per gli elementi riempiti.
Restituisce
Nuovo pennello di colore solido.
CreaSolidColorBrush(Color)
Crea un nuovo pennello di colore solido.
public XpsSolidColorBrush CreateSolidColorBrush(Color color)Parametri
color Color
Il colore per gli elementi riempiti.
Restituisce
Nuovo pennello di colore solido.
CreaVisualBrush(XpsContentElement, RectangleF, RectangleF)
Crea un nuovo pennello visivo.
public XpsVisualBrush CreateVisualBrush(XpsContentElement element, RectangleF viewbox, RectangleF viewport)Parametri
element XpsContentElement
L’elemento XPS (Canvas, Path o Glyphs) per la proprietà Visual del pennello visivo.
viewbox RectangleF
La posizione e le dimensioni del contenuto sorgente del pennello.
viewport RectangleF
La regione nello spazio delle coordinate contenente il tile principale del pennello che viene (possibilmente ripetutamente) applicato per riempire la regione a cui è applicato il pennello.
Restituisce
Nuovo pennello visivo.
Inserisci<t>(int, T)
Inserisce un elemento (Canvas, Path o Glyphs) nella pagina nella posizione index.
public T Insert<t>(int index, T element) where T : XpsContentElementParametri
index int
Posizione in cui un element deve essere inserito.
element T
Elemento da inserire.
Restituisce
T
Elemento inserito.
Parametri di Tipo
T
Il tipo dell’elemento.
InserisciCanvas(int)
Inserisce un nuovo canvas nella pagina nella posizione index.
public XpsCanvas InsertCanvas(int index)Parametri
index int
Posizione in cui deve essere inserito un nuovo canvas.
Restituisce
Canvas inserito.
InserisciGlyphs(int, string, float, FontStyle, float, float, string)
Inserisce nuovi glifi nella pagina nella posizione index.
public XpsGlyphs InsertGlyphs(int index, string fontFamily, float fontSize, FontStyle fontStyle, float originX, float originY, string unicodeString)Parametri
index int
Posizione in cui devono essere inseriti nuovi glifi.
fontFamily string
Famiglia di font.
fontSize float
Dimensione del font.
fontStyle FontStyle
Stile del font.
originX float
Coordinata X di origine dei glifi.
originY float
Coordinata Y di origine dei glifi.
unicodeString string
Stringa da stampare.
Restituisce
Glifi inseriti.
InserisciGlyphs(int, XpsFont, float, float, float, string)
Inserisce nuovi glifi nella pagina nella posizione index.
public XpsGlyphs InsertGlyphs(int index, XpsFont font, float fontSize, float originX, float originY, string unicodeString)Parametri
index int
Posizione in cui devono essere inseriti nuovi glifi.
font XpsFont
Risorsa font.
fontSize float
Dimensione del font.
originX float
Coordinata X di origine dei glifi.
originY float
Coordinata Y di origine dei glifi.
unicodeString string
Stringa da stampare.
Restituisce
Glifi inseriti.
InserisciPath(int, XpsPathGeometry)
Inserisce un nuovo percorso nella pagina nella posizione index.
public XpsPath InsertPath(int index, XpsPathGeometry data)Parametri
index int
Posizione in cui deve essere inserito un nuovo percorso.
data XpsPathGeometry
La geometria del percorso.
Restituisce
Percorso inserito.
Rimuovi<t>(T)
Rimuove un elemento dalla pagina.
public T Remove<t>(T element) where T : XpsContentElementParametri
element T
Elemento da rimuovere.
Restituisce
T
Elemento rimosso.
Parametri di Tipo
T
Il tipo dell’elemento.
RimuoviAt(int)
Rimuove un elemento nella posizione index dalla pagina.
public XpsContentElement RemoveAt(int index)Parametri
index int
Posizione in cui deve essere rimosso l’elemento.
Restituisce
Elemento rimosso.
