Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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, Nachrichten Compose 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 (klassisches Windows, Mac) 1.8 (Web, neues Windows) |
| Nachricht verfassen |
1.1 (klassisches Windows, Mac) 1.8 (Web, neues Windows) |
||
| 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 (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 | ||
| sendAsync([options], [callback]) | Lese-/Schreibpostfach | Terminplaner | 1.15 |
| Nachricht verfassen | 1.15 | ||
| 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 |
InitializationContextChanged |
Der Aufgabenbereich eines Add-Ins wurde über eine umsetzbare Nachricht, InsightMessage eine Benachrichtigung, ein Dialogfeld für intelligente Warnungen oder ein integriertes Dialogfeld zur Spamberichterstattung geöffnet. Nur bei der Implementierung des Aufgabenbereichs verfügbar. |
1.15 |
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