ShapeRange Interface

Definição

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Representa um intervalo de formas, que é um conjunto de formas em um documento.

public interface class ShapeRange : System::Collections::IEnumerable

[System.Runtime.InteropServices.Guid("000209B5-0000-0000-C000-000000000046")]
public interface ShapeRange : System.Collections.IEnumerable

type ShapeRange = interface
    interface IEnumerable

Public Interface ShapeRange
Implements IEnumerable

Atributos

GuidAttribute

Implementações

IEnumerable

Comentários

O intervalo de formas pode conter desde uma única forma até todas as formas do documento. Você pode incluir as formas desejadas, escolhidas entre todas as formas do documento ou todas as formas na seleção, para construir um intervalo de formas. Por exemplo, você poderia construir uma coleção ShapeRange contendo as três primeiras formas em um documento, todas as formas selecionadas em um documento ou todas as formas livres em um documento.

Nota A maioria das operações que você pode fazer com um Shape objeto, você também pode fazer com um objeto ShapeRange que contém apenas uma forma. Algumas operações, quando executadas em um objeto ShapeRange que contém mais de uma forma, causará um erro.

Use Shapes.Range(index), onde index é o nome ou o número de índice da forma ou uma matriz que contém nomes ou números de índice de formas, para retornar uma coleção ShapeRange que representa um conjunto de formas em um documento. Você pode usar programaticamente uma matriz para construir uma matriz de nomes ou números de índice.

Embora você possa usar o Range(Object) método para retornar qualquer número de formas, é mais simples usar o Item[Object] método se você quiser retornar apenas um único membro da coleção. Por exemplo, Shapes(1) é mais simples que Shapes.Range(1).

Use Selection.ShapeRange(index), onde index é o nome ou o número do índice, para retornar um objeto Shape que representa uma forma dentro de uma seleção.

Use o Align(MsoAlignCmd, Int32)método , Distribute(MsoDistributeCmd, Int32)ou ZOrder(MsoZOrderCmd) para posicionar um conjunto de formas em relação umas às outras ou relativas ao documento.

Use o Group()método , Regroup()ou Ungroup() para criar e trabalhar com uma única forma formada a partir de um intervalo de formas. A GroupItems propriedade de um objeto Shape retorna o GroupShapes objeto, que representa todas as formas agrupadas para formar uma forma.

O gravador sempre usa a ShapeRange propriedade ao gravar formas.

Um objeto ShapeRange não inclui InlineShape objetos.

Propriedades

Adjustments	Retorna um Adjustments objeto que contém valores de ajuste para todos os ajustes no objeto especificado ShapeRange que representa um AutoShape ou WordArt.
AlternativeText	Retorna ou define o texto alternativo associado a uma forma em uma página da Web.
Anchor	Retorna um Range objeto que representa o intervalo de ancoragem para o intervalo de formas especificado.
Application	Retorna um Application objeto que representa o aplicativo microsoft Word.
AutoShapeType	Retorna ou define o tipo de forma para o objeto especificado ShapeRange , que deve representar um AutoShape diferente de um desenho de linha ou de forma livre.
BackgroundStyle	Obtém ou define o estilo de plano de fundo das formas no intervalo de formas especificado.
Callout	Retorna um CalloutFormat objeto que contém propriedades de formatação de callout para o objeto especificado ShapeRange que representa callouts.
CanvasItems	Retorna um CanvasShapes objeto que representa uma coleção de formas em uma tela de desenho.
Child	True se todas as formas em um intervalo de formas forem formas filho do mesmo pai.
ConnectionSiteCount	Reservado para uso interno.
Connector	Reservado para uso interno.
ConnectorFormat	Reservado para uso interno.
Count	Retorna o número de itens na coleção especificada.
Creator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Diagram	Retorna um objeto Diagrama ao qual pertence um nó de diagrama.
DiagramNode	Retorna um DiagramNode objeto que representa um nó em um diagrama.
Fill	Retorna um FillFormat objeto que contém propriedades de formatação de preenchimento para a forma especificada.
Glow	Retorna um GlowFormat objeto que representa a formatação de brilho para um intervalo de formas. Somente leitura.
GroupItems	Retorna um GroupShapes objeto que representa as formas individuais no objeto especificado ShapeRange que representa formas agrupadas.
HasDiagram	MsoTrue se uma forma for um diagrama.
HasDiagramNode	MsoTrue se uma forma for um nó de diagrama.
Height	Retorna ou define a altura do objeto especificado em pontos.
HeightRelative	Retorna ou define um Single que representa a porcentagem da forma de destino à qual o intervalo de formas é dimensionado. Leitura/gravação.
HorizontalFlip	Indica que uma forma foi virada horizontalmente.
Hyperlink	Retorna um WdShapePosition objeto que representa o hiperlink associado ao objeto especificado ShapeRange .
ID	Retorna o tipo do objeto especificado.
Item[Object]	Retorna um objeto individual de uma coleção.
LayoutInCell	Retorna um Inteiro que representa se uma forma em uma tabela é exibida dentro da tabela ou fora da tabela. True indica que uma imagem especificada é exibida dentro da tabela. False indica que uma imagem especificada é exibida fora da tabela.
Left	Retorna ou define um Single que representa a posição horizontal, medida em pontos, do intervalo de formas especificado. Também pode ser qualquer constante válida WdShapePosition .
LeftRelative	Retorna ou define um valor único que representa a posição relativa de esquerdo de um intervalo de formas. Leitura/gravação.
Line	Retorna um LineFormat objeto que contém propriedades de formatação de linha para a forma especificada.
LockAnchor	True se a âncora do objeto especificado ShapeRange estiver bloqueada para o intervalo de ancoragem.
LockAspectRatio	MsoTrue se a forma especificada retém suas proporções originais quando você a redimensiona. MsoFalse se você pode alterar a altura e largura da forma independentemente uma da outra, ao redimensioná-la.
Name	Retorna ou define o nome do objeto especificado.
Nodes	Retorna uma ShapeNodes coleção que representa a descrição geométrica da forma especificada.
Parent	Retorna um objeto que representa o objeto pai do objeto especificado.
ParentGroup	Retorna um Shape objeto que representa a forma pai comum de um intervalo de formas filho.
PictureFormat	Retorna um PictureFormat objeto que contém propriedades de formatação de imagem para o objeto especificado ShapeRange que representa uma imagem ou objeto OLE.
Reflection	Retorna um ReflectionFormat objeto que representa a formatação de reflexão para um intervalo de formas. Somente leitura.
RelativeHorizontalPosition	Especifica qual é a posição horizontal de um intervalo de formas relativa.
RelativeHorizontalSize	Retorna ou define uma WdRelativeHorizontalSize constante que representa o objeto ao qual um intervalo de formas é relativo. Leitura/gravação.
RelativeVerticalPosition	Especifica qual é a posição vertical de um intervalo de formas relativa.
RelativeVerticalSize	Retorna ou define uma WdRelativeVerticalSize constante que representa o objeto ao qual um intervalo de formas é relativo. Leitura/gravação.
Rotation	Retorna ou define o número de graus em que a forma especificada é girada ao redor do eixo z. Um valor positivo indica rotação no sentido horário; um valor negativo indica rotação no sentido anti-horário.
RTF	Reservado para uso interno.
Shadow	Retorna um ShadowFormat objeto que representa a formatação de sombra para a forma especificada.
ShapeStyle	Obtém ou define o estilo de forma para as formas no intervalo de formas especificado.
SoftEdge	Retorna um SoftEdgeFormat objeto que representa a formatação de borda macia para um intervalo de formas. Somente leitura.
TextEffect	Retorna um TextEffectFormat objeto que contém propriedades de formatação de efeito de texto para o objeto especificado ShapeRange que representa o WordArt.
TextFrame	Retorna um TextFrame objeto que contém o texto para a forma especificada.
TextFrame2	Retorna um TextFrame2 objeto que contém o texto para o intervalo de formas especificado. Somente leitura.
ThreeD	Retorna um ThreeDFormat objeto que contém propriedades de formatação de efeito 3D – efeito para a forma especificada.
Title	Obtém ou define uma cadeia de caracteres que contém um título para as formas no intervalo de formas especificado.
Top	Retorna ou define a posição vertical do intervalo de formas especificado em pontos.
TopRelative	Retorna ou define um valor único que representa a posição relativa de superior de um intervalo de formas. Leitura/gravação.
Type	Retorna o tipo de forma.
VerticalFlip	True se a forma especificada for invertida ao redor do eixo vertical.
Vertices	Retorna as coordenadas dos vértices (e pontos de controle para curvas Bézier) do desenho de forma livre especificado como uma série de pares de coordenadas.
Visible	True se o objeto especificado ou a formatação aplicada a ele, está visível.
Width	Retorna ou define a largura do objeto especificado, em pontos.
WidthRelative	Retorna ou define um valor único que representa a largura relativa de um intervalo de formas. Leitura/gravação.
WrapFormat	Retorna um WrapFormat objeto que contém as propriedades para encapsular texto em torno do intervalo de formas especificado.
ZOrderPosition	Retorna a posição da forma especificada, de acordo com a ordem z.

Métodos

Activate()	Ativa o objeto especificado.
Align(MsoAlignCmd, Int32)	Alinha as formas no intervalo especificado de formas.
Apply()	Aplica-se à formatação de forma especificada que foi copiada usando o PickUp() método.
CanvasCropBottom(Single)	Corta uma porcentagem da altura de uma tela de desenho começando pela parte inferior da tela.
CanvasCropLeft(Single)	Corta uma porcentagem da largura de uma tela de desenho começando pela parte esquerda da tela.
CanvasCropRight(Single)	Corta uma porcentagem da largura de uma tela de desenho começando pela direita da tela.
CanvasCropTop(Single)	Cultiva uma porcentagem da largura de uma tela de desenho da parte superior da tela.
ConvertToFrame()	Converte a forma especificada em um quadro. Retorna um Frame objeto que representa o novo quadro.
ConvertToInlineShape()	Converte a forma especificada na camada de desenho de um documento em uma forma embutida na camada de texto. Retorna um InlineShape objeto que representa a imagem ou o objeto OLE.
Delete()	Exclui o objeto especificado.
Distribute(MsoDistributeCmd, Int32)	Distribui as formas uniformemente no intervalo especificado.
Duplicate()	Cria uma duplicata do objeto especificado ShapeRange , adiciona o novo intervalo de formas à Shapes coleção em um deslocamento padrão das formas originais e retorna o novo Shape objeto.
Flip(MsoFlipCmd)	Inclina uma forma no sentido horizontal ou vertical.
GetEnumerator()	Representa um intervalo de formas, que é um conjunto de formas em um documento.
Group()	Agrupa as formas no intervalo especificado. Retorna as formas agrupadas como um único Shape objeto.
IncrementLeft(Single)	Move horizontalmente a forma especificada pelo número especificado de pontos.
IncrementRotation(Single)	Altera a rotação da forma especificada ao redor do eixo z pelo número especificado de graus.
IncrementTop(Single)	Move a forma especificada verticalmente pelo número especificado de pontos.
PickUp()	Copia a formatação da forma especificada.
Regroup()	Reagrupa o grupo que o intervalo de formas especificado pertencia anteriormente. Retorna as formas reagrupadas como um único Shape objeto.
RerouteConnections()	Reservado para uso interno.
ScaleHeight(Single, MsoTriState, MsoScaleFrom)	Dimensiona a altura da forma por um fator especificado.
ScaleWidth(Single, MsoTriState, MsoScaleFrom)	Dimensiona a largura da forma por um fator especificado.
Select(Object)	Seleciona o objeto especificado.
SetShapesDefaultProperties()	Aplica a formatação da forma especificada a uma forma padrão para esse documento. As novas formas herdam muitos dos atributos da forma padrão.
Ungroup()	Desagrupa quaisquer formas agrupadas na forma especificada ou intervalo de formas. Desmonta figuras e objetos OLE dentro da forma especificada ou o intervalo de formas. Retorna as formas não agrupadas como um único ShapeRange objeto.
ZOrder(MsoZOrderCmd)	Move a forma especificada para a frente ou para trás das outras formas na coleção (isto é, altera a posição da forma na ordem z).