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