ITextRange2::SetURL-Methode (tom.h)

  • Artikel

Legt den Text in diesem Bereich auf den der angegebenen URL fest.

Syntax

HRESULT SetURL(
  [in] BSTR bstr
);

Parameter

[in] bstr

Typ: BSTR

Der Text, der als URL für den ausgewählten Anzeigenamen verwendet werden soll.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Wenn die Methode fehlschlägt, gibt sie einen der folgenden COM-Fehlercodes zurück. Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Rückgabecode Beschreibung
E_INVALIDARG
 Ungültiges Argument.
E_ACCESSDENIED
 Der Schreibzugriff wird verweigert.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.

Hinweise

Die URL-Zeichenfolge wird nicht überprüft. Der enthaltene Text muss in Anführungszeichen eingeschlossen werden, optional voran das Sentinelzeichen 0xFDDF. Beispiel: "http://www.msn.com" oder 0xFDDF"http://www.msn.com". Der Bereich muss nicht entartet sein.

Die folgenden Aktionen sind möglich:

  • Wenn ein Teil des Anzeigenamens eines Links ausgewählt ist, wird der URL-Teil durch bstr ersetzt.
  • Wenn ein Teil einer regulären URL ausgewählt ist, wird er zum Anzeigenamen des Links mit bstr als URL.
  • Wenn nicht verknüpfter Text ausgewählt ist:
    • Wenn der Text sofort dem Anzeigenamen eines Links folgt und bstr mit der URL übereinstimmt, wird der Text an den Anzeigenamen angefügt.
    • Andernfalls wird der Text zum Anzeigenamen eines Links mit bstr als URL.
Der Textbereich wird nach dem Aufruf von SetURL an unterschiedliche Zeichenpositionen angepasst.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile tom.h
DLL Msftedit.dll

Weitere Informationen

ITextRange2

ITextRange2::GetURL