item (Anforderungssatz für Postfachvorschau)
Office.context.mailbox.item
item wird für den Zugriff auf die aktuell ausgewählte Nachricht, Besprechungsanfrage oder Termin verwendet. Sie können den Typ des Elements mithilfe der itemType -Eigenschaft bestimmen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestversion des Postfachanforderungssatzes | 1.1 |
| Mindestberechtigungsstufe | eingeschränkt |
| Zutreffender Outlook-Modus | Terminorganisator, Terminteilnehmer, Verfassen von Nachrichten oder Lesen von Nachrichten |
Wichtig
Android und iOS: Es gibt Einschränkungen, wann Add-Ins aktiviert werden und welche APIs verfügbar sind. Weitere Informationen finden Sie unter Hinzufügen von mobiler Unterstützung zu einem Outlook-Add-In.
Eigenschaften
Methoden
| Methode | Minimum Berechtigungsstufe |
Details nach Modus | Minimum Anforderungssatz |
|---|---|---|---|
| addFileAttachmentAsync(uri, attachmentName, [options], [callback]) | Element lesen/schreiben | Terminplaner | 1.1 |
| Nachricht verfassen | 1.1 | ||
| addFileAttachmentFromBase64Async(base64File, attachmentName, [options], [callback]) | Element lesen/schreiben | Terminplaner | 1.8 |
| Nachricht verfassen | 1.8 | ||
| addHandlerAsync(eventType, handler, [options], [callback]) | Element lesen | Terminplaner | 1.7 |
| Terminteilnehmer | 1.7 | ||
| Nachricht verfassen | 1.7 | ||
| Nachricht lesen | 1.7 | ||
| addItemAttachmentAsync(itemId, attachmentName, [options], [callback]) | Element lesen/schreiben | Terminplaner | 1.1 |
| Nachricht verfassen | 1.1 | ||
| close() | eingeschränkt | Terminplaner | 1.3 |
| Nachricht verfassen | 1.3 | ||
| closeAsync([options], [callback]) | Element lesen/schreiben | Nachricht verfassen | 1.14 |
| disableClientSignatureAsync([options], [callback]) | Element lesen/schreiben | Terminplaner | 1.10 |
| Nachricht verfassen | 1.10 | ||
| displayReplyAllForm(formData) | Element lesen | Terminteilnehmer | 1.1 |
| Nachricht lesen | 1.1 | ||
| displayReplyAllFormAsync(formData, [options], [callback]) | Element lesen | Terminteilnehmer | 1.9 |
| Nachricht lesen | 1.9 | ||
| displayReplyForm(formData) | Element lesen | Terminteilnehmer | 1.1 |
| Nachricht lesen | 1.1 | ||
| displayReplyFormAsync(formData, [options], [callback]) | Element lesen | Terminteilnehmer | 1.9 |
| Nachricht lesen | 1.9 | ||
| getAllInternetHeadersAsync([options], [callback]) | Element lesen | Nachricht lesen | 1.8 |
| getAsFileAsync([options], callback) | Element lesen | Nachricht lesen | 1.14 |
| getAttachmentContentAsync(attachmentId, [options], [callback]) | Element lesen | Terminplaner | 1.8 |
| Terminteilnehmer | 1.8 | ||
| Nachricht verfassen | 1.8 | ||
| Nachricht lesen | 1.8 | ||
| getAttachmentsAsync([options], [callback]) | Element lesen | Terminplaner | 1.8 |
| Nachricht verfassen | 1.8 | ||
| getComposeTypeAsync([options], callback) | Element lesen | Nachricht verfassen | 1.10 |
| getConversationIndexAsync([options], callback) | Element lesen | Nachricht verfassen | 1.14 |
| getEntities() (veraltet) | Element lesen | Terminteilnehmer | 1.1 |
| Nachricht lesen | 1.1 | ||
| getEntitiesByType(entityType) (veraltet) | eingeschränkt | Terminteilnehmer | 1.1 |
| Nachricht lesen | 1.1 | ||
| getFilteredEntitiesByName(name) (veraltet) | Element lesen | Terminteilnehmer | 1.1 |
| Nachricht lesen | 1.1 | ||
| getInitializationContextAsync([options], [callback]) | Element lesen | Terminplaner | 1.8 |
| Terminteilnehmer | 1.8 | ||
| Nachricht verfassen | 1.8 | ||
| Nachricht lesen | 1.8 | ||
| getItemClassAsync([options], callback) | Element lesen | Nachricht verfassen | 1.14 |
| getItemIdAsync([options], callback) | Element lesen | Terminplaner | 1.8 |
| Nachricht verfassen | 1.8 | ||
| getRegExMatches() | Element lesen | Terminteilnehmer | 1.1 |
| Nachricht lesen | 1.1 | ||
| getRegExMatchesByName(name) | Element lesen | Terminteilnehmer | 1.1 |
| Nachricht lesen | 1.1 | ||
| getSelectedDataAsync(coercionType, [options], callback) | Element lesen | Terminplaner | 1.2 |
| Nachricht verfassen | 1.2 | ||
| getSelectedEntities() (veraltet) | Element lesen | Terminteilnehmer | 1.6 |
| Nachricht lesen | 1.6 | ||
| getSelectedRegExMatches() | Element lesen | Terminteilnehmer | 1.6 |
| Nachricht lesen | 1.6 | ||
| getSharedPropertiesAsync([options], callback) | Element lesen | Terminplaner | 1.8 |
| Terminteilnehmer | 1.8 | ||
| Nachricht verfassen | 1.8 | ||
| Nachricht lesen | 1.8 | ||
| isClientSignatureEnabledAsync([options], callback) | Element lesen | Terminplaner | 1.10 |
| Nachricht verfassen | 1.10 | ||
| loadCustomPropertiesAsync(callback, [userContext]) | Element lesen | Terminplaner | 1.1 |
| Terminteilnehmer | 1.1 | ||
| Nachricht verfassen | 1.1 | ||
| Nachricht lesen | 1.1 | ||
| removeAttachmentAsync(attachmentId, [options], [callback]) | Element lesen/schreiben | Terminplaner | 1.1 |
| Nachricht verfassen | 1.1 | ||
| removeHandlerAsync(eventType, [options], [callback]) | Element lesen | Terminplaner | 1.7 |
| Terminteilnehmer | 1.7 | ||
| Nachricht verfassen | 1.7 | ||
| Nachricht lesen | 1.7 | ||
| saveAsync([options], callback) | Element lesen/schreiben | Terminplaner | 1.3 |
| Nachricht verfassen | 1.3 | ||
| setSelectedDataAsync(data, [options], callback) | Element lesen/schreiben | Terminplaner | 1.2 |
| Nachricht verfassen | 1.2 |
Ereignisse
Sie können die folgenden Ereignisse mit bzwremoveHandlerAsync. abonnieren addHandlerAsync bzw. kündigen.
| Document.SelectionChanged -Ereignis | Beschreibung | Minimum Anforderungssatz |
|---|---|---|
AppointmentTimeChanged |
Das Datum oder die Uhrzeit des ausgewählten Termins oder der ausgewählten Reihe wurde geändert. Nur bei der Implementierung des Aufgabenbereichs verfügbar. | 1.7 |
AttachmentsChanged |
Eine Anlage wurde dem Element hinzugefügt oder daraus entfernt. Nur bei der Implementierung des Aufgabenbereichs verfügbar. | 1.8 |
EnhancedLocationsChanged |
Der Speicherort des ausgewählten Termins wurde geändert. Nur bei der Implementierung des Aufgabenbereichs verfügbar. | 1.8 |
InfobarClicked |
Eine Aktion wurde aus einer Benachrichtigung ausgewählt. Nur bei der Implementierung des Aufgabenbereichs verfügbar. | 1.10 |
RecipientsChanged |
Die Empfängerliste des ausgewählten Elements oder des ausgewählten Terminspeicherorts wurde geändert. Nur bei der Implementierung des Aufgabenbereichs verfügbar. | 1.7 |
RecurrenceChanged |
Das Serienmuster der ausgewählten Reihe wurde geändert. Nur bei der Implementierung des Aufgabenbereichs verfügbar. | 1.7 |
SensitivityLabelChanged |
Die Vertraulichkeitsbezeichnung einer Nachricht oder eines Termins im Verfassenmodus wurde geändert. Nur bei der Implementierung des Aufgabenbereichs verfügbar. | 1.13 |
SpamReporting |
In Outlook wurde eine nicht angeforderte Nachricht gemeldet. Nur mit einem Funktionsbefehl verfügbar. | 1.14 |
Beispiel
Im folgenden JavaScript-Codebeispiel wird der Zugriff auf die subject-Eigenschaft des aktuellen Elements in Outlook veranschaulicht.
// The initialize function is required for all apps.
Office.initialize = function () {
// Checks for the DOM to load using the jQuery ready method.
$(document).ready(function () {
// After the DOM is loaded, app-specific code can run.
const item = Office.context.mailbox.item;
const subject = item.subject;
// Continue with processing the subject of the current item,
// which can be a message or appointment.
});
};
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
Office Add-ins