System.AppUserModel.RelaunchIconResource

사용자가 작업 표시줄에 애플리케이션을 고정하거나 단추의 점프 목록을 통해 새 instance 시작하도록 선택할 때 작업 표시줄에서 만든 바로 가기에 사용되는 아이콘을 지정합니다. 작업 표시줄 그룹에 사용되는 아이콘이며 해당 애플리케이션이 실행 중인지 여부에 관계없이 고정된 애플리케이션에 표시됩니다. 다음 형식 중 하나로 지정해야 합니다.

• 표준 리소스 형식(예: "%systemdir%\system32\shell32.dll,-128") 리소스 ID가 필요하기 전의 '-' 문자입니다. 경로 문자열 앞면에 '@' 문자를 사용하지 마세요.
• 아이콘 파일의 직접 경로(예: "%programfiles%\Microsoft\Notepad\Notepad.ico,0"). .ico 파일에는 여러 아이콘 리소스가 포함될 수 있으므로 문자열에 리소스 ID가 필요합니다. .ico 파일이 단일 이미지인 경우 리소스 ID로 "0"('-' 문자 없음)을 사용합니다.

System.AppUserModel.RelaunchIconResource 는 선택적 속성입니다. 설정되지 않은 경우 다시 시작 명령의 대상 아이콘(System.AppUserModel.RelaunchCommand)이 사용됩니다. 그러나 이로 인해 원치 않는 결과가 발생할 수 있으므로 이 속성을 통해 명시적으로 아이콘을 제공하는 것이 좋습니다.

이 속성은 창에 명시적 애플리케이션 사용자 모델 ID(AppUserModelID)(System.AppUserModel.ID, SHGetPropertyStoreForWindow를 통해 설정됨)가 있는 경우에만 사용됩니다. 창에 명시적 AppUserModelID(System.AppUserModel.ID)가 없는 경우 이 속성은 무시되고 창은 소유 프로세스의 일부인 것처럼 그룹화되고 고정됩니다. 명시적 AppUserModelID의 애플리케이션 및 작업 표시줄 고정에 미치는 영향에 대한 자세한 내용은 애플리케이션 사용자 모델 ID(AppUserModelIDs)를 참조하세요. 이 속성은 기본값이 아닌 다시 시작 정보를 제공하려는 애플리케이션 또는 창에서 사용됩니다. 자세한 내용은 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

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty