ITextRange2::SetURL 메서드(tom.h)

이 범위의 텍스트를 지정된 URL의 텍스트로 설정합니다.

구문

HRESULT SetURL(
  [in] BSTR bstr
);

[in] bstr

형식: BSTR

선택한 식별 이름의 URL로 사용할 텍스트입니다.

형식: HRESULT

메서드가 성공하면 S_OK 반환합니다. 메서드가 실패하면 다음 COM 오류 코드 중 하나를 반환합니다. COM 오류 코드에 대한 자세한 내용은 COM에서 오류 처리를 참조하세요.

URL 문자열의 유효성이 검사되지 않습니다. 포함된 텍스트는 선택적으로 sentinel 문자 0xFDDF 앞에 따옴표로 묶어야 합니다. 예: "http://www.msn.com" 또는 0xFDDF"http://www.msn.com". 범위는 비일반적이어야 합니다.

가능한 작업은 다음과 같습니다.

링크의 식별 이름 일부를 선택하면 URL 부분이 bstr로 바뀝니다.
일반 URL의 일부를 선택하면 bstr 을 URL로 사용하여 링크의 식별 이름이 됩니다.
연결되지 않은 텍스트를 선택한 경우:
- 텍스트가 링크의 식별 이름 바로 뒤에 있고 bstr 이 URL과 일치하면 텍스트가 식별 이름에 추가됩니다.
- 그렇지 않으면 텍스트가 링크의 식별 이름이 되며 bstr 을 URL로 사용합니다.

SetURL을 호출한 후 텍스트 범위를 다른 문자 위치로 조정합니다.