36.54 GET_HIGH_CONTRAST_MODE_TOGGLEファンクション

このファンクションでは、現在のページへのリンクを戻すことで、モードのオンまたはオフの切替えを可能にします。たとえば、現在標準モードで表示している場合、このファンクションによってリンクが表示され、クリックするとハイ・コントラスト・モードがオンに切り替わります。

構文

APEX_UTIL.GET_HIGH_CONTRAST_MODE_TOGGLE (
    p_on_message  IN VARCHAR2 DEFAULT NULL,
    p_off_message IN VARCHAR2 DEFAULT NULL)
    RETURN VARCHAR2;

パラメータ

表36-48 GET_HIGH_CONTRAST_MODE_TOGGLEのパラメータ

パラメータ 説明

p_on_message

標準モードの場合に、ハイ・コントラスト・モードに切り替えるリンクに使用するオプションのテキスト。このパラメータが渡されないと、デフォルトの「ハイ・コントラスト・モードをオンに設定」テキストがリンクに戻されます。

p_off_message

ハイ・コントラスト・モードの場合に、標準モードに切り替えるリンクに使用するオプションのテキスト。このパラメータが渡されないと、デフォルトの「ハイ・コントラスト・モードをオフに設定」テキストがリンクに戻されます。

標準モードで実行中の場合、このファンクションは「ハイ・コントラスト・モードをオンに設定」というテキスト付きのリンクを戻します。リンクをクリックすると、現在のページがリフレッシュされ、ハイ・コントラスト・モードがオンになります。ハイ・コントラスト・モードで実行中の場合、「ハイ・コントラスト・モードをオフに設定」というテキスト付きのリンクが戻されます。リンクをクリックすると、現在のページがリフレッシュされ、標準モードに戻ります。

BEGIN
    htp.p(apex_util.get_high_contrast_mode_toggle);
END;

注意:

また、このトグルに戻されるデフォルトのリンク・テキストを変更するための、アプリケーション・レベルでオーバーライドできる翻訳可能なシステム・メッセージが2つあります。これには次のものがあります。

  • APEX.SET_HIGH_CONTRAST_MODE_OFF - デフォルト・テキスト = ハイ・コントラスト・モードをオフに設定

  • APEX.SET_HIGH_CONTRAST_MODE_ON - デフォルト・テキスト = ハイ・コントラスト・モードをオンに設定