Informationen zu Benachrichtigungen für Anzeigetabellen
Gilt für: Outlook 2013 | Outlook 2016
Benachrichtigungen für eine Anzeigetabelle werden vom Dienstanbieter, der für die Erstellung der Anzeigetabelle zuständig ist, an MAPI gesendet. MAPI registriert sich für diese Benachrichtigungen, indem die IMAPITable::Advise-Methode einer Anzeigetabelle aufgerufen und das Table Modified-Ereignis angegeben wird.
Wie bei allen Tabellenbenachrichtigungen enthalten die Anzeigetabellenbenachrichtigungen eine TABLE_NOTIFICATION Struktur. Nur die Member ulTableEvent und propIndex dieser Struktur sind von Bedeutung. die anderen Member werden ignoriert. Das ulTableEvent-Element wird auf TABLE_ROW_MODIFIED und das propIndex-Element auf den Wert der spalte PR_CONTROL_ID (PidTagControlId) in der entsprechenden Zeile festgelegt. MAPI antwortet auf die Benachrichtigung, indem die IMAPIProp::GetProps-Methode für die im Steuerelement angezeigte Eigenschaft aufgerufen und der neue Wert angezeigt wird.
Anzeigetabellenbenachrichtigungen können von einem Dienstanbieter verwendet werden, um Änderungen an verwandten Steuerelementen im Dialogfeld zu koordinieren. Wenn die Implementierung der Eigenschaftenschnittstelle beispielsweise ein oder mehrere Felder im Dialogfeld aktualisieren muss , z. B. als Reaktion auf ein anderes Steuerelement, das das DT_SET_IMMEDIATE-Flag in seiner PR_CONTROL_FLAGS-Eigenschaft (PidTagControlFlags) festgelegt hat, kann eine Anzeigetabellenbenachrichtigung generiert werden. Eine Anzeigetabellenbenachrichtigung kann die Implementierung der Eigenschaftenschnittstelle darauf aufmerksam machen, dass der Wert eines oder mehrerer Steuerelemente aufgrund einer Änderung oder eines externen Ereignisses erneut gelesen werden muss.
Ein Dienstanbieter kann Anzeigetabellenbenachrichtigungen wie folgt ausgeben:
Aufrufen von ITableData::HrNotify, wenn die Anzeigetabelle mit einem Tabellendatenobjekt erstellt wurde.
- Oder-
Verwenden des eigenen Codes, wenn die Anzeigetabelle mit der IMAPITable-Implementierung des Anbieters erstellt wurde.
MAPI reagiert bei Bedarf auf die Anzeige von Tabellenbenachrichtigungen, indem der Wert eines Steuerelements aus der Implementierung der Eigenschaftenschnittstelle erneut gelesen wird. In der folgenden Tabelle werden die Details zur Behandlung von Benachrichtigungen für bestimmte Steuerelementtypen durch MAPI beschrieben.
| Control | MAPI-Aktion |
|---|---|
| Schaltfläche |
Ruft IMAPIProp::OpenPropertyauf, um das Steuerelementobjekt über die Eigenschaft abzurufen, die durch den ulPRControl-Member der DTBLBUTTON-Struktur dargestellt wird, wenn der Aufruf zuvor fehlgeschlagen war. Ruft die IMAPIControl::GetState des Steuerelementobjekts auf, um zu bestimmen, ob die Schaltfläche aktiviert werden soll, und aktiviert oder deaktiviert die Schaltfläche entsprechend. |
| Kontrollkästchen |
Liest den Wert für das ulPRPropertyName-Element erneut. |
| Kombinationsfeld |
Öffnet die Tabelle, die dem ulPRTableName-Member der DTBLCOMBOBOX-Struktur zugeordnet ist, erneut. Liest alle Zeilen, einschließlich des Werts für das ulPRPropertyName-Element, erneut. |
| Dropdownlistenfeld |
Öffnet die Tabelle, die dem ulPRTableName-Member der DTBLDDLBX-Struktur zugeordnet ist, und liest alle Zeilen erneut. Ruft IMAPIProp::GetProps auf, um die Werte für die Eigenschaften abzurufen, die in den Membern ulPRDisplayProperty und ulPRSetProperty gespeichert sind. |
| Bearbeiten |
Liest die -Eigenschaft neu und zeigt es erneut an. |
| Gruppenfeld |
Ignoriert die Benachrichtigung. |
| Label |
Ignoriert die Benachrichtigung. |
| Listenfeld "Mehrfachauswahl" |
Wenn eine der Spalten ein Eintragsbezeichner ist, aktualisiert das Listenfeld. Das entsprechende Objekt wird nicht geschlossen oder neu geladen. |
| Listenfeld "Einzelauswahl" |
Liest die set-Eigenschaft und versucht, sie zu identifizieren. |
| Mehrwertiges Listenfeld |
Liest die Eigenschaft erneut und füllt das Listenfeld erneut auf. |
| Seite im Registerkartenformat |
Es gibt keine Benachrichtigungen für dieses Steuerelement. alles ist statisch. |
| Optionsfeld |
Liest die Eigenschaft, die der Schaltfläche zugeordnet ist und im ulPropTag-Member der DTBLRADIOBUTTON-Struktur gespeichert wird, erneut und trifft die entsprechende Auswahl mit den Steuerelementen. |