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

  • 아티클

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

구문

HRESULT SetURL(
  [in] BSTR bstr
);

매개 변수

[in] bstr

형식: BSTR

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

반환 값

형식: HRESULT

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

반환 코드 설명
E_INVALIDARG
 인수가 잘못되었습니다.
E_ACCESSDENIED
 쓰기 액세스가 거부되었습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.

설명

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

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

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

요구 사항

   
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 tom.h
DLL Msftedit.dll

추가 정보

ITextRange2

ITextRange2::GetURL