ControlCollection.Contains Method

  • Reference

Definition

Namespace:
Microsoft.Office.Tools.Word
Assemblies:
Microsoft.Office.Tools.Word.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Determines whether the specified control is a member of the ControlCollection instance.

Overloads

Contains(Object)

Determines whether the specified control is a member of the ControlCollection instance.
Contains(String)

Determines whether a control with the specified name is a member of the ControlCollection instance.

Remarks

This method enables you to determine whether a control is a member of the collection before attempting to perform operations on the control. You can use this method to confirm that a control has been added to, or is still a member of, the ControlCollection instance.

Contains(Object)

Determines whether the specified control is a member of the ControlCollection instance.

public:
 bool Contains(System::Object ^ control);
public bool Contains (object control);
abstract member Contains : obj -> bool
Public Function Contains (control As Object) As Boolean

Parameters

control
Object

The control that you want to search for in the ControlCollection instance.

Returns

Boolean

true if the control was found in the collection; otherwise, false.

Examples

The following code example adds a Button control to the start of the document, and then displays the index of the button in a message box.

private void WordControlIndexOf()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.Button button1 =
        this.Controls.AddButton(0, 0, 56.25F, 17.25F,
        "button1");
    button1.Text = "OK";

    if (this.Controls.Contains(button1))
    {
        MessageBox.Show("The index of button1 is " + 
            Controls.IndexOf(button1));
    }
}

Private Sub WordControlIndexOf()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Button1 As Microsoft.Office.Tools.Word.Controls.Button _
        = Me.Controls.AddButton(0, 0, 56.25F, 17.25F, "Button1")
    Button1.Text = "OK"

    If Me.Controls.Contains(Button1) Then
        MessageBox.Show("The index of Button1 is " _
        & Controls.IndexOf(Button1))
    End If
End Sub

Applies to

Contains(String)

Determines whether a control with the specified name is a member of the ControlCollection instance.

public:
 bool Contains(System::String ^ name);
public bool Contains (string name);
abstract member Contains : string -> bool
Public Function Contains (name As String) As Boolean

Parameters

name
String

The name of the control you want to search for in the ControlCollection instance.

Returns

Boolean

true if the control was found in the collection; otherwise, false.

Applies to