ActivityFlags 열거형

정의

네임스페이스:

Android.Content

어셈블리:

Mono.Android.dll

여러 형식에서 반환되고 여러 형식의 매개 변수로 사용된 값을 열거합니다.

이 열거형은 멤버 값의 비트 조합을 지원합니다.

[System.Flags]
public enum ActivityFlags

[<System.Flags>]
type ActivityFlags = 

상속

Enum

ActivityFlags

특성

FlagsAttribute

필드

속성	값	Description
GrantReadUriPermission	1	이 의도를 설정하면 이 의도의 수신자에게 의도 데이터의 URI 및 해당 ClipData에 지정된 URI에 대한 읽기 작업을 수행할 수 있는 권한이 부여됩니다.
GrantWriteUriPermission	2	이 의도를 설정하면 이 의도의 수신자에게 의도 데이터의 URI 및 해당 ClipData에 지정된 URI에 대한 쓰기 작업을 수행할 수 있는 권한이 부여됩니다.
FromBackground	4	호출자가 이 의도가 직접 사용자 상호 작용이 아닌 백그라운드 작업에서 온다는 것을 나타내도록 설정할 수 있습니다.
DebugLogResolution	8	디버깅을 사용하도록 설정할 수 있는 플래그: 설정하면 이 의도를 확인하는 동안 로그 메시지가 인쇄되어 최종 확인된 목록을 만드는 데 발견된 내용을 표시합니다.
ExcludeStoppedPackages	16	설정된 경우 이 의도는 현재 중지된 패키지의 구성 요소와 일치하지 않습니다.
IncludeStoppedPackages	32	설정된 경우 이 의도는 항상 현재 중지된 패키지의 모든 구성 요소와 일치합니다.
GrantPersistableUriPermission	64	FLAG_GRANT_READ_URI_PERMISSION 및/또는 FLAG_GRANT_WRITE_URI_PERMISSION 함께 사용하면 Context.revokeUriPermission(Uri,int)을 사용하여 명시적으로 해지될 때까지 디바이스 재부팅에서 URI 권한 부여를 유지할 수 있습니다. 이 플래그는 가능한 지속에 대한 권한만 제공합니다. 수신 애플리케이션은 ContentResolver.takePersistableUriPermission(Uri,int)을 호출하여 실제로 유지해야 합니다.
GrantPrefixUriPermission	128	FLAG_GRANT_READ_URI_PERMISSION 및/또는 FLAG_GRANT_WRITE_URI_PERMISSION 결합하면 URI 권한 부여는 원래 부여된 URI와 접두사 일치인 모든 URI에 적용됩니다. (이 플래그가 없으면 액세스 권한을 부여하려면 URI가 정확히 일치해야 합니다.) 다른 URI는 체계, 권한 및 접두사로 정의된 모든 경로 세그먼트가 정확히 일치하는 경우에만 접두사 일치로 간주됩니다.
DirectBootAuto	256	직접 부팅 인식 및 현재 사용자 상태에 따라 의도를 자동으로 일치시킬 때 사용되는 플래그입니다. 기본 동작은 현재 사용자 상태를 자동으로 적용하는 것이므로 현재 상태 또는 부재에 따라 쿼리의 출력을 변경하지 않는 sentinel 값입니다. 대신 이 값은 StrictMode.VmPolicy.Builder.detectImplicitDirectBoot()와 함께 호출자가 원하는 명시적 동작을 확인하는 대신 암시적 자동 일치를 사용하는 경우를 감지하는 데 유용할 수 있습니다. 상수 값: 256(0x00000100)
RequireDefault	512	Context.startActivity()에 전달된 의도에 설정된 경우 이 플래그는 단일 결과로 확인되는 경우에만 의도를 시작합니다. 이러한 결과가 없거나 시스템 선택기가 표시되지 않으면 ActivityNotFoundException이 throw됩니다.
RequireNonBrowser	1024	Context.startActivity()에 전달된 의도에 설정된 경우 이 플래그는 브라우저가 아닌 결과로 확인되는 경우에만 의도를 시작합니다. 이러한 결과가 없으면 ActivityNotFoundException이 throw됩니다.
MatchExternal	2048	Context.startActivity()에 전달된 의도에 설정된 경우 디바이스의 전체 앱이 이미 의도를 처리할 수 없는 경우 이 플래그는 인스턴트 앱을 시작하려고 시도합니다. 외부에서 인스턴트 앱을 확인하려고 하면 다음 의도 속성이 지원됩니다. Intent.setAction(String) Intent.addCategory(String) Intent.setData(Uri) Intent.setType(String) Intent.setPackage(String) Intent.addFlags(int) 인스턴트 앱을 찾을 수 없는 경우 설치 관리자가 시작되어 의도를 확인할 수 없음을 사용자에게 알립니다. 인스턴트 앱을 지원하지 않는 디바이스에서는 플래그가 무시됩니다. 상수 값: 2048(0x00000800)
LaunchAdjacent	4096	이 플래그는 분할 화면 다중 창 모드에만 사용됩니다. 가능하면 새 활동이 시작에 인접하게 표시됩니다. 이는 FLAG_ACTIVITY_NEW_TASK 함께만 사용할 수 있습니다. 또한 기존 활동의 새 인스턴스를 만들려면 FLAG_ACTIVITY_MULTIPLE_TASK 설정해야 합니다.
RetainInRecents	8192	기본적으로 FLAG_ACTIVITY_NEW_DOCUMENT 만든 문서는 사용자가 문서를 닫을 때 최근 작업의 항목이 제거됩니다(뒤로 또는 완료될 수 있음). 문서를 다시 시작할 수 있도록 문서를 최근에 보관하도록 허용하려면 이 플래그를 사용할 수 있습니다. 설정되고 작업의 작업이 완료되면 최상위 애플리케이션에 대한 최근 항목과 같이 사용자가 다시 시작할 수 있도록 최근 항목이 인터페이스에 유지됩니다. 수신 작업은 R.attr.autoRemoveFromRecents를 사용하거나 Activity.finishAndRemoveTask()를 호출하여 이 요청을 재정의할 수 있습니다.
TaskOnHome	16384	Context.startActivity()에 전달된 의도에 설정된 경우 이 플래그로 인해 새로 시작하는 작업이 현재 홈 작업 태스크(있는 경우)의 맨 위에 배치됩니다. 즉, 작업에서 다시 누르면 사용자가 마지막으로 본 활동이 아니더라도 항상 사용자를 집으로 반환합니다. 이는 FLAG_ACTIVITY_NEW_TASK 함께만 사용할 수 있습니다.
ClearTask	32768	Context.startActivity()에 전달된 의도에 설정된 경우 이 플래그는 활동을 시작하기 전에 활동과 연결된 기존 작업을 지웁니다. 즉, 활동이 비어 있는 작업의 새 루트가 되고 모든 이전 작업이 완료됩니다. 이는 FLAG_ACTIVITY_NEW_TASK 함께만 사용할 수 있습니다.
NoAnimation	65536	Context.startActivity()에 전달된 의도에 설정된 경우 이 플래그는 시스템이 작업 전환 애니메이션을 적용하여 다음 작업 상태로 이동하는 것을 방지합니다. 즉, 애니메이션이 실행되지 않는다는 의미는 아닙니다. 여기에서 시작된 활동이 표시되기 전에 이 플래그를 지정하지 않는 다른 활동 변경이 발생하면 해당 전환이 사용됩니다. 일련의 작업 작업을 수행하려는 경우 이 플래그를 잘 사용할 수 있지만 사용자가 본 애니메이션은 첫 번째 활동 변경이 아니라 이후 작업에 의해 구동되어야 합니다.
ReorderToFront	131072	Context.startActivity()에 전달된 의도에서 설정된 경우 이 플래그를 사용하면 이미 실행 중인 경우 시작된 작업이 작업 기록 스택의 맨 앞으로 이동합니다. 예를 들어 A, B, C, D의 네 가지 활동으로 구성된 작업을 고려합니다. D가 활동 B의 구성 요소로 확인되는 의도를 사용하여 startActivity()를 호출하는 경우 B는 기록 스택의 맨 앞으로 가져와서 A, C, D, B 순서로 이동합니다. FLAG_ACTIVITY_CLEAR_TOP 지정한 경우 이 플래그는 무시됩니다.
NoUserAction	262144	이 플래그를 설정하면 새로 시작된 작업이 맨 앞으로 이동될 때 일시 중지되기 전에 현재 최전방 작업에서 정상적인 Activity.onUserLeaveHint() 콜백이 발생하지 않습니다. 일반적으로 활동은 해당 콜백을 사용하여 명시적 사용자 작업으로 인해 해당 활동이 포그라운드 밖으로 이동되었음을 나타낼 수 있습니다. 콜백은 깜박이는 LED와 같이 "사용자가 볼 때까지" 표시하려는 알림을 해제하기 위해 활동의 수명 주기에서 적절한 지점을 표시합니다. 전화 통화 수신 또는 경보 처리기와 같은 비 사용자 기반 이벤트를 통해 활동이 시작된 경우 일시 중지 작업이 사용자가 알림을 승인하지 않았다고 생각하지 않도록 이 플래그를 Context.startActivity에 전달해야 합니다. 상수 값: 262144(0x00040000)
ClearWhenTaskReset	524288	이 상수는 API 수준 21에서 더 이상 사용되지 않습니다. API 21을 기준으로 이 작업은 이 대신 사용해야 하는 FLAG_ACTIVITY_NEW_DOCUMENT 동일하게 수행됩니다.
NewDocument	524288	이 플래그는 이 의도에서 시작된 활동에 루트가 있는 새 작업으로 문서를 여는 데 사용됩니다. 이 플래그 또는 이와 동등한 특성을 사용하면 다른 문서가 포함된 동일한 활동의 여러 인스턴스가 최근 작업 목록에 표시됩니다. R.attr.documentLaunchMode의 활동 특성 형식을 사용하는 것이 여기에 설명된 의도 플래그보다 선호됩니다. 특성 양식을 사용하면 활동에서 활동의 모든 시작 관리자에 대해 여러 문서 동작을 지정할 수 있는 반면, 이 플래그를 사용하려면 활동을 시작하는 각 의도를 지정해야 합니다. 이 플래그 w.r.t.의 기본 의미 체계는 활동이 완료된 후 최근 항목이 유지되는지 여부는 FLAG_ACTIVITY_NEW_TASK 및 R.attr.documentLaunchMode의 사용과 다릅니다. 이 플래그를 사용하여 새 최근 항목 항목을 만드는 경우 활동이 완료되면 기본적으로 해당 항목이 제거됩니다. FLAG_ACTIVITY_RETAIN_IN_RECENTS 사용하여 이 동작을 수정할 수 있습니다. FLAG_ACTIVITY_NEW_DOCUMENT FLAG_ACTIVITY_MULTIPLE_TASK 함께 사용할 수 있습니다. 단독으로 사용하는 경우 R.attr.documentLaunchMode ="intoExisting"을 지정하는 활동 매니페스트와 동일합니다. FLAG_ACTIVITY_MULTIPLE_TASK 사용하는 경우 R.attr.documentLaunchMode ="always"를 지정하는 활동 매니페스트와 동일합니다. 활동 매니페스트가 R.attr.documentLaunchMode ="never"를 지정하는 경우에도 플래그는 FLAG_ACTIVITY_MULTIPLE_TASK 함께 무시됩니다. 자세한 내용은 R.attr.documentLaunchMode를 참조하세요. 참고 항목: R.attr.documentLaunchMode FLAG_ACTIVITY_MULTIPLE_TASK 상수 값: 524288(0x00080000)
LaunchedFromHistory	1048576	이 플래그는 일반적으로 애플리케이션 코드에 의해 설정되지 않지만 이 작업이 기록(longpress 홈 키)에서 시작되는 경우 시스템에서 자동으로 설정됩니다.
ReceiverVisibleToInstantApps	2097152	설정된 경우 브로드캐스트는 Instant Apps의 수신기에 표시됩니다. 기본적으로 Instant Apps는 브로드캐스트를 받지 않습니다. 이 플래그는 인스턴트 앱에서 사용할 때 아무런 영향을 주지 않습니다.
ResetTaskIfNeeded	2097152	설정되고 이 작업이 새 작업에서 시작되거나 기존 작업을 맨 위로 가져오는 경우 작업의 현관문으로 시작됩니다.
BroughtToFront	4194304	이 플래그는 일반적으로 애플리케이션 코드에서 설정되지 않지만 singleTask 모드에 대한 launchMode 설명서에 설명된 대로 시스템에서 설정합니다.
ExcludeFromRecents	8388608	설정된 경우 새 활동은 최근에 시작된 활동 목록에 유지되지 않습니다.
PreviousIsTop	16777216	설정되고 이 의도를 사용하여 기존 활동에서 새 활동을 시작하는 경우 현재 활동은 새 활동을 시작하는 대신 새 의도를 맨 위로 전달할지 여부를 결정하는 상위 활동으로 계산되지 않습니다. 이전 활동은 맨 위로 사용되며, 현재 활동이 즉시 완료될 것이라는 가정이 있습니다.
ForwardResult	33554432	이 의도를 설정하여 기존 활동에서 새 활동을 시작하는 경우 기존 활동의 회신 대상이 새 활동으로 전송됩니다.
ClearTop	67108864	설정되고 시작 중인 작업이 현재 작업에서 이미 실행 중인 경우 해당 활동의 새 인스턴스를 시작하는 대신 해당 작업의 다른 모든 활동이 닫히고 이 의도는 (현재 맨 위에 있는) 이전 작업에 새 의도로 전달됩니다. 예를 들어 작업(A, B, C, D)으로 구성된 작업을 고려해 보세요. D가 활동 B의 구성 요소로 확인되는 의도를 사용하여 startActivity()를 호출하면 C와 D가 완료되고 B가 지정된 의도를 수신하여 스택이 A, B가 됩니다. 위의 예제에서 현재 실행 중인 활동 B 인스턴스는 onNewIntent() 메서드에서 시작하는 새 의도를 받거나 새 의도로 완료되고 다시 시작됩니다. 시작 모드를 "multiple"(기본값)로 선언했으며 동일한 의도에서 FLAG_ACTIVITY_SINGLE_TOP 설정하지 않은 경우 완료되고 다시 만들어집니다. 다른 모든 시작 모드 또는 FLAG_ACTIVITY_SINGLE_TOP 설정된 경우 이 의도는 현재 인스턴스의 onNewIntent()로 전달됩니다. 이 시작 모드는 FLAG_ACTIVITY_NEW_TASK 함께 좋은 효과를 발휘하는 데 사용할 수도 있습니다. 작업의 루트 작업을 시작하는 데 사용되는 경우 현재 실행 중인 작업의 인스턴스를 포그라운드로 가져온 다음 루트 상태로 지웁니다. 예를 들어 알림 관리자에서 활동을 시작할 때 특히 유용합니다. 작업에 대한 자세한 내용은 작업 및 백 스택을 참조하세요. 상수 값: 67108864(0x04000000)
MultipleTask	134217728	고유한 최상위 애플리케이션 시작 관리자를 구현하지 않는 한 이 플래그를 사용하지 마세요.NewTaskalways 기본 시스템에는 그래픽 작업 관리가 포함되지 않으므로 사용자가 시작한 작업으로 돌아갈 수 있는 방법을 제공하지 않는 한 이 플래그를 사용하면 안 됩니다. NewTask 작업에 대한 자세한 내용은 작업 및 백 스택 을 참조하세요.
ReceiverNoAbort	134217728	순서가 지정된 브로드캐스트인 경우 수신기가 브로드캐스트를 중단하도록 허용하지 않습니다. 결과를 이후 수신기로 전파할 수 있지만 이후 수신기가 브로드캐스트를 못하도록 방지할 수는 없습니다.
NewTask	268435456	설정된 경우 이 작업은 이 기록 스택에서 새 작업의 시작이 됩니다. 작업을 시작한 작업부터 다음 작업 작업까지) 사용자가 이동할 수 있는 작업의 원자성 그룹을 정의합니다. 작업은 포그라운드 및 백그라운드로 이동할 수 있습니다. 특정 작업 내의 모든 활동은 항상 동일한 순서로 유지됩니다. 작업에 대한 자세한 내용은 작업 및 백 스택을 참조하세요. 이 플래그는 일반적으로 "시작 관리자" 스타일 동작을 표시하려는 활동에서 사용됩니다. 이 플래그는 사용자에게 수행할 수 있는 별도의 작업 목록을 제공하며, 그렇지 않으면 실행 중인 활동과는 완전히 독립적으로 실행됩니다. 이 플래그를 사용하는 경우 현재 시작 중인 활동에 대해 작업이 이미 실행 중인 경우 새 활동이 시작되지 않습니다. 대신, 현재 작업은 마지막 상태와 함께 화면의 맨 앞으로 이동합니다. 이 동작을 사용하지 않도록 설정하는 플래그는 FLAG_ACTIVITY_MULTIPLE_TASK 참조하세요. 호출자가 실행 중인 작업의 결과를 요청할 때는 이 플래그를 사용할 수 없습니다. 상수 값: 268435456(0x10000000)
ReceiverForeground	268435456	설정된 경우 브로드캐스트를 보낼 때 수신자는 더 짧은 시간 제한 간격으로 포그라운드 우선 순위로 실행할 수 있습니다.
ReceiverReplacePending	536870912	설정된 경우 브로드캐스트를 보낼 때 새 브로드캐스트는 해당 브로드캐스트와 일치하는 기존 보류 중인 브로드캐스트를 대체합니다. 일치는 두 브로드캐스트의 의도에 대해 true를 반환하는 Intent.filterEquals에 의해 정의됩니다. 일치 항목이 발견되면 새 브로드캐스트(및 연결된 수신기)가 보류 중인 브로드캐스트 목록에 있는 기존 브로드캐스트를 대체하고 목록의 동일한 위치에 남습니다. 이 플래그는 가장 일반적으로 고정 브로드캐스트에 사용되며, 수신기에 브로드캐스트의 최신 값을 전달하는 데만 관심이 있습니다.
SingleTop	536870912	설정된 경우 이미 기록 스택의 맨 위에서 실행 중인 경우 활동이 시작되지 않습니다.
NoHistory	1073741824	설정하면 새 작업이 기록 스택에 유지되지 않습니다.
ReceiverRegisteredOnly	1073741824	설정된 경우 브로드캐스트를 보낼 때 등록된 수신기만 호출됩니다. BroadcastReceiver 구성 요소는 시작되지 않습니다.

설명

이 페이지의 일부는 만들고 공유한 작업을 기반으로 하며 에 설명된 조건에 따라 사용됩니다.