EM_AUTOURLDETECT 메시지

  • 아티클

서식 있는 편집 컨트롤을 통해 하이퍼링크의 자동 검색을 사용하거나 사용하지 않도록 설정합니다.

매개 변수

wParam

자동 링크 검색을 사용하지 않도록 설정하려면 0을 지정하거나 다음 값 중 하나를 지정하여 다양한 종류의 검색을 사용하도록 설정합니다.

값 의미
AURL_DISABLEMIXEDLGC
 Windows 8: 라틴어, 그리스어 및 키릴 자모 스크립트 중 하나 이상에 속하는 문자가 있는 레이블이 포함된 도메인 이름 인식을 사용하지 않도록 설정합니다.
AURL_ENABLEDRIVELETTERS
 Windows 8: c:\temp와 같은 선행 드라이브 사양이 있는 파일 이름을 인식합니다.
AURL_ENABLEEA
 이 값은 더 이상 사용되지 않으며 대신 AURL_ENABLEEAURLS를 사용합니다.
AURL_ENABLEEAURLS
 동아시아 문자가 포함된 URL을 인식합니다.
AURL_ENABLEEMAILADDR
 Windows 8: 이메일 주소를 인식합니다.
AURL_ENABLETELNO
 Windows 8: 전화 번호를 인식합니다.
AURL_ENABLEURL
 Windows 8: 경로를 포함하는 URL을 인식합니다.

lParam

이 매개 변수는 AURL_ENABLEURL이 활성 상태인 경우 인식되는 URL 스키마를 결정합니다. lParam이 NULL인 경우 기본 스키마 이름 목록이 사용됩니다(설명 참조). 또는 lParam은 기본 스키마 이름 목록을 대체하는 최대 50개의 콜론으로 끝나는 스키마 이름으로 구성된 null로 끝나는 문자열을 가리킬 수 있습니다. 예를 들어 문자열은 "news:http:ftp:telnet:"일 수 있습니다. 스키마 이름 구문은 IETF(인터넷 엔지니어링 태스크 포스) 웹사이트의 URI(Uniform Resource Identifiers): 일반 구문 문서에 정의되어 있습니다. 특히 스키마 이름은 최대 13자(콜론 포함)를 포함할 수 있고, ASCII 알파벳으로 시작해야 하며, ASCII 알파벳, 숫자 및 세 개의 문장 부호 문자인 ".", "+", "-"가 혼합된 것이 뒤에 올 수 있습니다. 문자열 형식은 char* 또는 WCHAR*일 수 있습니다. 서식 있는 편집 컨트롤은 형식을 자동으로 검색합니다.

반환 값

메시지가 성공할 경우 반환 값은 0입니다.

메시지가 실패하면 반환 값은 0이 아닌 값입니다. 예를 들어 메모리 부족, 잘못된 검색 옵션 또는 잘못된 스키마 이름 문자열로 인해 메시지가 실패할 수 있습니다.

lParam에 50개 이상의 스키마 이름이 포함되어 있으면 반환 값이 E_INVALIDARG인 메시지가 실패합니다.

설명

자동 URL 검색이 사용하도록 설정된 경우(즉, wParam에 AURL_ENABLEURL이 포함된 경우) 서식 있는 편집 컨트롤은 수정된 텍스트를 검사하여 텍스트가 URL 형식(또는 일반적으로 Windows 8 이상에서 IRI 국제 리소스 식별자)과 일치하는지 여부를 확인합니다. lParam이 NULL인 경우 컨트롤은 다음 스키마 이름으로 시작하는 URL을 검색합니다.

  • callto
  • 파일
  • ftp
  • gopher
  • http
  • https
  • mailto
  • news
  • 정보
  • nntp
  • onenote
  • outlook
  • prospero
  • tel
  • telnet
  • wais
  • webcal

자동 링크 검색을 사용하도록 설정하면 서식 있는 편집 컨트롤은 컨트롤에서 인식되는 형식이 없는 수정된 텍스트에서 CFE_LINK 효과를 제거합니다. 애플리케이션에서 CFE_LINK 효과를 사용하여 다른 유형의 텍스트를 표시하는 경우 자동 링크 검색을 사용하도록 설정하지 마세요. 서식 있는 편집 컨트롤은 검색된 링크가 있는지 여부를 확인하지 않습니다. 해당 책임은 클라이언트에 속합니다.

서식 있는 편집 컨트롤은 마우스 포인터가 CFE_LINK 효과가 있는 텍스트 위에 있는 동안 다양한 메시지를 수신할 때 EN_LINK 알림을 보냅니다. 자세한 내용은 자동 RichEdit 하이퍼링크 및 RichEdit 식별 이름 하이퍼링크를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱만 해당]
헤더
Richedit.h

추가 정보

CHARFORMAT2

EN_LINK