Metode ITextRange2::SetURL (tom.h)

  • Artikel

Mengatur teks dalam rentang ini ke URL yang ditentukan.

Sintaks

HRESULT SetURL(
  [in] BSTR bstr
);

Parameter

[in] bstr

Jenis: BSTR

Teks yang akan digunakan sebagai URL untuk nama bersahabat yang dipilih.

Menampilkan nilai

Jenis: HRESULT

Jika metode berhasil, metode akan mengembalikan S_OK. Jika metode gagal, metode mengembalikan salah satu kode kesalahan COM berikut. Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Penanganan Kesalahan di COM.

Menampilkan kode Deskripsi
E_INVALIDARG
 Argumen tidak valid.
E_ACCESSDENIED
 Akses tulis ditolak.
E_OUTOFMEMORY
 Memori tidak cukup.

Keterangan

String URL tidak divalidasi. Teks yang dikandungnya harus diapit dalam tanda kutip, secara opsional didahului oleh karakter sentinel 0xFDDF. Misalnya: "http://www.msn.com" atau 0xFDDF"http://www.msn.com". Rentang harus nondegenerasi.

Tindakan berikut dimungkinkan:

  • Jika bagian dari nama yang mudah diingat tautan dipilih, bagian URL diganti dengan bstr.
  • Jika bagian dari URL reguler dipilih, itu menjadi nama yang mudah diingat tautan, dengan bstr sebagai URL.
  • Jika teks nonlink dipilih:
    • Jika teks segera mengikuti nama yang mudah diingat tautan dan bstr cocok dengan URL, teks ditambahkan ke nama yang mudah diingat.
    • Jika tidak, teks menjadi nama tautan yang mudah diingat, dengan bstr sebagai URL.
Rentang teks disesuaikan ke posisi karakter yang berbeda setelah memanggil SetURL.

Persyaratan

   
Klien minimum yang didukung Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header tom.h
DLL Msftedit.dll

Lihat juga

ITextRange2

ITextRange2::GetURL