item (Postfachanforderungssatz 1.13)
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 | Beschrä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() | Beschrä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() | Element lesen | Terminteilnehmer | 1.1 |
| Nachricht lesen | 1.1 | ||
| getEntitiesByType(entityType) | Beschränkt | Terminteilnehmer | 1.1 |
| Nachricht lesen | 1.1 | ||
| getFilteredEntitiesByName(name) | 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() | 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 (Unterstützung freigegebener Ordner) 1.13 (Unterstützung freigegebener Postfächer) |
| Terminteilnehmer | 1.8 (Unterstützung freigegebener Ordner) 1.13 (Unterstützung freigegebener Postfächer) |
||
| Nachricht verfassen | 1.8 (Unterstützung freigegebener Ordner) 1.13 (Unterstützung freigegebener Postfächer) |
||
| Nachricht lesen | 1.8 (Unterstützung freigegebener Ordner) 1.13 (Unterstützung freigegebener Postfächer) |
||
| 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 |
Veranstaltungen
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 |
SensitivityLabelChanged |
Die Vertraulichkeitsbezeichnung einer Nachricht oder eines Termins im Verfassenmodus wurde geändert. | 1.13 |
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 function.
$(document).ready(function () {
// After the DOM is loaded, app-specific code can run.
var item = Office.context.mailbox.item;
var 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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für