Kojarzenie regionu formularza z klasą wiadomości programu Outlook
Można określić elementy, które Microsoft Office Outlook wyświetlić region formularza przez skojarzenie region formularza z klasy wiadomości w każdej pozycji.Na przykład, jeśli chcesz dołączyć region formularza do dolnej części elementu poczty można skojarzyć region formularza z IPM.Note klasą wiadomości.
Aby skojarzyć region formularza z klasy wiadomości, należy określić nazwę klasy wiadomości w Nowego regionu formularza programu Outlook kreatora lub zastosować atrybut do klasy fabrycznej regionu formularza.
Dotyczy: Informacje przedstawione w tym temacie dotyczą projektów na poziomie aplikacji dla programów Outlook 2013 i Outlook 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacji pakietu Office i typ projektu.
Opis klas wiadomości programu Outlook
Klasa wiadomości programu Outlook identyfikuje typ element programu Outlook.Poniższa tabela zawiera listę tych ośmiu standardowe typy elementów i ich nazwy klasy wiadomości.
Typ elementu programu Outlook |
Nazwa klasy wiadomości |
---|---|
AppointmentItem |
IPM.Termin |
ContactItem |
IPM.Kontakt |
DistListItem |
IPM.DistList |
JournalItem |
IPM.Aktywność |
MailItem |
IPM.Uwaga |
PostItem |
IPM.POST lub IPM.Post.RSS |
TaskItem |
IPM.Zadanie |
Można również określić nazwy klasy niestandardowej wiadomości.Komunikat niestandardowy klas identyfikują formularzy niestandardowych, zdefiniowanych przez użytkownika w programie Outlook.
[!UWAGA]
Wymiana i regionów formularzy Zamień wszystkie można określić nazwę nowej klasy komunikat niestandardowy.Nie należy używać nazwy klasy wiadomości istniejącego formularza niestandardowego.Nazwa klasy komunikat niestandardowy musi być unikatowa.Jednym ze sposobów zapewnienia, że nazwa jest unikatowa jest podobny do następującego konwencję nazewnictwa: <StandardMessageClassName>. <firmy>. <MessageClassName> (na przykład: IPM.Note.Contoso.MyMessageClass).
Kojarzenie Region formularza z klasy wiadomości programu Outlook
Aby skojarzyć region formularza z klasy wiadomości na dwa sposoby:
Użycie Nowego regionu formularza programu Outlook kreatora.
Stosowanie atrybutów klasy.
Korzystając z Kreatora nowego regionu formularza programu Outlook
Na ostatniej stronie Nowego regionu formularza programu Outlook kreatora, można wybrać standardowy komunikat klas i wpisz nazwy klasy niestandardowej wiadomości, które chcesz skojarzyć z regionu formularza.
Klas standardowych wiadomości nie są dostępne, jeśli region formularza jest zaprojektowany w celu zastąpienia całego formularza lub domyślną stronę formularza.Można określić nazwy klasy standardowych wiadomości tylko dla formularzy, Dodawanie nowej strony do formularza, lub które są dołączane do dolnej części formularza.Aby uzyskać więcej informacji, zobacz Jak: dodawanie regionu formularza do programu Outlook dodać w projekcie.
Aby dołączyć jeden lub więcej klas niestandardowy komunikat, wpisz ich nazwy w klas niestandardowych wiadomości, które będą wyświetlane ten region formularza? pole.
Wpisywane nazwy muszą być zgodne z następującymi wytycznymi:
Użyj komunikatu w pełni kwalifikowaną nazwę klasy (na przykład: "IPM.Note.Contoso").
Użyj średników do oddzielenia wielu nazw klasy wiadomości.
Nie obejmują standardowe klasy wiadomości programu Outlook, takie jak "IPM.Uwaga"lub"IPM.Skontaktuj się z".Dołącz tylko klasy niestandardowy komunikat, takie jak "IPM.Note.Contoso".
Nie określono klasy podstawowej wiadomości przez siebie (na przykład: "IPM").
Nie może przekraczać 256 znaków dla każdej nazwy klasy wiadomości.
Nowego regionu formularza programu Outlook Kreator sprawdza format wejściowego, po kliknięciu przycisku wykończenie.
[!UWAGA]
Nowego regionu formularza programu Outlook Kreator sprawdza, czy nazwy klasy wiadomości, które podasz są prawidłowe lub nieprawidłowe.
Po zakończeniu pracy kreatora, Nowego regionu formularza programu Outlook Kreator zastosuje atrybuty do klasy region formularza, które zawierają nazwy klasy określonej wiadomości.Atrybuty te można także zastosować ręcznie.
Stosowanie atrybutów klasy
Region formularza można skojarzyć z klasy wiadomości programu Outlook, po zakończeniu pracy Nowego regionu formularza programu Outlook kreatora.Aby to zrobić, należy zastosować atrybutów do klasy fabrycznej regionu formularza.
W poniższym przykładzie przedstawiono dwa FormRegionMessageClassAttribute atrybuty, które zostały zastosowane do klasy fabrycznej region formularza o nazwie myFormRegion.Pierwszy atrybut kojarzy region formularza z klasy standardowych wiadomości dla formularza wiadomości poczty.Drugi atrybut kojarzy region formularza z wiadomością niestandardową klasę o nazwie IPM.Task.Contoso.
<Microsoft.Office.Tools.Outlook.FormRegionMessageClass(Microsoft.Office.Tools.Outlook.FormRegionMessageClassAttribute.Note)> _
<Microsoft.Office.Tools.Outlook.FormRegionMessageClass("IPM.Task.Contoso")> _
<Microsoft.Office.Tools.Outlook.FormRegionName("Trin_Outlook_FR_Attributes.FormRegion1")> _
Partial Public Class FormRegion1Factory
' Occurs before the form region is initialized.
' To prevent the form region from appearing, set e.Cancel to true.
' Use e.OutlookItem to get a reference to the current Outlook item.
Private Sub FormRegion1Factory_FormRegionInitializing(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs) Handles Me.FormRegionInitializing
End Sub
[Microsoft.Office.Tools.Outlook.FormRegionMessageClass
(Microsoft.Office.Tools.Outlook.FormRegionMessageClassAttribute.Note)]
[Microsoft.Office.Tools.Outlook.FormRegionMessageClass
("IPM.Task.Contoso")]
[Microsoft.Office.Tools.Outlook.FormRegionName
("Trin_Outlook_FR_Attributes.FormRegion1")]
public partial class FormRegion1Factory
{
// Occurs before the form region is initialized.
// To prevent the form region from appearing, set e.Cancel to true.
// Use e.OutlookItem to get a reference to the current Outlook item.
private void FormRegion1Factory_FormRegionInitializing(object sender,
Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs e)
{
}
}
Atrybuty muszą być zgodne z następującymi wytycznymi:
Klasy niestandardowe wiadomości, można użyć w wiadomości w pełni kwalifikowaną nazwę klasy (na przykład: "IPM.Note.Contoso").
Nie określono klasy podstawowej wiadomości przez siebie (na przykład: "IPM").
Nie może przekraczać 256 znaków dla każdej nazwy klasy wiadomości.
Nie zawierają nazwy klas standardowy komunikat, jeśli region formularza zastępuje cały formularz lub domyślną stronę formularza.Można określić nazwy klasy standardowych wiadomości tylko dla formularzy, Dodawanie nowej strony do formularza, lub które są dołączane do dolnej części formularza.Aby uzyskać więcej informacji, zobacz Jak: dodawanie regionu formularza do programu Outlook dodać w projekcie.
Visual Studio sprawdza poprawność formatu nazwy klasy wiadomości podczas budowania projektu.
[!UWAGA]
Visual Studio sprawdza, czy nazwy klasy wiadomości, które podasz są prawidłowe lub nieprawidłowe.
Zobacz też
Zadania
Instruktaż: Projektowanie regionu formularza programu Outlook
Informacje
O klasie formularza nazwę i wiadomość
współpracują ze sobą jak Outlook formy i elementy
Koncepcje
Uzyskiwanie dostępu do regionu formularza w czasie wykonywania
Wskazówki dotyczące tworzenia regionów formularzy programu Outlook