ShapeBase
ShapeBase class
Classe base per oggetti nel livello di disegno, ad esempio forme, forme libere, oggetti OLE, controlli ActiveX o immagini.
Per saperne di più, visita ilLavorare con le forme articolo di documentazione.
public abstract class ShapeBase : CompositeNode
Proprietà
Nome | Descrizione |
---|---|
AllowOverlap { get; set; } | Ottiene o imposta un valore che specifica se questa forma può sovrapporsi ad altre forme. |
AlternativeText { get; set; } | Definisce il testo alternativo da visualizzare al posto dell’immagine. |
AnchorLocked { get; set; } | Specifica se l’ancoraggio della forma è bloccato. |
AspectRatioLocked { get; set; } | Specifica se le proporzioni della forma sono bloccate. |
BehindText { get; set; } | Specifica se la forma è sotto o sopra il testo. |
Bottom { get; } | Ottiene la posizione del bordo inferiore del blocco contenitore della forma. |
Bounds { get; set; } | Ottiene o imposta la posizione e la dimensione del blocco contenitore della forma. |
BoundsInPoints { get; } | Ottiene la posizione e la dimensione del blocco contenitore della forma in punti, rispetto all’ancoraggio della forma più in alto. |
BoundsWithEffects { get; } | Ottiene l’estensione finale dell’oggetto forma dopo l’applicazione degli effetti di disegno. Il valore è misurato in punti. |
CanHaveImage { get; } | RestituisceVERO se il tipo di forma consente alla forma di avere un’immagine. |
CoordOrigin { get; set; } | Le coordinate nell’angolo in alto a sinistra del blocco contenitore di questa forma. |
CoordSize { get; set; } | La larghezza e l’altezza dello spazio delle coordinate all’interno del blocco contenitore di questa forma. |
Count { get; } | Ottiene il numero di figli immediati di questo nodo. |
CustomNodeId { get; set; } | Specifica l’identificatore del nodo personalizzato. |
DistanceBottom { get; set; } | Restituisce o imposta la distanza (in punti) tra il testo del documento e il bordo inferiore della forma. |
DistanceLeft { get; set; } | Restituisce o imposta la distanza (in punti) tra il testo del documento e il bordo sinistro della forma. |
DistanceRight { get; set; } | Restituisce o imposta la distanza (in punti) tra il testo del documento e il bordo destro della forma. |
DistanceTop { get; set; } | Restituisce o imposta la distanza (in punti) tra il testo del documento e il bordo superiore della forma. |
virtual Document { get; } | Ottiene il documento a cui appartiene questo nodo. |
Fill { get; } | Ottiene la formattazione di riempimento per la forma. |
FirstChild { get; } | Ottiene il primo figlio del nodo. |
FlipOrientation { get; set; } | Cambia l’orientamento di una forma. |
Font { get; } | Fornisce l’accesso alla formattazione dei caratteri di questo oggetto. |
HasChildNodes { get; } | RestituisceVERO se questo nodo ha nodi figli. |
Height { get; set; } | Ottiene o imposta l’altezza del blocco contenitore della forma. |
HeightRelative { get; set; } | Ottiene o imposta il valore che rappresenta la percentuale dell’altezza relativa della forma. |
HorizontalAlignment { get; set; } | Specifica come viene posizionata la forma orizzontalmente. |
HRef { get; set; } | Ottiene o imposta l’indirizzo completo del collegamento ipertestuale per una forma. |
override IsComposite { get; } | RestituisceVERO poiché questo nodo può avere nodi figli. |
IsDecorative { get; set; } | Ottiene o imposta il flag che specifica se la forma è decorativa nel documento. |
IsDeleteRevision { get; } | Restituisce vero se questo oggetto è stato eliminato in Microsoft Word mentre era abilitato il rilevamento delle modifiche. |
IsGroup { get; } | RestituisceVERO se questa è una forma di gruppo. |
IsHorizontalRule { get; } | RestituisceVERO se questa forma è una riga orizzontale. |
IsImage { get; } | RestituisceVERO se questa forma è una forma immagine. |
IsInline { get; } | Un modo rapido per determinare se questa forma è posizionata in linea con il testo. |
IsInsertRevision { get; } | Restituisce vero se questo oggetto è stato inserito in Microsoft Word mentre il rilevamento delle modifiche era abilitato. |
IsLayoutInCell { get; set; } | Ottiene o imposta un flag che indica se la forma viene visualizzata all’interno o all’esterno di una tabella. |
IsMoveFromRevision { get; } | RestituisceVERO se questo oggetto è stato spostato (eliminato) in Microsoft Word mentre il rilevamento delle modifiche era abilitato. |
IsMoveToRevision { get; } | RestituisceVERO se questo oggetto è stato spostato (inserito) in Microsoft Word mentre il rilevamento delle modifiche era abilitato. |
IsSignatureLine { get; } | Indica che la forma è aSignatureLine . |
IsTopLevel { get; } | RestituisceVERO se questa forma non è figlia di una forma di gruppo. |
IsWordArt { get; } | RestituisceVERO se questa forma è un oggetto WordArt. |
LastChild { get; } | Ottiene l’ultimo figlio del nodo. |
Left { get; set; } | Ottiene o imposta la posizione del bordo sinistro del blocco contenitore della forma. |
LeftRelative { get; set; } | Ottiene o imposta il valore che rappresenta la posizione relativa a sinistra della forma in percentuale. |
MarkupLanguage { get; } | Ottiene MarkupLanguage utilizzato per questo oggetto grafico. |
Name { get; set; } | Ottiene o imposta il nome della forma opzionale. |
NextSibling { get; } | Ottiene il nodo immediatamente successivo a questo nodo. |
abstract NodeType { get; } | Ottiene il tipo di questo nodo. |
ParentNode { get; } | Ottiene il genitore immediato di questo nodo. |
ParentParagraph { get; } | Restituisce il paragrafo principale immediato. |
PreviousSibling { get; } | Ottiene il nodo immediatamente precedente questo nodo. |
Range { get; } | Restituisce aRange oggetto che rappresenta la porzione di documento contenuta in questo nodo. |
RelativeHorizontalPosition { get; set; } | Specifica in relazione a come è posizionata la forma orizzontalmente. |
RelativeHorizontalSize { get; set; } | Ottiene o imposta il valore della dimensione relativa della forma nella direzione orizzontale. |
RelativeVerticalPosition { get; set; } | Specifica rispetto a come è posizionata verticalmente la forma. |
RelativeVerticalSize { get; set; } | Ottiene o imposta il valore della dimensione relativa della forma in direzione verticale. |
Right { get; } | Ottiene la posizione del bordo destro del blocco contenitore della forma. |
Rotation { get; set; } | Definisce l’angolo (in gradi) di rotazione di una forma. Il valore positivo corrisponde all’angolo di rotazione in senso orario. |
ScreenTip { get; set; } | Definisce il testo visualizzato quando il puntatore del mouse si sposta sulla forma. |
ShadowFormat { get; } | Ottiene la formattazione dell’ombra per la forma. |
ShapeType { get; } | Ottiene il tipo di forma. |
SizeInPoints { get; } | Ottiene la dimensione della forma in punti. |
Target { get; set; } | Ottiene o imposta il frame di destinazione per il collegamento ipertestuale della forma. |
Title { get; set; } | Ottiene o imposta il titolo (didascalia) dell’oggetto forma corrente. |
Top { get; set; } | Ottiene o imposta la posizione del bordo superiore del blocco contenitore della forma. |
TopRelative { get; set; } | Ottiene o imposta il valore che rappresenta la posizione superiore relativa della forma in percentuale. |
VerticalAlignment { get; set; } | Specifica come viene posizionata la forma verticalmente. |
Width { get; set; } | Ottiene o imposta la larghezza del blocco contenitore della forma. |
WidthRelative { get; set; } | Ottiene o imposta il valore che rappresenta la percentuale della larghezza relativa della forma. |
WrapSide { get; set; } | Specifica come il testo viene disposto attorno alla forma. |
WrapType { get; set; } | Definisce se la forma è in linea o mobile. Per le forme fluttuanti definisce la modalità di disposizione del testo attorno alla forma. |
ZOrder { get; set; } | Determina l’ordine di visualizzazione delle forme sovrapposte. |
Metodi
Nome | Descrizione |
---|---|
abstract Accept(DocumentVisitor) | Accetta un visitatore. |
AdjustWithEffects(RectangleF) | Aggiunge al rettangolo di origine i valori dell’estensione dell’effetto e restituisce il rettangolo finale. |
AppendChild(Node) | Aggiunge il nodo specificato alla fine dell’elenco dei nodi secondari per questo nodo. |
Clone(bool) | Crea un duplicato del nodo. |
CreateNavigator() | Crea un navigatore che può essere utilizzato per attraversare e leggere i nodi. |
FetchInheritedShapeAttr(int) | Riservato per l’uso del sistema. IShapeAttrSource. |
FetchShapeAttr(int) | Riservato per l’uso del sistema. IShapeAttrSource. |
GetAncestor(NodeType) | Ottiene il primo antenato dell’oggetto specificatoNodeType . |
GetAncestor(Type) | Ottiene il primo antenato del tipo di oggetto specificato. |
GetChild(NodeType, int, bool) | Restituisce un Nesimo nodo figlio che corrisponde al tipo specificato. |
GetChildNodes(NodeType, bool) | Restituisce una raccolta attiva di nodi secondari che corrispondono al tipo specificato. |
GetDirectShapeAttr(int) | Riservato per l’uso del sistema. IShapeAttrSource. |
GetEnumerator() | Fornisce il supporto per l’iterazione di ogni stile sui nodi figlio di questo nodo. |
GetShapeRenderer() | Crea e restituisce un oggetto che può essere utilizzato per eseguire il rendering di questa forma in un’immagine. |
override GetText() | Ottiene il testo di questo nodo e di tutti i suoi figli. |
IndexOf(Node) | Restituisce l’indice del nodo figlio specificato nell’array di nodi figlio. |
InsertAfter(Node, Node) | Inserisce il nodo specificato immediatamente dopo il nodo di riferimento specificato. |
InsertBefore(Node, Node) | Inserisce il nodo specificato immediatamente prima del nodo di riferimento specificato. |
LocalToParent(PointF) | Converte un valore dallo spazio delle coordinate locali nello spazio delle coordinate della forma genitore. |
NextPreOrder(Node) | Ottiene il nodo successivo in base all’algoritmo di attraversamento dell’albero di preordine. |
PrependChild(Node) | Aggiunge il nodo specificato all’inizio dell’elenco dei nodi secondari per questo nodo. |
PreviousPreOrder(Node) | Ottiene il nodo precedente in base all’algoritmo di attraversamento dell’albero di preordine. |
Remove() | Si rimuove dal genitore. |
RemoveAllChildren() | Rimuove tutti i nodi figlio del nodo corrente. |
RemoveChild(Node) | Rimuove il nodo figlio specificato. |
RemoveShapeAttr(int) | Riservato per l’uso del sistema. IShapeAttrSource. |
RemoveSmartTags() | Rimuove tuttoSmartTag nodi discendenti del nodo corrente. |
SelectNodes(string) | Seleziona un elenco di nodi che corrispondono all’espressione XPath. |
SelectSingleNode(string) | Seleziona il primoNode che corrisponde all’espressione XPath. |
SetShapeAttr(int, object) | Riservato per l’uso del sistema. IShapeAttrSource. |
ToString(SaveFormat) | Esporta il contenuto del nodo in una stringa nel formato specificato. |
ToString(SaveOptions) | Esporta il contenuto del nodo in una stringa utilizzando le opzioni di salvataggio specificate. |
Osservazioni
Questa è una classe astratta. Le due classi derivate che puoi istanziare sonoShape
EGroupShape
.
Una forma è un nodo nell’albero del documento.
Se la forma è figlia di aParagraph
oggetto, la forma viene definita “di livello superiore”. Le forme di livello superiore vengono misurate e posizionate in punti.
Una forma può anche presentarsi come figlia di aGroupShape
oggetto quando sono raggruppate più forme . Le forme figlie di una forma di gruppo sono posizionate nello spazio delle coordinate e nelle unità definite daCoordSize
ECoordOrigin
proprietà della forma del gruppo parent .
Una forma può essere posizionata in linea con il testo o mobile. Il metodo di posizionamento è controllato utilizzando ilWrapType
proprietà.
Quando una forma è fluttuante, è posizionata rispetto a qualcosa (ad esempio il paragrafo corrente, il margine o la pagina). Il posizionamento relativo della forma viene specificato utilizzando RelativeHorizontalPosition
ERelativeVerticalPosition
proprietà.
Una forma mobile può essere posizionata esplicitamente utilizzando il metodoLeft
ETop
proprietà o allineate rispetto ad altri oggetti utilizzando il fileHorizontalAlignment
eVerticalAlignment
proprietà.
Esempi
Mostra come inserire un’immagine mobile al centro di una pagina.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Inserisci un'immagine mobile che apparirà dietro il testo sovrapposto e allineala al centro della pagina.
Shape shape = builder.InsertImage(ImageDir + "Logo.jpg");
shape.WrapType = WrapType.None;
shape.BehindText = true;
shape.RelativeHorizontalPosition = RelativeHorizontalPosition.Page;
shape.RelativeVerticalPosition = RelativeVerticalPosition.Page;
shape.HorizontalAlignment = HorizontalAlignment.Center;
shape.VerticalAlignment = VerticalAlignment.Center;
doc.Save(ArtifactsDir + "Image.CreateFloatingPageCenter.docx");
Guarda anche
- class CompositeNode
- spazio dei nomi Aspose.Words.Drawing
- assemblea Aspose.Words