System.AppUserModel.RelaunchIconResource

Określa ikonę używaną dla skrótu utworzonego na pasku zadań, gdy użytkownik zdecyduje się przypiąć aplikację do paska zadań lub uruchomić nowe wystąpienie za pośrednictwem listy skoków przycisku. Jest to ikona używana dla grupy paska zadań i jest wyświetlana dla przypiętej aplikacji niezależnie od tego, czy aplikacja jest uruchomiona, czy nie. Należy to określić w jednym z następujących formatów:

• Standardowy format zasobu, taki jak "%systemdir%\system32\shell32.dll,-128". Znak "-" przed wymaganym identyfikatorem zasobu. Nie używaj znaku "@" z przodu ciągu ścieżki.
• Bezpośrednia ścieżka do pliku ikony, na przykład "%programfiles%\Microsoft\Notepad\Notepad.ico,0". Należy pamiętać, że ponieważ pliki .ico mogą zawierać wiele zasobów ikon, w ciągu wymagany jest identyfikator zasobu. Jeśli plik .ico jest pojedynczym obrazem, użyj znaku "0" (bez znaku "-" jako identyfikatora zasobu.

System.AppUserModel.RelaunchIconResource jest opcjonalną właściwością. Jeśli nie zostanie ustawiona, zostanie użyta ikona elementu docelowego polecenia ponownego uruchamiania (System.AppUserModel.RelaunchCommand). Jednak ponieważ może to prowadzić do niepożądanych wyników, zdecydowanie zachęcamy do jawnego udostępnienia ikony za pośrednictwem tej właściwości.

Ta właściwość jest używana tylko wtedy, gdy okno ma jawny identyfikator modelu użytkownika aplikacji (AppUserModelID) (System.AppUserModel.ID, ustawiany za pomocą SHGetPropertyStoreForWindow). Jeśli okno nie ma jawnego identyfikatora AppUserModelID (System.AppUserModel.ID), ta właściwość jest ignorowana, a okno jest grupowane i przypięte tak, jakby było częścią procesu własnego. Aby uzyskać więcej informacji na temat stosowania jawnych identyfikatorów AppUserModelID i ich wpływu na przypinanie paska zadań, zobacz identyfikatory modelu użytkownika aplikacji (AppUserModelID). Ta właściwość ma być używana przez aplikacje lub okna, które chcą udostępnić informacje inne niż domyślne. Aby uzyskać więcej informacji, zobacz System.AppUserModel.RelaunchCommand.

Jeśli jawny identyfikator AppUserModelID jest ustawiony w oknie, ale ta właściwość nie jest ustawiona, system próbuje znaleźć skrót z tym samym identyfikatorem AppUserModelID i przypina ten skrót do paska zadań, aby reprezentować okno. Jeśli nie można znaleźć takiego skrótu, używany jest plik wykonywalny kopii zapasowej procesu, który jest jego właścicielem.

Aby ustawić tę właściwość w oknie, użyj SHGetPropertyStoreForWindow, aby pobrać magazyn właściwości okna i użyć metod, które pobrano obiektu IPropertyStore, aby ustawić właściwość System.AppUserModel.RelaunchIconResource tego okna.

Windows 10, wersja 1703, Windows 10, wersja 1607, Windows 10, wersja 1511, Windows 10, wersja 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

Tematy pokrewne

identyfikatory modelu użytkownika aplikacji (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

wartość logicznaFormat

numberFormat

dateTimeFormat

wyliczanalista

wyliczenie

enumRange

obrazu

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty