機能のコールアウト
開始する
ドキュメントは新機能の説明に役立ちますが、製品の使用中にユーザーがその機能に遭遇した場合は、これらの新機能について認識を高めることも重要です。 その結果、機能のコールアウトをプラットフォームの更新プログラム 26 で使用できます。 機能のコールアウトを使用して、ユーザーに新しい機能を示して、オプションで機能の詳細を知るためのハイパーリンクをユーザーに提供することができます。
この記事では、機能のコールアウトの作成に使用される API について詳しく説明します。
"了解" ボタン
機能のコールアウトがトリガーされたら、ユーザは 了解 ボタンをただクリックしてポップアップを閉じることができます。 これにより、この機能コールアウトの状態が個人用設定サブシステムに保存され、特定の機能コールアウトが再度トリガーされるのを防ぎます。
機能のコールアウトのリセット
機能コールアウトの状態が個人用設定に保存されている場合、個人用設定をクリアしても以前に閉じたすべての機能コールアウトの状態は削除されません。 代わりに、すべての機能コールアウトをリセットして再び起動するようにする、別のアクションが追加されました。 これらのアクションは、使用状況データ ページの 個人用設定 タブ、および 個人設定 ページの ユーザーごとに管理 タブにあります。
機能のコールアウトの無効化
管理者は必要に応じて、クライアント パフォーマンス オプション ページで 機能のコールアウトを有効化 オプションを使用して、環境に対して機能のコールアウトを無効にできます。
実装詳細
SystemNotificationsWhatsNewManager クラスには、機能のコールアウトをトリガーするための 2 つのバリアント API が含まれています。
AddWhatsNewWithActionLink()
新しい製品の機能に関連付けられているドキュメントを開くように構成されている [詳細情報] のリンクを含むコントロールに機能のコールアウトを追加します。
パラメーター
| パラメーター | 説明 |
|---|---|
| ruleID | 一意の GUID を生成します。 |
| title | (ローカライズ済みの) タイトルを入力します。 |
| bodyText | (ローカライズ済みの) 説明を入力します。 |
| targetControl | 機能のコールアウトを追加するコントロールの名前を提供します。 |
| urlLink | "詳細" リンクをクリックしたときに、新しいタブで開く URL を指定します。 URL が指定されない場合、"詳細" リンクは表示されません。 |
AddWhatsNew()
機能のコールアウトを [詳細情報] リンクのないコントロールに追加します。
パラメーター
| パラメーター | 説明 |
|---|---|
| ruleID | 一意の GUID を生成します。 |
| title | (ローカライズ済みの) タイトルを入力します。 |
| bodyText | (ローカライズ済みの) 説明を入力します。 |
| targetControl | 機能のコールアウトを追加するコントロールの名前を提供します。 |
例
次のコードスニペットは、TestStringControl というコントロールに関連付けられている機能のコールアウトをトリガーします。
public void init()
{
super();
SystemNotificationsWhatsNewManager::AddWhatsNewWithActionLink(
MyTestKey,
"My title" ,
"My description",
TestStringControl.name(),
"https://www.microsoft.com"
);
}
摘要
- 複数の機能のコールアウトを一度に 1 ページに表示できます。
- 機能のコールアウトは、コントロールごとに 1 つのみ使用できます。 複数のコールアウトが存在する場合は、最後にトリガーされたものが表示されます。