ContentControlListEntry Interface

Definição

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Um ContentControlListEntry objeto representa um item de lista em uma lista suspensa ou controle de conteúdo da caixa de combinação. Um ContentControlListEntry objeto é um membro da ContentControlListEntries coleção de um ContentControl objeto.

public interface class ContentControlListEntry

[System.Runtime.InteropServices.Guid("0C6FA8CA-E65F-4FC7-AB8F-20729EECBB14")]
public interface ContentControlListEntry

type ContentControlListEntry = interface

Public Interface ContentControlListEntry

Atributos

GuidAttribute

Comentários

Use o Add(String, String, Int32) método da ContentControlListEntries coleção para criar um novo ContentControlListEntry objeto. Use o Item[Int32] método ou DropdownListEntries(Index), em que Index é a posição ordinal do item da lista de controle de conteúdo, para acessar um item de lista individual dentro da ContentControlListEntries coleção.

Observação: as entradas de lista devem ter nomes de exibição exclusivos. Ao tentar adicionar um item de lista que já existe gera um erro em tempo de execução.

Use os MoveUp() métodos e MoveDown() para reposicionar itens em uma lista suspensa. Use o Select() método para selecionar programaticamente um item de lista de controle de conteúdo.

Use a Text propriedade para definir o texto de exibição para um item de lista de controle de conteúdo e use a Value propriedade para definir um valor programático que você pode usar posteriormente para processar um formulário. Por exemplo, você pode usar uma lista suspensa de controle de conteúdo para uma lista de produtos. A Text propriedade pode conter o nome do produto, um nome de exibição que um usuário pode reconhecer e entender facilmente. A Value propriedade pode conter o número do produto que corresponde a um número de produto em um banco de dados. Em seguida, você pode usar o número do produto da Value propriedade para pesquisar as informações do produto em um banco de dados. Além disso, o valor da Value propriedade é o que é enviado aos dados XML personalizados se o controle de conteúdo for mapeado para dados XML no armazenamento de dados.

Use o Delete() método para remover um item de uma lista suspensa ou caixa de combinação de controle de conteúdo.

Propriedades

Application	Retorna um _Application objeto que representa o aplicativo microsoft Word.
Creator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o suplemento foi criado. Somente leitura.
Index	Retorna ou define a posição ordinal de um item de lista de controle de conteúdo na coleção de itens de lista. Leitura/gravação.
Parent	Retorna o objeto pai do objeto especificado ContentControlListEntry .
Text	Retorna ou define o texto de exibição de um item de lista para uma lista suspensa ou controle de conteúdo da caixa de combinação. Leitura/gravação.
Value	Retorna ou define o valor programático de um item em uma lista suspensa ou controle de conteúdo da caixa de combinação. Leitura/gravação.

Métodos

Delete()	Exclui o item especificado de um controle de conteúdo de lista suspensa ou caixa de combinação.
MoveDown()	Move um item em um controle de conteúdo de caixa de combinação ou lista suspensa um item para baixo, de forma que ele fique após o item que originalmente o seguia.
MoveUp()	Move um item em um controle de conteúdo de caixa de combinação ou lista suspensa um item para cima, de forma que ele fique antes do item que originalmente o precedia.
Select()	Seleciona a entrada de lista em uma lista suspensa ou controle de conteúdo da caixa de combinação e define o texto do controle de conteúdo como o valor do item.