Share via


How to: Access the Outlook Item that Displays the Form Region

A form region appears when you open an item in Microsoft Office Outlook. You can access the Outlook item in which the form region appears by using the OutlookItem property of the FormRegionControl class.

Applies to: The information in this topic applies to application-level projects for Outlook 2007 and Outlook 2010. For more information, see Features Available by Office Application and Project Type.

More than one type of Outlook item can display a form region. You can determine what type of Outlook item is displaying the form region and then cast the Outlook item to that type.

The following example identifies the Outlook item as a mail item and then adds the subject of the mail item to a label on the form region.

Example

Private Sub FormRegion1_FormRegionShowing(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles MyBase.FormRegionShowing
    If TypeOf (Me.OutlookItem) Is Outlook.MailItem Then
        If Me.OutlookFormRegion.FormRegionMode = _
            Outlook.OlFormRegionMode.olFormRegionRead Then
            Dim mailItem As Outlook.MailItem = CType(Me.OutlookItem,  _
                Outlook.MailItem)
            Label1.Text = "This form region contains information " & _
                "about " & mailItem.Subject
        End If
    End If

End Sub
private void FormRegion1_FormRegionShowing
    (object sender, System.EventArgs e)
{
    if (this.OutlookItem is Outlook.MailItem)
    {
        if (this.OutlookFormRegion.FormRegionMode == 
            Outlook.OlFormRegionMode.olFormRegionRead)
        {
            Outlook.MailItem mailItem = 
            (Outlook.MailItem)this.OutlookItem;
            label1.Text = "This form region contains information " +
            "about " + mailItem.Subject;
        }
     }

}

See Also

Tasks

Walkthrough: Designing an Outlook Form Region

How to: Prevent Outlook from Displaying a Form Region

How to: Add a Form Region to an Outlook Add-in Project

Other Resources

Creating Outlook Form Regions