ICustomDestinationList::AddUserTasks メソッド (shobjidl_core.h)
ユーザー設定のジャンプ リストの [タスク] カテゴリに含める項目を指定します。
構文
HRESULT AddUserTasks(
[in] IObjectArray *poa
);
パラメーター
[in] poa
種類: IObjectArray*
タスクを表す 1 つ以上の IShellLink (または、よりまれに IShellItem) オブジェクトを表す IObjectArray へのポインター。
戻り値
型: HRESULT
成功した場合はS_OK、それ以外の場合はエラー値を返します。
注釈
このメソッドを呼び出す前に 、ICustomDestinationList::BeginList を呼び出す必要があります。
[タスク] カテゴリ ヘッダーは、カテゴリが空でない限り、常に既定で一覧に表示されます。 このヘッダー テキストは変更できません。 ユーザーが選択した言語で表示されます。
[タスク] カテゴリは、ジャンプ リストの最後のカテゴリとして常に表示されますが、リスト内の他のすべてのカテゴリよりも優先されます。 このリストが入力され、残りの領域が他のカテゴリに割り当てられます。 他のカテゴリとは異なり、[ タスク] カテゴリのアイテムは、ユーザーが削除したりピン留めしたりすることはできません。 アプリケーションでは、このカテゴリ内のタスクのユーザーに対する値と、他のカテゴリに必要な領域とのバランスを取る必要があります。
タスクは、アプリケーション全体に適用する必要があります。これらは、個々のウィンドウまたはドキュメントに固有のものではありません。 これらのより詳細なコンテキスト タスクの場合、アプリケーションは サムネイル ツール バーを通じてそれらを提供できます。
poa が指す IObjectArray を介して提供される IShellLink インスタンスでは、次の情報を提供する必要があります。
- 項目識別子リスト (PIDL) へのポインター (SetIDList) またはターゲット パス (SetPath または SetRelativePath) のいずれか
- コマンド ライン引数 (SetArguments)
- アイコンの場所 (SetIconLocation)
必要に応じて、説明フィールド (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::AppendCategory