アプリケーションでリテラルを表示する言語を設定します。

構文

SetLanguage( LanguageObjectName )

適用範囲

オブジェクト: Language

説明

言語を変更できる場合は、SetLanguage 関数が 0 を返します。変更ができない場合は 0 以外の値を返します。指定した言語をロードできない場合は、言語は変更されず、メソッドを実行しなかった場合と同様に、現在の言語が維持されます。SetLanguage 関数が正しく実行されると、その言語設定はセッションの最後までアクティブなままになります。Web アプリケーションでは、これは現在のセッションの現在の言語の値が自動的に保存されることを意味します。
注:

• Web アプリケーションの場合: Web ページのテキストおよび言語に依存するエレメントをすべて更新するには、SetLanguage 関数の呼び出しの後に、Refresh コマンドを追加する必要があります。この Refresh コマンドにより、Web ページの GET が作成されます。SetLanguate 関数の後にこのコマンドを使用しない場合には別の動作が実行されます (SAC #24129 を参照してください)。Web ページの GET を作成すると、編集可能なフィールドに入力された値は失われます。
• モバイルアプリケーションの場合: この機能は、GeneXus X Evolution 3 Upgrade 9 以降で利用できます。言語を変更した後に GoHome メソッドを使用して、既にロードされているパネルを再表示することをお勧めします。そのためには、環境のプロパティ [ Translation type ] を「Run-time」に設定します。
• Ev 2、.NET の場合: SetLanguage(&MyLanguage) は常に機能するわけではありませんが、SetLanguage(!'Spanish') や SetLanguage(!'English) は常に機能します。そのため、下に示すサンプルコードで問題が発生する場合は、変数ではなくリテラルを使用してください。

例

Event &MyLanguage.Click
   If SetLanguage(&MyLanguage)<>0
      ...
   EndIf
EndEvent

Event &MyLanguage.Click
   &NumericVariable = SetLanguage(!"Spanish")
EndEvent

参考情報

GetLanguage 関数