Shape

Visão geral

Shape é uma classe em Aspose.Words FOSS para .NET. Herda de: ShapeBase, ITextBox, IStrokable.

Representa um objeto na camada de desenho, como um AutoShape, caixa de texto, forma livre, objeto OLE, controle ActiveX ou imagem.

Esta classe fornece 29 métodos para trabalhar com objetos Shape em programas .NET. Os métodos disponíveis incluem: Accept, AcceptEnd, AcceptStart, AdjustWithEffects, AppendChild, Clone, CreateNavigator, GetAncestor, GetAncestorOf, GetChild, GetChildNodes, GetEnumerator e 17 métodos adicionais. Todos os membros públicos estão acessíveis a qualquer aplicação .NET após a instalação do pacote Aspose.Words FOSS para .NET. Propriedades: Adjustments, AllowOverlap, AlternativeText, AnchorLocked, AspectRatioLocked, BehindText e mais 93.

Propriedades

Nome	Tipo	Acesso	Descrição
`NodeType`	`NodeType`	Leitura	Retorna Shape.
`StoryType`	`StoryType`	Leitura	Retorna Textbox.
`ExtrusionEnabled`	`bool`	Leitura	Retorna true se o efeito de extrusão estiver ativado.
`ShadowEnabled`	`bool`	Leitura	Retorna true se o efeito de sombra estiver ativado.
`Stroke`	`Stroke`	Leitura	Define um traço para uma forma.
`Stroked`	`bool`	Leitura/Escrita	Define se o caminho será traçado.
`StrokeWeight`	`double`	Leitura/Escrita	Define a espessura do pincel que traça o caminho de uma forma em pontos.
`StrokeColor`	`Color`	Leitura/Escrita	Define a cor de um traço.
`Filled`	`bool`	Leitura/Escrita	Determina se o caminho fechado da forma será preenchido.
`FillColor`	`Color`	Leitura/Escrita	Define a cor do pincel que preenche o caminho fechado da forma.
`HasImage`	`bool`	Leitura	Retorna true se a forma possui bytes de imagem ou vincula uma imagem.
`ImageData`	`ImageData`	Leitura	Fornece acesso à imagem da forma.
`OleFormat`	`OleFormat`	Leitura	Fornece acesso aos dados OLE de uma forma.
`TextBox`	`TextBox`	Leitura	Define atributos que especificam como o texto é exibido em uma forma.
`TextPath`	`TextPath`	Leitura	Define o texto do caminho de texto (de um objeto WordArt).
`FirstParagraph`	`Paragraph`	Leitura	Obtém o primeiro parágrafo no shape.
`LastParagraph`	`Paragraph`	Leitura	Obtém o último parágrafo no Shape.
`HorizontalRuleFormat`	`HorizontalRuleFormat`	Leitura	Fornece acesso às propriedades da forma de linha horizontal.
`Adjustments`	`AdjustmentCollection`	Leitura	Fornece acesso aos valores brutos de ajuste de uma forma.
`SignatureLine`	`SignatureLine`	Leitura	Obtém o objeto SignatureLine se a forma for uma linha de assinatura.
`HasChart`	`bool`	Leitura	Retorna true se este Shape tem um Chart.
`HasSmartArt`	`bool`	Leitura	Retorna true se este Shape tem um objeto SmartArt.
`Chart`	`Chart`	Leitura	Fornece acesso às propriedades do Chart se este Shape tem um Chart.
`Fill`	`Fill`	Leitura	Obtém a formatação de preenchimento da forma.
`ShadowFormat`	`ShadowFormat`	Leitura	Obtém a formatação de sombra para a forma.
`Glow`	`GlowFormat`	Leitura	Obtém a formatação de brilho para a forma.
`Reflection`	`ReflectionFormat`	Leitura	Obtém a formatação de reflexão para a forma.
`SoftEdge`	`SoftEdgeFormat`	Leitura	Obtém a formatação de borda suave da forma.
`ScreenTip`	`string`	Leitura/Escrita	Define o texto exibido quando o ponteiro do mouse passa sobre a forma.
`HRef`	`string`	Leitura/Escrita	Obtém ou define o endereço de hiperlink completo para uma forma.
`Target`	`string`	Leitura/Escrita	Obtém ou define o quadro de destino para o hiperlink da forma.
`AlternativeText`	`string`	Leitura/Escrita	Define o texto alternativo a ser exibido em vez de um gráfico.
`IsDecorative`	`bool`	Leitura/Escrita	Obtém ou define o indicador que especifica se a forma é decorativa no documento.
`Title`	`string`	Leitura/Escrita	Obtém ou define o título (legenda) do objeto shape atual.
`Name`	`string`	Leitura/Escrita	Obtém ou define o nome opcional da forma.
`IsInsertRevision`	`bool`	Leitura	Obtém a revisão de inserção.
`IsDeleteRevision`	`bool`	Leitura	Obtém a revisão de exclusão.
`IsMoveFromRevision`	`bool`	Leitura	Obtém o `is move` da revisão.
`IsMoveToRevision`	`bool`	Leitura	Obtém o is move para revisão.
`IsTopLevel`	`bool`	Leitura	Retorna true se esta forma não for um filho de uma forma de grupo.
`IsGroup`	`bool`	Leitura	Retorna true se esta for uma forma de grupo.
`IsImage`	`bool`	Leitura	Retorna true se esta forma for uma forma de imagem.
`IsHorizontalRule`	`bool`	Leitura	Retorna true se esta forma for uma linha horizontal.
`IsWordArt`	`bool`	Leitura	Retorna true se esta forma for um objeto WordArt.
`CanHaveImage`	`bool`	Leitura	Retorna true se o tipo de forma permite que a forma tenha uma imagem.
`AnchorLocked`	`bool`	Leitura/Escrita	Especifica se a âncora da forma está bloqueada.
`AspectRatioLocked`	`bool`	Leitura/Escrita	Especifica se a proporção da forma está travada.
`AllowOverlap`	`bool`	Leitura/Escrita	Obtém ou define um valor que especifica se esta forma pode sobrepor outras formas.
`BehindText`	`bool`	Leitura/Escrita	Especifica se a forma está abaixo ou acima do texto.
`IsInline`	`bool`	Leitura	Uma maneira rápida de determinar se esta forma está posicionada em linha com o texto.
`Left`	`double`	Leitura/Escrita	Obtém ou define a posição da borda esquerda do bloco contêiner da forma.
`Top`	`double`	Leitura/Escrita	Obtém ou define a posição da borda superior do bloco contêiner da forma.
`Right`	`double`	Leitura	Obtém a posição da borda direita do bloco contêiner da forma.
`Bottom`	`double`	Leitura	Obtém a posição da borda inferior do bloco contêiner da forma.
`Width`	`double`	Leitura/Escrita	Obtém ou define a largura do bloco contêiner da forma.
`Height`	`double`	Leitura/Escrita	Obtém ou define a altura do bloco contêiner da forma.
`DistanceTop`	`double`	Leitura/Escrita	Retorna ou define a distância (em pontos) entre o texto do documento e a borda superior da forma.
`DistanceBottom`	`double`	Leitura/Escrita	Retorna ou define a distância (em pontos) entre o texto do documento e a borda inferior da forma.
`DistanceLeft`	`double`	Leitura/Escrita	Retorna ou define a distância (em pontos) entre o texto do documento e a borda esquerda da forma.
`DistanceRight`	`double`	Leitura/Escrita	Retorna ou define a distância (em pontos) entre o texto do documento e a borda direita da forma.
`Rotation`	`double`	Leitura/Escrita	Define o ângulo (em graus) que uma forma é rotacionada.
`ZOrder`	`int`	Leitura/Escrita	Determina a ordem de exibição das formas sobrepostas.
`ParentParagraph`	`Paragraph`	Leitura	Retorna o parágrafo pai imediato.
`Bounds`	`RectangleF`	Leitura/Escrita	Obtém ou define a localização e o tamanho do bloco contêiner da forma.
`BoundsInPoints`	`RectangleF`	Leitura	Obtém a localização e o tamanho do bloco contêiner da forma em pontos, relativo à âncora da forma mais superior.
`BoundsWithEffects`	`RectangleF`	Leitura	Obtém a extensão final que este objeto de forma possui após a aplicação de efeitos de desenho.
`ShapeType`	`ShapeType`	Leitura	Obtém o tipo da forma.
`MarkupLanguage`	`ShapeMarkupLanguage`	Leitura	Obtém MarkupLanguage usado para este objeto gráfico.
`SizeInPoints`	`SizeF`	Leitura	Obtém o tamanho da forma em pontos.
`FlipOrientation`	`FlipOrientation`	Leitura/Escrita	Altera a orientação de uma forma.
`RelativeHorizontalPosition`	`RelativeHorizontalPosition`	Leitura/Escrita	Especifica em relação a que a forma está posicionada horizontalmente.
`RelativeVerticalPosition`	`RelativeVerticalPosition`	Leitura/Escrita	Especifica em relação a que a forma está posicionada verticalmente.
`RelativeHorizontalSize`	`RelativeHorizontalSize`	Leitura/Escrita	Obtém ou define o valor do tamanho relativo da forma na direção horizontal.
`RelativeVerticalSize`	`RelativeVerticalSize`	Leitura/Escrita	Obtém ou define o valor do tamanho relativo da forma na direção vertical.
`LeftRelative`	`float`	Leitura/Escrita	Obtém ou define o valor que representa a posição esquerda relativa da forma em percentagem.
`TopRelative`	`float`	Leitura/Escrita	Obtém ou define o valor que representa a posição superior relativa da forma em porcentagem.
`HeightRelative`	`float`	Leitura/Escrita	Obtém ou define o valor que representa a porcentagem da altura relativa da forma.
`WidthRelative`	`float`	Leitura/Escrita	Obtém ou define o valor que representa a porcentagem da largura relativa da forma.
`HorizontalAlignment`	`HorizontalAlignment`	Leitura/Escrita	Especifica como a forma é posicionada horizontalmente.
`VerticalAlignment`	`VerticalAlignment`	Leitura/Escrita	Especifica como a forma é posicionada verticalmente.
`WrapType`	`WrapType`	Leitura/Escrita	Define se a forma é inline ou flutuante.
`WrapSide`	`WrapSide`	Leitura/Escrita	Especifica como o texto é contornado ao redor da forma.
`CoordOrigin`	`Point`	Leitura/Escrita	As coordenadas do canto superior esquerdo do bloco contêiner desta forma.
`CoordSize`	`Size`	Leitura/Escrita	A largura e a altura do espaço de coordenadas dentro do bloco contêiner desta forma.
`Font`	`Font`	Leitura	Fornece acesso à formatação de fonte deste objeto.
`IsSignatureLine`	`bool`	Leitura	Indica que shape é um SignatureLine.
`IsLayoutInCell`	`bool`	Leitura/Escrita	Obtém ou define um sinalizador que indica se a forma é exibida dentro de uma tabela ou fora dela.
`Hidden`	`bool`	Leitura/Escrita	Obtém ou define um valor booleano que indica se a forma está visível.
`IsComposite`	`bool`	Leitura	Retorna true, pois este nó pode ter nós filhos.
`HasChildNodes`	`bool`	Leitura	Retorna true se este nó tem algum nó filho.
`FirstChild`	`Node`	Leitura	Obtém o primeiro filho do nó.
`LastChild`	`Node`	Leitura	Obtém o último filho do nó.
`Count`	`int`	Leitura	Obtém o número de filhos imediatos deste nó.
`ParentNode`	`CompositeNode`	Leitura	Obtém o pai imediato deste nó.
`Document`	`DocumentBase`	Leitura	Obtém o documento ao qual este nó pertence.
`PreviousSibling`	`Node`	Leitura	Obtém o nó imediatamente anterior a este nó.
`NextSibling`	`Node`	Leitura	Obtém o nó imediatamente seguinte a este nó.
`Range`	`Range`	Leitura	Retorna um objeto Range que representa a parte de um documento que está contida neste nó.
`CustomNodeId`	`int`	Leitura/Escrita	Especifica um identificador de nó personalizado.

Métodos

Assinatura	Descrição
`Shape(doc: DocumentBase, shapeType: ShapeType)`	Cria um novo objeto shape.
`Accept(visitor: DocumentVisitor)`	Chama VisitShapeStart, então chama Accept para todos os nós filhos da shape e chama VisitShapeEnd ao final.
`AcceptStart(visitor: DocumentVisitor)`	Aceita um visitante para visitar o início da forma.
`AcceptEnd(visitor: DocumentVisitor)`	Aceita um visitante para visitar o final da forma.
`LocalToParent(value: PointF)`	Converte um valor do espaço de coordenadas local para o espaço de coordenadas da forma pai.
`AdjustWithEffects(source: RectangleF)`	Adiciona ao retângulo de origem os valores da extensão do efeito e retorna o retângulo final.
`GetText()`	Obtém o texto deste nó e de todos os seus filhos.
`GetChildNodes(nodeType: NodeType, isDeep: bool)`	Retorna uma coleção de nós filhos que correspondem ao tipo especificado.
`GetChild(nodeType: NodeType, index: int, isDeep: bool)`	Retorna o nó filho N-ésimo que corresponde ao tipo especificado.
`SelectNodes(xpath: string)`	Seleciona uma lista de nós que correspondem à expressão XPath.
`SelectSingleNode(xpath: string)`	Seleciona o primeiro Node que corresponde à expressão XPath.
`GetEnumerator()`	Fornece suporte para iteração no estilo for each sobre os nós filhos deste node.
`AppendChild(newChild: T)`	Adiciona o node especificado ao final da lista de nós filhos deste node.
`PrependChild(newChild: T)`	Adiciona o node especificado ao início da lista de nós filhos deste node.
`InsertAfter(newChild: T, refChild: Node)`	Insere o nó especificado imediatamente após o nó de referência especificado.
`InsertBefore(newChild: T, refChild: Node)`	Insere o nó especificado imediatamente antes do nó de referência especificado.
`RemoveChild(oldChild: T)`	Remove o nó filho especificado.
`RemoveAllChildren()`	Remove todos os nós filhos do nó atual.
`RemoveSmartTags()`	Remove todos os nós descendentes SmartTag do nó atual.
`IndexOf(child: Node)`	Retorna o índice do nó filho especificado no array de nós filhos.
`CreateNavigator()`	Cria um navegador que pode ser usado para percorrer e ler nós.
`Clone(isCloneChildren: bool)`	Você deve usar a sobrecarga Clone(bool, INodeCloningListener) quando a clonagem do nó faz parte de outro processo de clonagem de nó (geralmente composto).
`GetAncestor(ancestorType: Type)`	Obtém o primeiro ancestral do tipo de objeto especificado.
`GetAncestorOf()`	Chama GetAncestorOf nesta instância de Shape.
`Remove()`	Remove a si mesmo do pai.
`NextPreOrder(rootNode: Node)`	Obtém o próximo nó de acordo com o algoritmo de travessia pré-ordem da árvore.
`PreviousPreOrder(rootNode: Node)`	Obtém o nó anterior de acordo com o algoritmo de travessia pré-ordem da árvore.
`ToString(saveFormat: SaveFormat)`	Exporta o conteúdo do nó para uma string no formato especificado.
`NodeTypeToString(nodeType: NodeType)`	Um método utilitário que converte um valor enum de tipo de nó em uma string amigável ao usuário.

Ver também

Aspose.Words for .NET — Enterprise API Reference