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
関連トピック