Document.Controls Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém a coleção de controles gerenciados contidos no documento.
public Microsoft.Office.Tools.Word.ControlCollection Controls { get; }
Valor da propriedade
Um ControlCollection que contém todos os controles gerenciados no documento.
Exemplos
O exemplo de código a seguir adiciona texto ao primeiro parágrafo e cria um Bookmark controle que abrange o parágrafo. Em seguida, o código mostra uma caixa de mensagem que exibe o número total de controles no documento. Este exemplo destina-se a um suplemento no nível de aplicativo.
private void DocumentControls()
{
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphAfter();
vstoDoc.Paragraphs[1].Range.Text = "This is some sample text.";
vstoDoc.Controls.AddBookmark(vstoDoc.Paragraphs[1].Range, "Bookmark1");
System.Windows.Forms.MessageBox.Show("Total number of controls: " +
vstoDoc.Controls.Count.ToString());
}
Private Sub DocumentControls()
Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
vstoDoc.Paragraphs(1).Range.InsertParagraphAfter()
vstoDoc.Paragraphs(1).Range.Text = "This is some sample text."
vstoDoc.Controls.AddBookmark(vstoDoc.Paragraphs(1).Range, "Bookmark1")
System.Windows.Forms.MessageBox.Show("Total number of controls: " & _
vstoDoc.Controls.Count.ToString())
End Sub
Comentários
Um documento em uma solução do Office pode conter controles de Windows Forms e de host. Para obter mais informações, consulte controles em documentos do Office.
Para gerenciar os controles em um documento em tempo de execução, use os métodos e as propriedades do ControlCollection objeto retornado pela Controls propriedade. Para obter mais informações, consulte adicionando controles a documentos do Office em tempo de execução.