トレーニング
モジュール
Dynamics 365 Business Central での多言語開発の管理 - Training
複数の言語を AL 拡張で管理する方法について知りたいですか? その場合、このモジュールでは、翻訳ファイルの作成方法と使用方法について説明します。
このブラウザーはサポートされなくなりました。
Microsoft Edge にアップグレードすると、最新の機能、セキュリティ更新プログラム、およびテクニカル サポートを利用できます。
言語バーへの項目の追加をサポートするには、テキスト サービスで ITfSource インターフェイスと ITfLangBarItem コントロール要素の 1 つをサポートするオブジェクトを実装する必要があります。 項目がインストールされると、言語バーは、IID_ITfLangBarItemSinkを使用して項目の ITfSource::AdviseSink を呼び出すことによって ITfLangBarItemSink シンクをインストールします。 アイテムは 、ITfLangBarItemSink インターフェイスを使用して、アイテムが非表示、表示、有効、または無効になっている場合など、言語バーに変更を通知します。
4 種類の言語バー項目をインストールでき、必要な各インターフェイスが ITfLangBarItem から作成されます。 ITfLangBarItem コントロール要素の例を次に示します。
要素 | 説明 |
---|---|
Button | 言語バー ボタンは、コマンド ボタン、トグル コントロール、または言語バーのメニューとして機能します。 オブジェクトは ITfLangBarItemButton インターフェイスをサポートしている必要があります。 |
バルーン | 言語バーバルーンは、言語バーのポップアップ通知として機能します。 オブジェクトは ITfLangBarItemBalloon インターフェイスをサポートしている必要があります。 |
Bitmap | 言語バービットマップは、ビットマップを表示する言語バーの静的要素として機能します。 オブジェクトは ITfLangBarItemBitmap インターフェイスをサポートしている必要があります。 |
[ビットマップ] ボタン | 言語バーのビットマップ ボタンは、テキストとビットマップを表示する言語バーのボタン要素として機能します。 オブジェクトは、ITfLangBarItemBitmapButton インターフェイスをサポートする必要があります。 |
button 要素は、次のいずれかとして機能します。 ボタン項目の関数は、ITfLangBarItem::GetInfo メソッドのTF_LANGBARITEMINFO構造体の dwStyle メンバーに設定されたフラグによって決まります。
要素 | 説明 |
---|---|
Button | ボタンは標準のコマンド ボタンとして機能します。 このボタン スタイルは、TF_LBI_STYLE_BTN_BUTTON スタイルによって識別されます。 アイテムがクリックされると、ITfLangBarItemButton::OnClick が呼び出されます。 ITfLangBarItemButton::InitMenu および ITfLangBarItemButton::OnMenuSelect は使用されません。 |
トグル ボタン | ボタンは、チェック ボックスと同様に、クリックされた状態を維持できるトグル コントロールとして機能します。 このボタン スタイルは、TF_LBI_STYLE_BTN_TOGGLE スタイルで識別されます。 アイテムがクリックされると、ITfLangBarItemButton::OnClick が呼び出されます。 ITfLangBarItemButton::InitMenu および ITfLangBarItemButton::OnMenuSelect は使用されません。 |
メニュー | ボタンはドロップダウン メニューとして機能します。 このボタン スタイルは、TF_LBI_STYLE_BTN_MENU スタイルで識別されます。 ボタンがクリックされると、ITfLangBarItemButton::InitMenu が呼び出されます。 ユーザーがメニュー内の項目を選択すると、言語バーは、選択したメニュー項目の識別子を使用して ITfLangBarItemButton::OnMenuSelect を呼び出します。 ITfLangBarItemButton::OnClickis は使用されません。 |
ユーザーがメニュー ボタンをクリックすると、言語バーは ITfLangBarItemButton::InitMenu を呼び出します。 項目は、InitMenu に渡される ITfMenu インターフェイスを使用してメニューに項目を追加します。
メニューにサブメニューを追加するには、 ITfMenu::AddMenuItem をTF_LBMENUF_SUBMENUで呼び出します。 これを行うと、サブメニューを表す新しい ITfMenu オブジェクトが AddMenuItem の ppMenu パラメーターで返されます。 この新しいメニュー オブジェクトは、サブメニューに項目を追加するために使用されます。
ユーザーがメニュー内の項目を選択すると、言語バーは、選択したメニュー項目の識別子を使用して ITfLangBarItemButton::OnMenuSelect を呼び出します。
テキスト サービスは、 ITfTextInputProcessor::Activate メソッドが呼び出されたときにその項目を言語バーに追加し、 ITfTextInputProcessor::D eactivate が呼び出されたときにそれらを削除する必要があります。
言語バーに項目を追加するために、テキスト サービスは ITfThreadMgr::QueryInterface を呼び出して ITfLangBarItemMgr インターフェイスを取得IID_ITfLangBarItemMgr。 テキスト サービスは、言語バー項目オブジェクトへのポインターを使用して ITfLangBarItemMgr::AddItem を呼び出します。
テキスト サービスは、非アクティブ化時にアイテムを削除する必要があります。 テキスト サービスは、項目の追加に使用されたのと同じ ITfLangBarItemMgr インターフェイスを使用するか、インターフェイスの別のインスタンスを取得します。 その後、テキスト サービスは、削除する項目のインターフェイス ポインターを使用して ITfLangBarItemMgr::RemoveItem を呼び出します。
TSF は、既存の言語バー メニューにメニュー項目を追加する機能を提供します。 これにより、テキスト サービスは、ツールバーに別のボタンを追加しなくても、別のテキスト サービスのメニューに項目を追加できます。 これにより、メニュー項目を論理グループに編成することもできます。 たとえば、標準の音声テキスト サービスに追加機能を提供するテキスト サービスでは、独自の最上位メニュー ボタンを追加するのではなく、音声テキスト サービス メニューに項目を追加できます。
テキスト サービスは、 ITfSystemLangBarItemSink インターフェイスをサポートするオブジェクトを実装することで、言語バー メニュー拡張機能を提供します。 このインターフェイスは、メニュー ボタンの ITfLangBarItemButton インターフェイスとまったく同じように機能します。 メニューが表示されると、拡張されているテキスト サービスは ITfSystemLangBarItemSink::InitMenu を呼び出します。 拡張機能は、InitMenu に渡される ITfMenu インターフェイスを使用してメニューに項目を追加します。 ユーザーが拡張機能によって追加された項目を選択すると、拡張されるテキスト サービスは、選択したメニュー項目の識別子を使用して ITfSystemLangBarItemSink::OnMenuSelect を呼び出します。
言語バー メニュー拡張機能をインストールするには、テキスト サービスで次の手順を実行します。
ITfSource::UnadviseSinkITfSource::AdviseSink
テキスト サービスを使用すると、上記のように、他のテキスト サービスで言語バー メニューに項目を追加できます。 ITfLangBarItemMgr::GetItem を呼び出してアイテムを取得できるように、GUID を発行する必要があるテキスト サービス。
メニュー拡張機能をサポートするには、テキスト サービスで ITfSource インターフェイスをサポートする必要があります。 次の手順では、1 つ以上のメニュー拡張機能のサポートを有効にします。
トレーニング
モジュール
Dynamics 365 Business Central での多言語開発の管理 - Training
複数の言語を AL 拡張で管理する方法について知りたいですか? その場合、このモジュールでは、翻訳ファイルの作成方法と使用方法について説明します。