다음을 통해 공유


action(Toast XML 스키마)

알림에 표시되는 단추를 지정합니다.

요소 계층 구조

<토스트>
<작업>
<입력>

Syntax

<action content = string
    arguments = string
    activationType? = "foreground" | "background" | "protocol"
    afterActivationBehavior? = "default" | "pendingUpdate"
    placement? = "contextMenu"
    imageUri? = string
    hint-inputid = string
    hint-buttonStyle = "Success" | "Critical"
    hint-toolTip = string
/>

? 선택 사항(0개 또는 1개)

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
콘텐츠 단추에 표시되는 콘텐츠입니다. 문자열 없음
인수 사용자가 이 단추를 클릭할 경우 나중에 앱에서 받을 앱에서 정의한 인수 문자열입니다. 문자열 없음
형식 사용자 작업에 대한 응답으로 실행해야 하는 작업에 대한 세부 정보를 제공하기 위해 연결된 앱에 전달할 수 있는 인수 문자열입니다. 문자열 없음
activationType 사용자가 특정 작업과 상호 작용할 때 사용할 활성화 유형을 결정합니다.
  • "포그라운드" - 기본값입니다. 포그라운드 앱이 시작됩니다.
  • "background" - 해당 백그라운드 작업이 트리거되고 사용자를 중단하지 않고 백그라운드에서 코드를 실행할 수 있습니다.
  • "프로토콜" - 프로토콜 활성화를 사용하여 다른 앱을 시작합니다.
문자열 No "전경"
afterActivationBehavior 알림에서 사용자가 작업을 수행할 때 알림이 사용해야 하는 동작을 지정합니다.
  • "default" - 기본값입니다. 알림은 사용자가 알림에 대해 조치를 취하면 해제됩니다.
  • "pendingUpdate" - 사용자가 알림에서 단추를 클릭하면 알림이 "보류 중인 업데이트" 시각적 상태로 유지됩니다. 백그라운드 작업에서 알림을 즉시 업데이트하여 사용자가 이 "업데이트 보류 중"시각적 상태를 너무 오랫동안 보지 않도록 해야 합니다.
문자열 No "default"
배치 "contextMenu"로 설정하면 작업은 기존 알림 단추가 아닌 알림 메시지의 상황에 맞는 메뉴에 추가된 상황에 맞는 메뉴 작업이 됩니다. 문자열 None
imageUri 알림 단추 아이콘에 대한 이미지 원본의 URI입니다. 이러한 아이콘은 100% 크기 조정에서 흰색 투명 16x16 픽셀 이미지이며 이미지 자체에 안쪽 여백이 포함되어 있지 않아야 합니다. 알림 메시지에서 아이콘을 제공할 경우 단추 스타일을 아이콘 버튼으로 변형하기 때문에 알림에서 단추 전체에 아이콘을 제공해야 합니다. 다음 프로토콜 처리기 중 하나를 사용합니다.
  • http:// 또는 https:// - 웹 기반 이미지입니다.
  • ms-appx:/// - 앱 패키지에 포함된 이미지입니다.
  • ms-appdata:///local/ - 로컬 스토리지에 저장된 이미지입니다.
  • file:/// - 로컬 이미지입니다. (데스크톱 앱에 대해서만 지원됩니다. 이 프로토콜은 UWP 앱에서 사용할 수 없습니다.)
문자열 None
hint-inputId 입력 옆에 있는 위치 단추를 입력 의 ID로 설정합니다. 문자열 None
hint-buttonStyle 단추 스타일입니다. useButtonStyletoast 요소에서 true로 설정해야 합니다.
  • "성공" - 단추가 녹색입니다.
  • "위험" - 단추가 빨간색입니다.
이러한 값은 대/소문자를 구분합니다.
문자열 None
hint-toolTip 단추에 빈 콘텐츠 문자열이 있는 경우 단추의 도구 설명입니다. 문자열 None

자식 요소

None

부모 요소

부모 요소 Description
actions 알림 메시지에 대해 최대 5개의 입력 및 최대 5개의 단추 동작을 선언하는 컨테이너 요소입니다.

추가 정보