Shape

Panoramica

Shape è una classe in Aspose.Words FOSS per .NET. Eredita da: ShapeBase, ITextBox, IStrokable.

Rappresenta un oggetto nel livello di disegno, ad esempio un AutoShape, textbox, freeform, oggetto OLE, controllo ActiveX o immagine.

Questa classe fornisce 29 metodi per lavorare con oggetti Shape nei programmi .NET. I metodi disponibili includono: Accept, AcceptEnd, AcceptStart, AdjustWithEffects, AppendChild, Clone, CreateNavigator, GetAncestor, GetAncestorOf, GetChild, GetChildNodes, GetEnumerator, e 17 metodi aggiuntivi. Tutti i membri pubblici sono accessibili a qualsiasi applicazione .NET dopo l’installazione del pacchetto Aspose.Words FOSS per .NET. Proprietà: Adjustments, AllowOverlap, AlternativeText, AnchorLocked, AspectRatioLocked, BehindText, e 93 altre.

Proprietà

Nome	Tipo	Accesso	Descrizione
`NodeType`	`NodeType`	Lettura	Restituisce Shape.
`StoryType`	`StoryType`	Lettura	Restituisce Textbox.
`ExtrusionEnabled`	`bool`	Lettura	Restituisce true se è abilitato un effetto di estrusione.
`ShadowEnabled`	`bool`	Lettura	Restituisce true se è abilitato un effetto di ombra.
`Stroke`	`Stroke`	Lettura	Definisce un tratto per una forma.
`Stroked`	`bool`	Lettura/Scrittura	Definisce se il percorso verrà tracciato.
`StrokeWeight`	`double`	Lettura/Scrittura	Definisce lo spessore del pennello che traccia il percorso di una forma in punti.
`StrokeColor`	`Color`	Lettura/Scrittura	Definisce il colore di un tratto.
`Filled`	`bool`	Lettura/Scrittura	Determina se il percorso chiuso della forma verrà riempito.
`FillColor`	`Color`	Lettura/Scrittura	Definisce il colore del pennello che riempie il percorso chiuso della forma.
`HasImage`	`bool`	Lettura	Restituisce true se la forma ha byte dell’immagine o collega un’immagine.
`ImageData`	`ImageData`	Lettura	Fornisce l’accesso all’immagine della forma.
`OleFormat`	`OleFormat`	Lettura	Fornisce l’accesso ai dati OLE di una forma.
`TextBox`	`TextBox`	Lettura	Definisce gli attributi che specificano come il testo viene visualizzato in una forma.
`TextPath`	`TextPath`	Lettura	Definisce il testo del percorso di testo (di un oggetto WordArt).
`FirstParagraph`	`Paragraph`	Lettura	Ottiene il primo paragrafo nella shape.
`LastParagraph`	`Paragraph`	Lettura	Restituisce l’ultimo paragrafo nella forma.
`HorizontalRuleFormat`	`HorizontalRuleFormat`	Lettura	Fornisce l’accesso alle proprietà della forma della linea orizzontale.
`Adjustments`	`AdjustmentCollection`	Lettura	Fornisce l’accesso ai valori grezzi di regolazione di una forma.
`SignatureLine`	`SignatureLine`	Lettura	Restituisce l’oggetto `SignatureLine` se la forma è una riga di firma.
`HasChart`	`bool`	Lettura	Restituisce true se questa Shape ha un Chart.
`HasSmartArt`	`bool`	Lettura	Restituisce true se questa Shape ha un oggetto SmartArt.
`Chart`	`Chart`	Lettura	Fornisce l’accesso alle proprietà del chart se questa shape ha un Chart.
`Fill`	`Fill`	Lettura	Ottiene la formattazione di riempimento per la forma.
`ShadowFormat`	`ShadowFormat`	Lettura	Ottiene la formattazione dell’ombra per la forma.
`Glow`	`GlowFormat`	Lettura	Ottiene la formattazione di bagliore per la forma.
`Reflection`	`ReflectionFormat`	Lettura	Ottiene la formattazione del riflesso per la forma.
`SoftEdge`	`SoftEdgeFormat`	Lettura	Ottiene la formattazione del bordo morbido per la shape.
`ScreenTip`	`string`	Lettura/Scrittura	Definisce il testo visualizzato quando il puntatore del mouse si sposta sopra la forma.
`HRef`	`string`	Lettura/Scrittura	Ottiene o imposta l’indirizzo ipertestuale completo per una forma.
`Target`	`string`	Lettura/Scrittura	Ottiene o imposta il frame di destinazione per il collegamento ipertestuale della forma.
`AlternativeText`	`string`	Lettura/Scrittura	Definisce il testo alternativo da visualizzare al posto di un’immagine.
`IsDecorative`	`bool`	Lettura/Scrittura	Ottiene o imposta il flag che specifica se la forma è decorativa nel documento.
`Title`	`string`	Lettura/Scrittura	Ottiene o imposta il titolo (didascalia) dell’oggetto forma corrente.
`Name`	`string`	Lettura/Scrittura	Ottiene o imposta il nome facoltativo della forma.
`IsInsertRevision`	`bool`	Lettura	Ottiene la revisione di inserimento.
`IsDeleteRevision`	`bool`	Lettura	Ottiene la revisione di eliminazione.
`IsMoveFromRevision`	`bool`	Lettura	Ottiene lo spostamento dalla revisione.
`IsMoveToRevision`	`bool`	Lettura	Ottiene il valore di `is move to revision`.
`IsTopLevel`	`bool`	Lettura	Restituisce true se questa forma non è un figlio di una forma di gruppo.
`IsGroup`	`bool`	Lettura	Restituisce true se questa è una forma di gruppo.
`IsImage`	`bool`	Lettura	Restituisce true se questa forma è una forma immagine.
`IsHorizontalRule`	`bool`	Lettura	Restituisce true se questa forma è una regola orizzontale.
`IsWordArt`	`bool`	Lettura	Restituisce true se questa forma è un oggetto WordArt.
`CanHaveImage`	`bool`	Lettura	Restituisce true se il tipo di forma consente alla forma di avere un’immagine.
`AnchorLocked`	`bool`	Lettura/Scrittura	Specifica se l’ancora della forma è bloccata.
`AspectRatioLocked`	`bool`	Lettura/Scrittura	Specifica se il rapporto d’aspetto della forma è bloccato.
`AllowOverlap`	`bool`	Lettura/Scrittura	Ottiene o imposta un valore che specifica se questa forma può sovrapporsi ad altre forme.
`BehindText`	`bool`	Lettura/Scrittura	Specifica se la forma è sotto o sopra il testo.
`IsInline`	`bool`	Lettura	Un modo rapido per determinare se questa forma è posizionata in linea con il testo.
`Left`	`double`	Lettura/Scrittura	Ottiene o imposta la posizione del bordo sinistro del blocco contenitore della forma.
`Top`	`double`	Lettura/Scrittura	Ottiene o imposta la posizione del bordo superiore del blocco contenitore della forma.
`Right`	`double`	Lettura	Ottiene la posizione del bordo destro del blocco contenitore della forma.
`Bottom`	`double`	Lettura	Ottiene la posizione del bordo inferiore del blocco contenitore della forma.
`Width`	`double`	Lettura/Scrittura	Ottiene o imposta la larghezza del blocco contenitore della forma.
`Height`	`double`	Lettura/Scrittura	Ottiene o imposta l’altezza del blocco contenitore della forma.
`DistanceTop`	`double`	Lettura/Scrittura	Restituisce o imposta la distanza (in punti) tra il testo del documento e il bordo superiore della forma.
`DistanceBottom`	`double`	Lettura/Scrittura	Restituisce o imposta la distanza (in punti) tra il testo del documento e il bordo inferiore della forma.
`DistanceLeft`	`double`	Lettura/Scrittura	Restituisce o imposta la distanza (in punti) tra il testo del documento e il bordo sinistro della forma.
`DistanceRight`	`double`	Lettura/Scrittura	Restituisce o imposta la distanza (in punti) tra il testo del documento e il bordo destro della forma.
`Rotation`	`double`	Lettura/Scrittura	Definisce l’angolo (in gradi) con cui una forma è ruotata.
`ZOrder`	`int`	Lettura/Scrittura	Determina l’ordine di visualizzazione delle forme sovrapposte.
`ParentParagraph`	`Paragraph`	Lettura	Restituisce il paragrafo genitore immediato.
`Bounds`	`RectangleF`	Lettura/Scrittura	Ottiene o imposta la posizione e le dimensioni del blocco contenitore della shape.
`BoundsInPoints`	`RectangleF`	Lettura	Restituisce la posizione e le dimensioni del blocco contenitore della shape in punti, rispetto all’ancora della shape più esterna.
`BoundsWithEffects`	`RectangleF`	Lettura	Restituisce l’estensione finale che questo oggetto shape ha dopo l’applicazione degli effetti di disegno.
`ShapeType`	`ShapeType`	Lettura	Ottiene il tipo di forma.
`MarkupLanguage`	`ShapeMarkupLanguage`	Lettura	Ottiene MarkupLanguage usato per questo oggetto grafico.
`SizeInPoints`	`SizeF`	Lettura	Ottiene la dimensione della forma in punti.
`FlipOrientation`	`FlipOrientation`	Lettura/Scrittura	Cambia l’orientamento di una forma.
`RelativeHorizontalPosition`	`RelativeHorizontalPosition`	Lettura/Scrittura	Specifica rispetto a cosa la forma è posizionata orizzontalmente.
`RelativeVerticalPosition`	`RelativeVerticalPosition`	Lettura/Scrittura	Specifica rispetto a cosa la forma è posizionata verticalmente.
`RelativeHorizontalSize`	`RelativeHorizontalSize`	Lettura/Scrittura	Ottiene o imposta il valore della dimensione relativa della forma nella direzione orizzontale.
`RelativeVerticalSize`	`RelativeVerticalSize`	Lettura/Scrittura	Ottiene o imposta il valore della dimensione relativa della forma nella direzione verticale.
`LeftRelative`	`float`	Lettura/Scrittura	Ottiene o imposta il valore che rappresenta la posizione sinistra relativa della forma in percentuale.
`TopRelative`	`float`	Lettura/Scrittura	Ottiene o imposta il valore che rappresenta la posizione superiore relativa della forma in percentuale.
`HeightRelative`	`float`	Lettura/Scrittura	Ottiene o imposta il valore che rappresenta la percentuale dell’altezza relativa della forma.
`WidthRelative`	`float`	Lettura/Scrittura	Ottiene o imposta il valore che rappresenta la percentuale della larghezza relativa della forma.
`HorizontalAlignment`	`HorizontalAlignment`	Lettura/Scrittura	Specifica come la forma è posizionata orizzontalmente.
`VerticalAlignment`	`VerticalAlignment`	Lettura/Scrittura	Specifica come la forma è posizionata verticalmente.
`WrapType`	`WrapType`	Lettura/Scrittura	Definisce se la forma è in linea o flottante.
`WrapSide`	`WrapSide`	Lettura/Scrittura	Specifica come il testo avvolge la forma.
`CoordOrigin`	`Point`	Lettura/Scrittura	Le coordinate dell’angolo in alto a sinistra del blocco contenitore di questa forma.
`CoordSize`	`Size`	Lettura/Scrittura	La larghezza e l’altezza dello spazio coordinate all’interno del blocco contenitore di questa forma.
`Font`	`Font`	Lettura	Fornisce l’accesso alla formattazione del font di questo oggetto.
`IsSignatureLine`	`bool`	Lettura	Indica che shape è un SignatureLine.
`IsLayoutInCell`	`bool`	Lettura/Scrittura	Ottiene o imposta un flag che indica se la forma è visualizzata all’interno di una tabella o al di fuori di essa.
`Hidden`	`bool`	Lettura/Scrittura	Ottiene o imposta un valore booleano che indica se la forma è visibile.
`IsComposite`	`bool`	Lettura	Restituisce true poiché questo nodo può avere nodi figli.
`HasChildNodes`	`bool`	Lettura	Restituisce true se questo nodo ha dei nodi figli.
`FirstChild`	`Node`	Lettura	Restituisce il primo figlio del nodo.
`LastChild`	`Node`	Lettura	Ottiene l’ultimo figlio del nodo.
`Count`	`int`	Lettura	Ottiene il numero di figli immediati di questo nodo.
`ParentNode`	`CompositeNode`	Lettura	Restituisce il genitore immediato di questo nodo.
`Document`	`DocumentBase`	Lettura	Restituisce il documento a cui appartiene questo nodo.
`PreviousSibling`	`Node`	Lettura	Ottiene il nodo immediatamente precedente a questo nodo.
`NextSibling`	`Node`	Lettura	Restituisce il nodo immediatamente successivo a questo nodo.
`Range`	`Range`	Lettura	Restituisce un oggetto Range che rappresenta la porzione di un documento contenuta in questo nodo.
`CustomNodeId`	`int`	Lettura/Scrittura	Specifica un identificatore di nodo personalizzato.

Metodi

Firma	Descrizione
`Shape(doc: DocumentBase, shapeType: ShapeType)`	Crea un nuovo oggetto shape.
`Accept(visitor: DocumentVisitor)`	Chiama VisitShapeStart, poi chiama Accept per tutti i nodi figlio della shape e chiama VisitShapeEnd alla fine.
`AcceptStart(visitor: DocumentVisitor)`	Accetta un visitatore per visitare l’inizio della forma.
`AcceptEnd(visitor: DocumentVisitor)`	Accetta un visitatore per visitare la fine della forma.
`LocalToParent(value: PointF)`	Converte un valore dallo spazio di coordinate locale allo spazio di coordinate della forma genitore.
`AdjustWithEffects(source: RectangleF)`	Aggiunge al rettangolo di origine i valori dell’estensione dell’effetto e restituisce il rettangolo finale.
`GetText()`	Ottiene il testo di questo nodo e di tutti i suoi figli.
`GetChildNodes(nodeType: NodeType, isDeep: bool)`	Restituisce una raccolta di nodi figlio che corrispondono al tipo specificato.
`GetChild(nodeType: NodeType, index: int, isDeep: bool)`	Restituisce il N-esimo nodo figlio che corrisponde al tipo specificato.
`SelectNodes(xpath: string)`	Seleziona un elenco di nodi che corrispondono all’espressione XPath.
`SelectSingleNode(xpath: string)`	Seleziona il primo Node che corrisponde all’espressione XPath.
`GetEnumerator()`	Fornisce supporto per l’iterazione in stile for each sui nodi figli di questo nodo.
`AppendChild(newChild: T)`	Aggiunge il nodo specificato alla fine dell’elenco dei nodi figli di questo nodo.
`PrependChild(newChild: T)`	Aggiunge il nodo specificato all’inizio dell’elenco dei nodi figli di questo nodo.
`InsertAfter(newChild: T, refChild: Node)`	Inserisce il nodo specificato immediatamente dopo il nodo di riferimento specificato.
`InsertBefore(newChild: T, refChild: Node)`	Inserisce il nodo specificato immediatamente prima del nodo di riferimento specificato.
`RemoveChild(oldChild: T)`	Rimuove il nodo figlio specificato.
`RemoveAllChildren()`	Rimuove tutti i nodi figlio del nodo corrente.
`RemoveSmartTags()`	Rimuove tutti i nodi discendenti SmartTag del nodo corrente.
`IndexOf(child: Node)`	Restituisce l’indice del nodo figlio specificato nell’array dei nodi figlio.
`CreateNavigator()`	Crea un navigatore che può essere utilizzato per attraversare e leggere i nodi.
`Clone(isCloneChildren: bool)`	Dovresti usare il sovraccarico Clone(bool, INodeCloningListener) quando la clonazione del nodo è parte di un altro processo di clonazione di nodi (di solito composito).
`GetAncestor(ancestorType: Type)`	Ottiene il primo antenato del tipo di oggetto specificato.
`GetAncestorOf()`	Chiama GetAncestorOf su questa istanza di Shape.
`Remove()`	Si rimuove dal genitore.
`NextPreOrder(rootNode: Node)`	Ottiene il nodo successivo secondo l’algoritmo di attraversamento pre-order dell’albero.
`PreviousPreOrder(rootNode: Node)`	Ottiene il nodo precedente secondo l’algoritmo di attraversamento pre-order dell’albero.
`ToString(saveFormat: SaveFormat)`	Esporta il contenuto del nodo in una stringa nel formato specificato.
`NodeTypeToString(nodeType: NodeType)`	Un metodo di utilità che converte un valore enum di tipo nodo in una stringa amichevole per l’utente.

Vedi anche

Aspose.Words for .NET — Enterprise API Reference