Metoda ControlExtensions.AddListView — (ControlCollection, Range, Single, Single, String)

Artykuł
01/08/2014

Dodaje nowy ListView formantu do dokumentu w określonym rozmiarze i lokalizacji.

Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestaw: Microsoft.Office.Tools.Word.v4.0.Utilities (w Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Składnia

'Deklaracja
<ExtensionAttribute> _
Public Shared Function AddListView ( _
    controls As ControlCollection, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As ListView

public static ListView AddListView(
    this ControlCollection controls,
    Range range,
    float width,
    float height,
    string name
)

Parametry

controls
Typ: Microsoft.Office.Tools.Word.ControlCollection
Aby dodać formant do kolekcji.Nie zostanie podany parametr ten sam.Jeśli wywołanie tej metody na kolekcja zwróconego przez Document.Controls właściwość (w projekcie poziomie aplikacji) lub DocumentBase.Controls właściwość (w projekcie poziomie dokumentu), parametr ten jest dostarczany automatycznie.

range
Typ: Microsoft.Office.Interop.Word.Range
Położenie formantu.

width
Typ: System.Single
Szerokość formantu znajdującego się w punktach.

height
Typ: System.Single
Wysokość formantu w punktach.

name
Typ: System.String
Nazwy, które mogą być używane do indeksowania formantu znajdującego się w ControlCollection wystąpienie.

Wartość zwracana

Typ: Microsoft.Office.Tools.Word.Controls.ListView
Formant, który został dodany do dokumentu.

Informacje dotyczące użycia

W językach Visual Basic i C# tę metodę można wywołać jako metodę wystąpienia dowolnego obiektu typu ControlCollection. Gdy w celu wywołania tej metody jest używana składnia metody wystąpienia, należy pominąć pierwszy parametr. Aby uzyskać więcej informacji, zobacz temat Metody rozszerzeń (Visual Basic) lub Metody rozszerzeń (Przewodnik programowania w języku C#).

Wyjątki

Wyjątek	Warunek
ArgumentNullException	name Lub range argument jest nullodwołanie o wartości null (Nothing w języku Visual Basic), lub name argument ma zerową długość.
ControlNameAlreadyExistsException	Formant o tej samej nazwie jest już w ControlCollection wystąpienie.
InvalidRangeException	Określony zakres jest nieprawidłowy.

Uwagi

Ta metoda umożliwia dodanie ListView obiektów na koniec ControlCollection.

Aby usunąć ListView że dodano programowo, należy użyć Remove metody.

Przykłady

Poniższy kod dodaje ListView formantu do pierwszego akapitu w dokumencie, zmienia widok do List, a następnie dodawane są dwa elementy do ListView.Aby wykorzystać ten przykład, należy uruchomić go z ThisDocument klasy w projekcie poziomie dokumentu.

Private Sub WordRangeAddListView()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim ListView1 As Microsoft.Office.Tools.Word.Controls. _
        ListView = Me.Controls.AddListView(Me.Paragraphs(1). _
        Range, 90.75F, 72.75F, "ListView1")
    ListView1.View = View.List
    ListView1.Items.Add("Item 1")
    ListView1.Items.Add("Item 2")
End Sub

private void WordRangeAddListView()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.ListView
         listView1 = this.Controls.AddListView(
         this.Paragraphs[1].Range, 90.75F, 72.75F, "listView1");
    listView1.View = View.List;
    listView1.Items.Add("Item 1");
    listView1.Items.Add("Item 2");
}

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.

Zobacz też

Informacje

ControlExtensions Klasa

Przeciążenie AddListView

Przestrzeń nazw Microsoft.Office.Tools.Word

Udostępnij za pośrednictwem