AutomationElementMode AutomationElementMode AutomationElementMode AutomationElementMode Enum

정의

UI Automation 요소를 반환할 때 사용할 참조 형식을 지정하는 값을 포함합니다. 이러한 값은 AutomationElementMode 속성에 사용됩니다.These values are used in the AutomationElementMode property.

public enum class AutomationElementMode
public enum AutomationElementMode
type AutomationElementMode = 
Public Enum AutomationElementMode
상속
AutomationElementModeAutomationElementModeAutomationElementModeAutomationElementMode

필드

Full Full Full Full 1

반환된 요소에 내부 UIUI에 대한 전체 참조가 포함되도록 지정합니다.Specifies that returned elements have a full reference to the underlying UIUI.

None None None None 0

반환된 요소에 내부 UIUI에 대한 참조가 아닌 캐시된 정보만 포함되도록 지정합니다.Specifies that returned elements have no reference to the underlying UIUI and contain only cached information. 예를 들어 이 모드를 사용하면 항목 자체에 대한 참조를 가져오지 않고도 목록 상자의 항목 이름을 검색할 수 있습니다.This mode might be used, for example, to retrieve the names of items in a list box without obtaining references to the items themselves.

예제

다음 예제에서는 모드를 설정 하는 방법을 보여 줍니다는 CacheRequest합니다.The following example shows how to set the mode on a CacheRequest.

// Set up the request.
CacheRequest cacheRequest = new CacheRequest();

// Do not get a full reference to the cached objects, only to their cached properties and patterns.
cacheRequest.AutomationElementMode = AutomationElementMode.None;
' Set up the request.
Dim cacheRequest As New CacheRequest()

' Do not get a full reference to the cached objects, only to their cached properties and patterns.
cacheRequest.AutomationElementMode = AutomationElementMode.None

설명

전체 기본값인 및 반환 되는 요소 내부에 대 한 전체 참조를 포함 하도록 지정 UI(사용자 인터페이스)user interface (UI)합니다.Full is the default, and specifies that returned elements contain a full reference to the underlying UI(사용자 인터페이스)user interface (UI). None 지정 반환 되는 요소는 기본 UI 참조가 아닌 캐시 된 정보만 포함 합니다.None specifies that the returned elements have no reference to the underlying UI, and contain only cached information.

요소에서 특정 작업을 같은 GetCurrentPropertyValue 또는 SetFocus, 전체 참조를 필요로;에서이 수행 하는 none이 있는 요소에서 결과 InvalidOperationException입니다.Certain operations on elements, such as GetCurrentPropertyValue or SetFocus, require a full reference; attempting to perform these on an element that has none results in an InvalidOperationException.

None을 사용 하 여 효율적일 수 있는 속성만 필요할 경우 오버 헤드를 방지 하므로 전체 참조를 설정 합니다.Using None can be more efficient when only properties are needed, as it avoids the overhead involved in setting up full references.

적용 대상

추가 정보