ITextRange2::SetURL-Methode (tom.h)
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 |
---|---|
|
Ungültiges Argument. |
|
Der Schreibzugriff wird verweigert. |
|
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.
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 |