Método ControlCollection.AddDropDownListContentControl (Range, String)
Adiciona um novo DropDownListContentControl no intervalo especificado no documento.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)
Sintaxe
'Declaração
Function AddDropDownListContentControl ( _
range As Range, _
name As String _
) As DropDownListContentControl
DropDownListContentControl AddDropDownListContentControl(
Range range,
string name
)
Parâmetros
- range
Tipo: Microsoft.Office.Interop.Word.Range
A Range que fornece os limites para o novo controle.
- name
Tipo: System.String
O nome do novo controle.
Valor de retorno
Tipo: Microsoft.Office.Tools.Word.DropDownListContentControl
O DropDownListContentControl que foi adicionado ao documento.
Exceções
Exceção | Condição |
---|---|
ArgumentNullException | nameé nulluma referência nula (Nothing no Visual Basic) ou tem comprimento zero. |
ControlNameAlreadyExistsException | Um controle com o mesmo nome já está na ControlCollection. |
Comentários
Use esse método para adicionar um novo DropDownListContentControl em um intervalo especificado no documento no tempo de execução. For more information, see Adicionar controles a documentos do Office em tempo de execução.
Exemplos
O exemplo de código a seguir adiciona um novo DropDownListContentControl para o início do documento. O exemplo também adiciona os nomes de vários dias para a lista de itens que os usuários podem selecionar no controle.
Esta versão é para uma personalização em nível de documento. Para usar esse código, colá-lo na ThisDocument classe em seu projeto e a chamada a AddDropDownListControlAtRange método a partir do ThisDocument_Startup método.
Dim dropDownListControl2 As Microsoft.Office.Tools.Word.DropDownListContentControl
Private Sub AddDropDownListControlAtRange()
Me.Paragraphs(1).Range.InsertParagraphBefore()
dropDownListControl2 = Me.Controls.AddDropDownListContentControl(Me.Paragraphs(1).Range, _
"dropDownListControl2")
With dropDownListControl2
.DropDownListEntries.Add("Monday", "Monday", 0)
.DropDownListEntries.Add("Tuesday", "Tuesday", 1)
.DropDownListEntries.Add("Wednesday", "Wednesday", 2)
.PlaceholderText = "Choose a day"
End With
End Sub
private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl2;
private void AddDropDownListControlAtRange()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
dropDownListControl2 = this.Controls.AddDropDownListContentControl(this.Paragraphs[1].Range,
"dropDownListControl2");
dropDownListControl2.DropDownListEntries.Add("Monday", "Monday", 0);
dropDownListControl2.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
dropDownListControl2.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
dropDownListControl2.PlaceholderText = "Choose a day";
}
Esta versão é um suplemento de nível de aplicativo que se destina a .NET Framework 4. Para usar esse código, colá-lo na ThisAddIn classe em seu projeto e a chamada a AddDropDownListControlAtRange método a partir do ThisAddIn_Startup método.
Dim dropDownListControl2 As Microsoft.Office.Tools.Word.DropDownListContentControl
Private Sub AddDropDownListControlAtRange()
If Me.Application.ActiveDocument Is Nothing Then
Return
End If
Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
dropDownListControl2 = vstoDoc.Controls.AddDropDownListContentControl( _
vstoDoc.Paragraphs(1).Range, _
"dropDownListControl2")
With dropDownListControl2
.DropDownListEntries.Add("Monday", "Monday", 0)
.DropDownListEntries.Add("Tuesday", "Tuesday", 1)
.DropDownListEntries.Add("Wednesday", "Wednesday", 2)
.PlaceholderText = "Choose a day"
End With
End Sub
private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl2;
private void AddDropDownListControlAtRange()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
dropDownListControl2 = vstoDoc.Controls.AddDropDownListContentControl(
vstoDoc.Paragraphs[1].Range,
"dropDownListControl2");
dropDownListControl2.DropDownListEntries.Add("Monday", "Monday", 0);
dropDownListControl2.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
dropDownListControl2.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
dropDownListControl2.PlaceholderText = "Choose a day";
}
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.
Consulte também
Referência
Sobrecargas AddDropDownListContentControl
Namespace Microsoft.Office.Tools.Word
Outros recursos
Adicionar controles a documentos do Office em tempo de execução
Métodos auxiliares para controles de Host
Como: Adicionar controles de conteúdo para documentos do Word