EM_AUTOURLDETECT メッセージ

  • [アーティクル]

リッチ エディット コントロールによるハイパーリンクの自動検出を有効または無効にします。

パラメーター

wParam

リンクの自動検出を無効にするには 0 を指定し、さまざまな種類の検出を有効にするには次のいずれかの値を指定します。

値 説明
AURL_DISABLEMIXEDLGC
 Windows 8: ラテン語、ギリシャ語、キリル文字の 1 つ以上のスクリプトに属する文字を含むラベルを含むドメイン名の認識を無効にします。
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) Web サイトの 汎用構文ドキュメントである Uniform Resource Identifiers (URI ) で定義されています。 具体的には、スキーム名には最大 13 文字 (コロンを含む) を含めることができます。ASCII 英字で始まる必要があり、その後に ASCII 英字、数字、および 3 つの句読点 ("."、"+"、"-" の 3 つの区切り文字を組み合わせて使用できます。 文字列型には 、char* または WCHAR* のいずれかを指定できます。リッチ エディット コントロールは、型を自動的に検出します。

戻り値

メッセージが成功した場合、戻り値は 0 です。

メッセージが失敗した場合、戻り値は 0 以外の値になります。 たとえば、メモリ不足、無効な検出オプション、または無効なスキーム名文字列が原因でメッセージが失敗する可能性があります。

lParam に 50 を超えるスキーム名が含まれている場合、メッセージは戻り値 E_INVALIDARGで失敗します。

注釈

URL の自動検出が有効になっている場合 (つまり、wParam にAURL_ENABLEURLが含まれている場合)、リッチ エディット コントロールは、変更されたテキストをスキャンして、テキストが URL の形式と一致するかどうかを判断します (一般的には、Windows 8以降では IRI 国際リソース識別子)。 lParam が NULL の場合、コントロールは次のスキーム名で始まる URL を検出します。

  • callto
  • file
  • ftp
  • Gopher
  • http
  • https
  • mailto
  • news
  • notes
  • Nntp
  • onenote
  • Outlook
  • プロスペロー
  • tel
  • telnet
  • wais
  • Webcal

リンクの自動検出が有効になっている場合、リッチ エディット コントロールは、コントロールによって認識される形式を持たない変更されたテキストから CFE_LINK 効果を削除します。 アプリケーションで CFE_LINK 効果を使用して他の種類のテキストをマークする場合は、リンクの自動検出を有効にしないでください。 リッチ エディット コントロールは、検出されたリンクが存在するかどうかをチェックしません。その責任はクライアントに属します。

リッチ エディット コントロールは、マウス ポインターが CFE_LINK 効果を持つテキストの上にある間に、さまざまなメッセージを受信したときに EN_LINK 通知を送信します。 詳細については、「 自動 RichEdit ハイパーリンク 」および「 RichEdit フレンドリ名ハイパーリンク」を参照してください。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
Header
Richedit.h

関連項目

CHARFORMAT2

EN_LINK