Inspector.SetControlItemProperty Method

  • Article
Outlook Developer Reference

Binds an Outlook object model property to a control in an inspector.

Syntax

expression.SetControlItemProperty(Control, PropertyName)

expression   A variable that represents an Inspector object.

Parameters

Name Required/Optional Data Type Description
Control Required Object The control that will be bound to a property.
PropertyName Required String The name of the property that will be bound to the control.

Remarks

You can also use the following line of code myPage.Controls("bar").ItemProperty = "subject" to bind the subject property to a control. However, note that untrusted code using this will trigger a security warning if the property is protected by the object model security guard such as To, and the client computer is running Microsoft Office Outlook 2007 but does not have an appropriately set up antivirus software. You can use the SetControlItemProperty method to avoid security warnings with trusted applications. For more information, see Security Behavior for the Outlook Object Model.

Example

The following Visual Basic for Applications (VBA) code adds a custom page to an appointment item, adds a custom textbox control, and binds that control to Subject property.

Visual Basic for Applications 
  Sub Example()
    Dim myIns As Outlook.Inspector
    Dim myAppt As Outlook.AppointmentItem
    Dim ctrl As Object
    Dim ctrls As Object
    Dim myPages As Outlook.Pages
    Dim myPage As Object
    
    Set myAppt = Application.CreateItem(olAppointmentItem)
    Set myIns = myAppt.GetInspector
    
    Set myPages = myIns.ModifiedFormPages
    Set myPage = myPages.Add("New Page")
    myIns.ShowFormPage ("New Page")
    Set ctrls = myPage.Controls
    Set ctrl = ctrls.Add("Forms.TextBox.1")
    
    myIns.SetControlItemProperty ctrl, "Subject"
    
    myAppt.Display
End Sub

See Also