System.AppUserModel.RelaunchIconResource

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

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

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

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

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

Note

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

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty