IVsAsyncShellOpenDocument.OpenStandardEditorAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
표준 편집기를 사용하여 파일을 엽니다. 먼저 파일의 기본 편집기 팩터리를 이미 구성했는지 여부를 결정합니다. 기본값이 아직 구성되지 않은 경우 우선 순위가 정렬된 편집기 팩터리 목록을 반복하여 문서를 지원하는 첫 번째 편집기 팩터리를 찾습니다. 문서를 열 수 없는 경우 예외가 throw됩니다.
public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenStandardEditorAsync (uint openStandardEditorFlags, string documentMoniker, Guid logicalView, string? ownerCaption, Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy? hierarchy, uint itemId, bool shouldGetDocDataFromRdt, object? docData, Microsoft.VisualStudio.OLE.Interop.IServiceProvider serviceProvider);abstract member OpenStandardEditorAsync : uint32 * string * Guid * string * Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy * uint32 * bool * obj * Microsoft.VisualStudio.OLE.Interop.IServiceProvider -> Microsoft.VisualStudio.Shell.Interop.IVsTaskPublic Function OpenStandardEditorAsync (openStandardEditorFlags As UInteger, documentMoniker As String, logicalView As Guid, ownerCaption As String, hierarchy As IVsUIHierarchy, itemId As UInteger, shouldGetDocDataFromRdt As Boolean, docData As Object, serviceProvider As IServiceProvider) As IVsTask매개 변수
- openStandardEditorFlags
- UInt32
값이 또는 __VSOSEFLAGS2 열거형에서 __VSOSEFLAGS 가져온 플래그입니다.
- documentMoniker
- String
프로젝트 시스템에서 문서의 고유 모니커 식별자(예: 파일의 전체 경로)의 문자열 형식입니다. 파일이 아닌 경우 이 식별자는 종종 URL 형식입니다.
- logicalView
- Guid
Guid 논리 뷰를 식별하는 입니다. 기본 보기는 이며 VSConstants.LOGVIEWID_Primary 모든 편집기는 해당 보기를 지원해야 합니다.
편집기가 문서 뷰 개체에서 를 구현 IVsMultiViewDocumentView 하는 경우 에 전달된 ActivateLogicalView(Guid)값은 편집기 창이 표시될 때 활성화되는 뷰를 결정합니다.
논리 뷰 를 지정하여 보기를 Guid요청하는 이유와 일치하는 특정 보기를 요청할 수 있습니다.
예를 들어 를 지정 VSConstants.LOGVIEWID_Debugging 하여 디버깅에 적합한 뷰를 얻거나 VSConstants.LOGVIEWID_TextView 텍스트 편집기(즉, 를 구현 IVsCodeWindow하는 뷰)에 적합한 보기를 가져옵니다.
- ownerCaption
- String
문서 창에 대한 문서 소유자(즉, 프로젝트)가 정의한 초기 캡션. "ProjectName – ItemName" 형식인 경우가 많습니다.
- hierarchy
- IVsUIHierarchy
문서를 소유하는 에 IVsUIHierarchy 대한 참조입니다.
- itemId
- UInt32
표준 편집기의 UI 계층 구조 항목 식별자입니다. 자세한 내용은 VSConstants.VSITEMID를 참조하세요.
- shouldGetDocDataFromRdt
- Boolean
이면 true환경은 실행 중인 문서 테이블에서 가져온 doc 데이터 개체를 사용합니다. 그렇지 않으면 서비스는 에 전달된 docData문서 데이터를 사용하여 문서를 엽니다.
- docData
- Object
또는 null을 열 항목의 문서 데이터 개체에 대한 참조입니다. 가 인 경우 shouldGetDocDataFromRdt 이 매개 변수에 전달된 이 값은 무시됩니다 true.
- serviceProvider
- IServiceProvider
IServiceProvider에 대한 참조입니다.
반환
열기 작업이 시작되었음을 나타내는 작업입니다.
작업 결과는 환경 내에서 문서를 연 경우 에 대한 참조 IVsAsyncOpenDocumentResult이고, null그렇지 않으면 입니다.
설명
이 메서드에서 반환된 태스크는 문서의 보기와 docdata가 로드되었음을 나타내지 않습니다. 자세한 내용은 DocumentLoadTask를 참조하세요.
이 메서드는 의 결과를 CreateEditorInstance(UInt32, String, String, IVsHierarchy, UInt32, IntPtr, IntPtr, IntPtr, String, Guid, Int32) 사용하여 지원되는 편집기 팩터리를 찾기 위해 목록의 다음 편집기로 계속 반복해야 하는지 여부를 결정합니다. 특히 다음 중 하나를 반환해야 합니다. 1. S_OK 편집기에서 파일을 지원하고 2를 성공적으로 초기화한 경우 반복을 중지해야 함을 나타냅니다. "VS_E_UNSUPPORTEDFORMAT" 편집기가 제공된 문서 데이터 3을 지원하지 않는 경우 반복을 계속해야 함을 나타냅니다. 반복을 중지해야 함을 나타내는 다른 오류 코드입니다.