Shapes Interface

Definição

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Uma coleção de Shape objetos que representam todas as formas em um documento ou todas as formas em todos os cabeçalhos e rodapés em um documento.

public interface class Shapes : System::Collections::IEnumerable

[System.Runtime.InteropServices.Guid("0002099F-0000-0000-C000-000000000046")]
public interface Shapes : System.Collections.IEnumerable

type Shapes = interface
    interface IEnumerable

Public Interface Shapes
Implements IEnumerable

Atributos

GuidAttribute

Implementações

IEnumerable

Comentários

Cada objeto Shape representa um objeto na camada de desenho, como uma AutoForma, uma forma livre, um objeto OLE ou uma imagem.

Nota Se você quiser trabalhar com um subconjunto das formas em um documento, por exemplo, para fazer algo apenas com o AutoShapes no documento ou apenas com as formas selecionadas, você deve construir uma ShapeRange coleção que contenha as formas com as quais deseja trabalhar.

Use a Shapes propriedade para retornar a coleção Shapes .

Nota Se você quiser fazer algo (como excluir ou definir uma propriedade) para todas as formas em um documento ao mesmo tempo, use o Range(Object) método para criar um objeto ShapeRange que contenha todas as formas na coleção Shapes e aplique a propriedade ou método apropriado ao objeto ShapeRange .

Use um dos seguintes métodos da coleção Shapes: AddCallout(MsoCalloutType, Single, Single, Single, Single, Object), AddCurve(Object, Object), , AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object), AddLine(Single, Single, Single, Single, Object), AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)AddOLEControl(Object, Object, Object, Object, Object, Object), AddPolyline(Object, Object), AddShape(Int32, Single, Single, Single, Single, Object), AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object), ou BuildFreeform(MsoEditingType, Single, Single)AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)para adicionar uma forma a um documento e retornar um objeto Shape que representa a forma recém-criada.

Use Shapes(index), em que index é o nome ou o número do índice, para retornar um único objeto Shape .

Cada forma é atribuída um nome padrão quando ele é criado. Por exemplo, se você adicionar três formas diferentes a um documento, elas podem ser nomeadas "Rectangle 2", "TextBox 3" e "Oval 4". Para dar a uma forma um nome mais significativo, defina a Name propriedade.

A coleção Shapes não inclui InlineShape objetos. Objetos InlineShape são tratados como caracteres e são posicionados como caracteres dentro de uma linha de texto. Objetos Shape ficam vinculados a um intervalo de texto, mas são livremente flutuantes e podem ser posicionados em qualquer lugar na página. Você pode usar o ConvertToInlineShape() método e o ConvertToShape(Object) método para converter formas de um tipo para outro. Você pode converter somente figuras, objetos OLE e controles ActiveX para formas embutidas.

A Count propriedade dessa coleção em um documento retorna o número de itens somente no main história. Para contar as formas em todos os cabeçalhos e rodapés, use a coleção Shapes com qualquer HeaderFooter objeto.

Propriedades

Application	Retorna um Application objeto que representa o aplicativo microsoft Word.
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.
Item[Object]	Retorna um objeto individual de uma coleção.
Parent	Retorna um objeto que representa o objeto pai do objeto especificado.

Métodos

AddCallout(MsoCalloutType, Single, Single, Single, Single, Object)	Adiciona uma chamada de linha sem borda a um documento. Retorna um Shape objeto que representa o chamador e o adiciona à Shapes coleção.
AddCanvas(Single, Single, Single, Single, Object)	Adiciona uma tela de desenho a um documento. Retorna um Shape objeto que representa a tela de desenho e a adiciona à Shapes coleção.
AddChart(XlChartType, Object, Object, Object, Object, Object)	This object, member, or enumeration is deprecated and is not intended to be used in your code.
AddChart2(Int32, XlChartType, Object, Object, Object, Object, Object, Object)	Adiciona um gráfico ao documento. Retorna um Shape objeto que representa um gráfico e o adiciona à coleção especificada.
AddConnector(MsoConnectorType, Single, Single, Single, Single)	Reservado para uso interno.
AddCurve(Object, Object)	Retorna um Shape objeto que representa uma curva Bézier em um documento.
AddDiagram(MsoDiagramType, Single, Single, Single, Single, Object)	Retorna um Shape objeto que representa um diagrama recém-criado em um documento.
AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object)	Adiciona um rótulo de texto a um documento. Retorna um Shape objeto que representa o rótulo de texto e o adiciona à Shapes coleção.
AddLine(Single, Single, Single, Single, Object)	Adiciona uma linha a um documento. Retorna um Shape objeto que representa a linha e a adiciona à AddCallout(MsoCalloutType, Single, Single, Single, Single, Object) coleção.
AddOLEControl(Object, Object, Object, Object, Object, Object)	Cria um controle ActiveX (conhecido anteriormente como controle OLE). Retorna o Shape objeto que representa o novo controle ActiveX.
AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Cria um objeto OLE. Retorna o Shape objeto que representa o novo objeto OLE.
AddPicture(String, Object, Object, Object, Object, Object, Object, Object)	Adiciona uma figura a um documento. Retorna um Shape objeto que representa a imagem e a Shapes adiciona à coleção.
AddPolyline(Object, Object)	Adiciona um polígono aberto ou fechado a um documento. Retorna um Shape objeto que representa o polígono e o adiciona à Shapes coleção.
AddShape(Int32, Single, Single, Single, Single, Object)	Adiciona uma AutoForma a um documento. Retorna um Shape objeto que representa o AutoShape e o adiciona à Shapes coleção.
AddSmartArt(SmartArtLayout, Object, Object, Object, Object, Object)	Insere o elemento gráfico SmartArt especificado no documento ativo.
AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object)	Adiciona uma caixa de texto a um documento. Retorna um Shape objeto que representa a caixa de texto e o adiciona à Shapes coleção.
AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)	Adiciona uma forma do WordArt a um documento. Retorna um Shape objeto que representa o WordArt e o adiciona à Shapes coleção.
AddWebVideo(String, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Adiciona um novo vídeo Web ao documento.
BuildFreeform(MsoEditingType, Single, Single)	Cria um objeto de forma livre. Retorna um FreeformBuilder objeto que representa a forma livre à medida que está sendo criado.
GetEnumerator()	Uma coleção de Shape objetos que representam todas as formas em um documento ou todas as formas em todos os cabeçalhos e rodapés em um documento.
Range(Object)	Retorna um ShapeRange objeto.
SelectAll()	Seleciona todas as formas no main história, em uma tela ou em cabeçalhos e rodapés de um documento.