ICustomDestinationList::AddUserTasks メソッド (shobjidl_core.h)

ユーザー設定のジャンプ リストの [タスク] カテゴリに含める項目を指定します。

構文

HRESULT AddUserTasks(
  [in] IObjectArray *poa
);

パラメーター

[in] poa

種類: IObjectArray*

タスクを表す 1 つ以上の IShellLink (または、よりまれに IShellItem) オブジェクトを表す IObjectArray へのポインター。

メモ ここで使用する IShellLink は、 SetArguments を使用して引数リストを宣言する必要があります。 カスタム カテゴリへの引数のない IShellLink オブジェクトの追加はサポートされていません。 ユーザーは、ジャンプ リストからこの種類のアイテムをピン留めまたは固定解除したり、追加または削除したりすることはできません。
 

戻り値

型: HRESULT

成功した場合はS_OK、それ以外の場合はエラー値を返します。

注釈

このメソッドを呼び出す前に 、ICustomDestinationList::BeginList を呼び出す必要があります。

[タスク] カテゴリ ヘッダーは、カテゴリが空でない限り、常に既定で一覧に表示されます。 このヘッダー テキストは変更できません。 ユーザーが選択した言語で表示されます。

[タスク] カテゴリは、ジャンプ リストの最後のカテゴリとして常に表示されますが、リスト内の他のすべてのカテゴリよりも優先されます。 このリストが入力され、残りの領域が他のカテゴリに割り当てられます。 他のカテゴリとは異なり、[ タスク] カテゴリのアイテムは、ユーザーが削除したりピン留めしたりすることはできません。 アプリケーションでは、このカテゴリ内のタスクのユーザーに対する値と、他のカテゴリに必要な領域とのバランスを取る必要があります。

タスクは、アプリケーション全体に適用する必要があります。これらは、個々のウィンドウまたはドキュメントに固有のものではありません。 これらのより詳細なコンテキスト タスクの場合、アプリケーションは サムネイル ツール バーを通じてそれらを提供できます。

メモ タスク リストは静的にすることを強くお勧めします。 タスク リストは、アプリケーションの状態や状態に関係なく同じままにする必要があります。これらのタスクは、アプリケーションが実行されていない場合でも使用できます。 更新時に AddUserTasks を使用してタスク リストを変更することをプログラムで禁止することはありませんが、ジャンプ リストのその部分が変更されるとは思わないユーザーが混乱する可能性があることを考慮する必要があります。 ただし、アプリケーションがタスクの状態 ("サインイン" など) を "サインアウト" に変更する場合は、そのアプリケーションがタスク リストが正しく、最新であることを確認する必要があります。 また、アプリケーションが予期せずシャットダウンした場合、タスク バーはアプリケーションに呼び出さずにタスク リストの最新の既知の適切なバージョンを使用して要求し、古いアイテムが発生する可能性があります。
 

poa が指す IObjectArray を介して提供される IShellLink インスタンスでは、次の情報を提供する必要があります。

表示名は、アイテムの System.Title (PKEY_Title) プロパティを使用して設定する必要があります。 プロパティは、表示名を直接保持することも、"@shell32.dll,-1324" などの間接文字列表現を使用して、格納された文字列を使用することもできます。 間接文字列を使用すると、ユーザーが選択した言語でアイテム名を表示できます。

必要に応じて、説明フィールド (SetDescription) を設定して、ジャンプ リスト内のアイテムのカスタム ヒントを提供できます。

タスク リストには区切り記号を含めることもできます。 これらは、空の IShellLink (引数リスト要件の単一例外) を含め、IShellLink オブジェクトの IPropertyStore インターフェイスを使用して System.AppUserModel.IsDestListSeparator プロパティを TRUE に設定することによって作成されます。 IShellLink 内のその他の値は無視されます。 区切り記号は、リスト内の完全な領域を占有せず、リスト内の項目の数にはカウントされません。 2 つの区切り記号の間に項目がない場合、区切り記号の 1 つが表示されません。 リストの先頭または末尾の区切り記号も無視されます。

要件

要件
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)
Library Shell32.lib
[DLL] Shell32.dll (バージョン 6.1 以降)

こちらもご覧ください

ICustomDestinationList

ICustomDestinationList::AppendCategory

ICustomDestinationList::AppendKnownCategory

タスク バーの拡張機能