ComboBoxContentControl.PlaceholderText – vlastnost

Článek
01/03/2014

Získá nebo nastaví text zobrazený v ComboBoxContentControl dokud text se změní akce uživatele nebo jinou operaci.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
Property PlaceholderText As String

string PlaceholderText { get; set; }

Hodnota vlastnosti

Typ: System.String
Text zobrazený v ovládacím prvku, dokud text se změní akce uživatele nebo jinou operaci.

Poznámky

Dokud uživatel vybere položku nebo zadá novou hodnotu ovládacího prvku nebo ovládací prvek je naplněn daty ze zdroje dat, zobrazí se zástupný text.

Zástupný symbol textu s textem, který je v nastavení Microsoft.Office.Interop.Word.BuildingBlock nebo Range, použít SetPlaceholderText metody.

Příklady

Následující příklad kódu přidá nový ComboBoxContentControl na začátku dokumentu.Uživatelé mohou vybrat název barvy zobrazené v ovládacím prvku nebo nezadají název nové barvy.V příkladu je nastavena PlaceholderText vlastnost na řetězec, který vyzve uživatele k výběru barvy.

Tato verze je pro vlastní úpravy úrovni dokumentu.Tento kód použít, vložte jej do ThisDocument třídy v projektu a volání AddComboBoxControlAtSelection metoda z ThisDocument_Startup metody.

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

Private Sub AddComboBoxControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    comboBoxControl1 = Me.Controls.AddComboBoxContentControl("comboBoxControl1")
    With comboBoxControl1
        .DropDownListEntries.Add("Red", "Red", 0)
        .DropDownListEntries.Add("Green", "Green", 1)
        .DropDownListEntries.Add("Blue", "Blue", 2)
        .PlaceholderText = "Choose a color, or enter your own"
    End With
End Sub

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

private void AddComboBoxControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    comboBoxControl1 = this.Controls.AddComboBoxContentControl("comboBoxControl1");
    comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
    comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
    comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
    comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";
}

Tato verze je aplikace úroveň doplněk.Tento kód použít, vložte jej do ThisAddIn třídy v projektu a volání AddComboBoxControlAtSelection metoda z ThisAddIn_Startup metody.

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

Private Sub AddComboBoxControlAtSelection()
    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()
    vstoDoc.Paragraphs(1).Range.Select()
    comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl("comboBoxControl1")
    With comboBoxControl1
        .DropDownListEntries.Add("Red", "Red", 0)
        .DropDownListEntries.Add("Green", "Green", 1)
        .DropDownListEntries.Add("Blue", "Blue", 2)
        .PlaceholderText = "Choose a color, or enter your own"
    End With
End Sub

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

private void AddComboBoxControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl(
        "comboBoxControl1");
    comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
    comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
    comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
    comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";            
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

ComboBoxContentControl Rozhraní

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím