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

[アーティクル]
03/05/2024

[頻度] または [最近] カテゴリをカスタムジャンプリストに含める必要があることを指定します。

構文

HRESULT AppendKnownCategory(
  [in] KNOWNDESTCATEGORY category
);

パラメーター

[in] category

型: KNOWNDESTCATEGORY

リストに追加する既知のカテゴリを示す次のいずれかの値。

KDC_FREQUENT (1)

0x1。 [頻度] カテゴリを追加します。

KDC_RECENT (2)

0x2。最近使用したカテゴリを追加します。

戻り値

種類: HRESULT

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

プライバシーグループポリシーまたはユーザープライバシー設定が存在する場合は、このメソッドの結果に影響を与える可能性があります。個々の使用状況に基づくユーザー固有のアイテムを含むカテゴリは、これらのプライバシー設定では許可されません。このため、このメソッドを使用して追加された Recent カテゴリまたは Frequent カテゴリにはデータがなく、データのないカテゴリは表示されません。ただし、このような状況では、このメソッドの呼び出しでエラーコードが発生しません。

注釈

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

Recent カテゴリは既定のジャンプリストに表示されますが、カスタムジャンプリストとカスタムカテゴリで表示するには、このメソッドを使用して明示的に要求する必要があります。

AppendCategory と AppendKnownCategory の両方で、複数のカテゴリにアイテムが表示されないようにカスタムジャンプリストを設計する必要があります。 2 つのカテゴリが同じデータに対して単に異なるビューである場合は、ユーザーの利便性に寄与せずにジャンプリストスペースを使用しているため、それらのカテゴリの 1 つを削除する必要があります。重複は、ピン留めされた宛先の場合を除き、システムでは非表示になりません。その場合、その宛先は [ピン留め] カテゴリに表示され、他のすべての場合は非表示になります。

[頻度] カテゴリと [最近] カテゴリには重複度が含まれている可能性があるため、両方のカテゴリを 1 つのジャンプリストに追加しないでください。アプリケーションに最適な 2 つのうちどれが適しているかは、その性質によって異なります。 Microsoft WordやMicrosoft ペイントなどのファイルを生成するアプリケーションでは、ユーザーが最近作業したファイルに戻る可能性が最も高い[最近] カテゴリを使用する必要があります。他の場所で作成されたデータの閲覧や再生に多く使用されるアプリケーションでは 、ユーザー がより多くのアイテムにアクセスする可能性が高く、その多くは 1 回だけであるため、Frequent カテゴリを使用する必要があります。言い換えると、アプリケーションが多数のアイテムにアクセスする可能性が最も高い場合は、ユーザーが何度もアクセスするアイテムのセットが小さくなり、ノイズが発生します。その場合は、[ 頻度] が最適な選択です。アプリケーションがほとんどの場合、より少ない数の新しい項目にアクセスする可能性が高い場合は、[ 最近] を選択する必要があります。

カスタムジャンプリストのカテゴリ (既知の最近または頻繁なカテゴリを含む) は、追加された順序で表示され、リストの下部に最後に追加されたカテゴリが表示されます。

ICustomDestinationList::BeginList の pcMinItems パラメーターによって指される値に対して追加された宛先の数は表示されません。

空のカテゴリは表示されません。

頻繁なカテゴリと最近のカテゴリの内容は、SHAddToRecentDocs を直接使用するアプリケーションごとに計算されます。 Windows エクスプローラーを使用してファイルを開く、共通ファイルダイアログボックスを使用してファイルを開く、保存する、または作成するなど、ユーザー操作の場合、シェルはアプリケーションに代わって SHAddToRecentDocs を呼び出し、それらの呼び出しも使用状況統計で考慮されます。シェルは、ジャンプリストから宛先が起動されたときに、アプリケーションに代わって SHAddToRecentDocs も呼び出します。ただし、シェルが呼び出しを行うと予想される場合でも、アプリケーションで SHAddToRecentDocs 自体を明示的に呼び出すことをお勧めします。これにより、使用状況が記録されることが保証され、最近または頻繁に使用された使用状況を追跡するためのアルゴリズムは、重複する呼び出しに対して修正されます。

要件

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