item (Postfachanforderungssatz 1.11)
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 | ||
| 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 |
| 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 |
| 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 | ||
| 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.
Wichtig
Ereignisse sind nur bei der Implementierung des Aufgabenbereichs verfügbar.
| Document.SelectionChanged -Ereignis | Beschreibung | Minimum Anforderungssatz |
|---|---|---|
AppointmentTimeChanged |
Das Datum oder die Uhrzeit des ausgewählten Termins oder der ausgewählten Reihe wurde geändert. | 1.7 |
AttachmentsChanged |
Eine Anlage wurde dem Element hinzugefügt oder daraus entfernt. | 1.8 |
EnhancedLocationsChanged |
Der Speicherort des ausgewählten Termins wurde geändert. | 1.8 |
InfobarClicked |
Eine Aktion wurde aus einer Benachrichtigung ausgewählt. | 1.10 |
RecipientsChanged |
Die Empfängerliste des ausgewählten Elements oder des ausgewählten Terminspeicherorts wurde geändert. | 1.7 |
RecurrenceChanged |
Das Serienmuster der ausgewählten Reihe wurde geändert. | 1.7 |
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