次の方法で共有

System.AppUserModel.RelaunchIconResource

  • [アーティクル]

ユーザーがタスク バーにアプリケーションをピン留めするか、ボタンのジャンプ リストを使用して新しいインスタンスを起動することを選択したときに、タスク バーに作成されるショートカットに使用されるアイコンを指定します。 これはタスク バー グループに使用されるアイコンであり、そのアプリケーションが実行されているかどうかに関係なく、ピン留めされたアプリケーションに表示されます。 これは、次のいずれかの形式で指定する必要があります。

  • "%systemdir%\system32\shell32.dll,-128" などの標準リソース形式。 リソース ID の前の '-' 文字が必要です。 パス文字列の先頭に '@' 文字を使用しないでください。
  • "%programfiles%\Microsoft\Notepad\Notepad.ico,0" などのアイコン ファイルへの直接パス。 .icoファイルには複数のアイコン リソースを含めることができるため、文字列にはリソース ID が必要です。 .ico ファイルが 1 つのイメージである場合は、リソース ID として "0" ('-' 文字を除く) を使用します。

System.AppUserModel.RelaunchIconResource は省略可能なプロパティです。 設定されていない場合は、再起動コマンドのターゲット (System.AppUserModel.RelaunchCommand) のアイコンが使用されます。 ただし、望ましくない結果につながる可能性があるため、このプロパティを使用して明示的にアイコンを指定することを強くお勧めします。

このプロパティは、ウィンドウに明示的なアプリケーション ユーザー モデル ID (AppUserModelID) (System.AppUserModel.ID、SHGetPropertyStoreForWindow設定) がある場合にのみ使用されます。 ウィンドウに明示的な AppUserModelID (System.AppUserModel.ID) がない場合、このプロパティは無視され、ウィンドウはグループ化され、所有プロセスの一部であるかのようにピン留めされます。 明示的な AppUserModelID の適用とタスク バーのピン留めへの影響の詳細については、「アプリケーション ユーザー モデル ID (AppUserModelID)を参照してください。 このプロパティは、既定以外の再起動情報を提供するアプリケーションまたはウィンドウで使用されます。 詳細については、「System.AppUserModel.RelaunchCommand を参照してください。

ウィンドウに明示的な AppUserModelID が設定されていても、このプロパティが設定されていない場合、システムは同じ AppUserModelID を持つショートカットを検索し、そのショートカットをタスク バーにピン留めしてウィンドウを表します。 そのようなショートカットが見つからない場合は、それを所有するプロセスのバッキング実行可能ファイルが使用されます。

手記

System.AppUserModel.PreventPinning 設定されている場合、このプロパティは無視されます。 これにより、アプリケーションは明示的な AppUserModelID を割り当てても、それらのウィンドウがピン留めされないようにすることで、ウィンドウのグループ化を制御できます。

 

ウィンドウでこのプロパティを設定するには、SHGetPropertyStoreForWindow を使用してウィンドウのプロパティ ストアを取得し、その取得した IPropertyStore オブジェクトのメソッドを使用して、そのウィンドウの System.AppUserModel.RelaunchIconResource プロパティを設定します。

Windows 10、バージョン 1703、Windows 10、バージョン 1607、Windows 10、バージョン 1511、Windows 10、バージョン 1507、Windows 8.1

propertyDescription
   name = System.AppUserModel.RelaunchIconResource
   shellPKey = PKEY_AppUserModel_RelaunchIconResource
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 3
   SearchInfo
      InInvertedIndex = false
      IsColumn = true
   typeInfo
      type = String
      IsInnate = false

Windows 8、Windows 7

propertyDescription
   name = System.AppUserModel.RelaunchIconResource
   shellPKey = PKEY_AppUserModel_RelaunchIconResource
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 3
   SearchInfo
      InInvertedIndex = false
      IsColumn = false
   typeInfo
      type = String
      IsInnate = false

アプリケーション ユーザー モデル ID (AppUserModelID)

System.AppUserModel.ID

propertyDescriptionList を する

propertyDescription を する

searchInfo の

labelInfo を する

typeInfo を する

displayInfo を する

aliasInfo を する

stringFormat を する

booleanFormat を する

numberFormat を する

dateTimeFormat を する

enumeratedList を する

列挙型 を する

enumRange を する

イメージ

drawControl を する

editControl を する

filterControl を する

queryControl の

relatedPropertyInfo

関連するProperty