Office.Subject interface
Bietet Methoden zum Abrufen und Festlegen des Betreffs eines Termins oder einer Nachricht in einem Outlook-Add-In.
Methoden
| get |
Ruft den Betreff eines Termins oder einer Nachricht ab. Die |
| get |
Ruft den Betreff eines Termins oder einer Nachricht ab. Die |
| set |
Legt den Betreff eines Termins oder einer Nachricht fest. Die |
| set |
Legt den Betreff eines Termins oder einer Nachricht fest. Die |
Details zur Methode
getAsync(options, callback)
Ruft den Betreff eines Termins oder einer Nachricht ab.
Die getAsync-Methode startet einen asynchronen Aufruf an den Exchange-Server, um den Betreff eines Termins oder einer Nachricht abzurufen.
getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;Parameter
- options
- Office.AsyncContextOptions
Ein Objektliteral, das eine oder mehrere der folgenden Eigenschaften enthält: asyncContext: Entwickler können jedes Objekt, auf das sie zugreifen möchten, in der Rückruffunktion bereitstellen.
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen. Die value Eigenschaft des Ergebnisses ist der Gegenstand des Elements.
Gibt zurück
void
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose
getAsync(callback)
Ruft den Betreff eines Termins oder einer Nachricht ab.
Die getAsync-Methode startet einen asynchronen Aufruf an den Exchange-Server, um den Betreff eines Termins oder einer Nachricht abzurufen.
getAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;Parameter
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen. Die value Eigenschaft des Ergebnisses ist der Gegenstand des Elements.
Gibt zurück
void
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose
Beispiele
Office.context.mailbox.item.subject.getAsync(callback);
function callback(asyncResult) {
const subject = asyncResult.value;
}
setAsync(subject, options, callback)
Legt den Betreff eines Termins oder einer Nachricht fest.
Die setAsync-Methode startet einen asynchronen Aufruf an den Exchange-Server, den Betreff eines Termins oder einer Nachricht festzulegen. Durch das Festlegen des Betreffs wird der aktuelle Betreff überschrieben, Präfixe wie "WG:" oder "AW:" bleiben jedoch erhalten.
setAsync(subject: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;Parameter
- subject
-
string
Der Betreff des Termins oder der Nachricht. Die Zeichenfolge ist auf 255 Zeichen beschränkt.
- options
- Office.AsyncContextOptions
Ein Objektliteral, das eine oder mehrere der folgenden Eigenschaften enthält: asyncContext: Entwickler können jedes Objekt, auf das sie zugreifen möchten, in der Rückruffunktion bereitstellen.
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Optional. Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen. Wenn das Festlegen des Betreffs fehlschlägt, enthält die asyncResult.error-Eigenschaft einen Fehlercode.
Gibt zurück
void
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose
Wichtig:
In Outlook unter Android und iOS wird diese Methode im Modus "Message Compose" nicht unterstützt. Nur der Terminorganisatormodus wird unterstützt. Weitere Informationen zu unterstützten APIs in Outlook Mobile finden Sie unter In Outlook auf Mobilgeräten unterstützte Outlook-JavaScript-APIs.
Die
setAsyncMethode wird für eine Nachricht, die derzeit mit derloadItemByIdAsyncMethode geladen wird, nicht unterstützt. Weitere Informationen finden Sie unter "Aktivieren Ihres Outlook-Add-Ins für mehrere Nachrichten".
Fehler:
-
DataExceedsMaximumSize: Der Parameter "Betreff" ist länger als 255 Zeichen.
Beispiele
Office.context.mailbox.item.subject.setAsync("New subject!", function (asyncResult) {
if (asyncResult.status === "failed") {
console.log("Action failed with error: " + asyncResult.error.message);
}
});
setAsync(subject, callback)
Legt den Betreff eines Termins oder einer Nachricht fest.
Die setAsync-Methode startet einen asynchronen Aufruf an den Exchange-Server, den Betreff eines Termins oder einer Nachricht festzulegen. Durch das Festlegen des Betreffs wird der aktuelle Betreff überschrieben, Präfixe wie "WG:" oder "AW:" bleiben jedoch erhalten.
setAsync(subject: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;Parameter
- subject
-
string
Der Betreff des Termins oder der Nachricht. Die Zeichenfolge ist auf 255 Zeichen beschränkt.
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Optional. Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen. Wenn das Festlegen des Betreffs fehlschlägt, enthält die asyncResult.error-Eigenschaft einen Fehlercode.
Gibt zurück
void
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose
Wichtig:
In Outlook unter Android und iOS wird diese Methode im Modus "Message Compose" nicht unterstützt. Nur der Terminorganisatormodus wird unterstützt. Weitere Informationen zu unterstützten APIs in Outlook Mobile finden Sie unter In Outlook auf Mobilgeräten unterstützte Outlook-JavaScript-APIs.
Die
setAsyncMethode wird für eine Nachricht, die derzeit mit derloadItemByIdAsyncMethode geladen wird, nicht unterstützt. Weitere Informationen finden Sie unter "Aktivieren Ihres Outlook-Add-Ins für mehrere Nachrichten".
Fehler:
-
DataExceedsMaximumSize: Der Parameter "Betreff" ist länger als 255 Zeichen.