System.AppUserModel.RelaunchDisplayNameResource

  • [アーティクル]

ユーザーがタスク バーにアプリケーションをピン留めするか、ボタンのジャンプ リストを使用して新しいインスタンスを起動することを選択したときに、タスク バーに作成されるショートカットに使用される表示名を指定します。 このプロパティの値は、次のいずれかである必要があります。

  • "@%systemdir%\system32\shell32.dll,-19263" などの間接リソース文字列。 間接文字列とプレーンテキスト文字列を区別するには、'@' 文字が必要です (次の箇条書き段落で説明します)。 この間接文字列は、バイナリ ファイルと、そのバイナリに含まれる文字列のリソース ID で構成されます。 この間接文字列形式を使用することを強くお勧めします。これにより、多言語ユーザー インターフェイス (MUI) を使用してシステム言語が変更されたときに、表示名が適切に変更されます。 リソース ID の前の '-' 文字が必要です。
  • リソースを指さないプレーンテキスト文字列。 これは、表示名が MUI をサポートしていないデータ ソースから動的に計算または取得される場合にのみ使用する必要があります。 たとえば、"Microsoft Zune" などのデバイスの名前は、そのデバイスがコンピューターに接続されているときにアプリケーションが表示される場合に使用できます。

Note

System.AppUserModel.RelaunchCommand と System.AppUserModel.RelaunchDisplayNameResource は 常に一緒に設定する必要があります。 これらのプロパティのいずれかが設定されていない場合は、どちらも使用されません。

 

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

Note

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

 

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

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

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

解説

PKEY 値は Propkey.h で定義されています。

アプリケーション ユーザー モデル 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