IVsAsyncShellOpenDocument.OpenDocumentViaProjectWithSpecificAsync Método

Definição

Namespace:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Pacote:

Microsoft.VisualStudio.Interop v17.9.37000

Localiza um projeto especificado para abrir este documento.

public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenDocumentViaProjectWithSpecificAsync (string documentMoniker, uint specificEditorFlags, Guid editorType, string? physicalView, Guid logicalView);

abstract member OpenDocumentViaProjectWithSpecificAsync : string * uint32 * Guid * string * Guid -> Microsoft.VisualStudio.Shell.Interop.IVsTask

Public Function OpenDocumentViaProjectWithSpecificAsync (documentMoniker As String, specificEditorFlags As UInteger, editorType As Guid, physicalView As String, logicalView As Guid) As IVsTask

Parâmetros

documentMoniker

String

Forma de cadeia de caracteres do identificador de moniker exclusivo do documento no sistema de projeto, por exemplo, o caminho completo para o arquivo. Em casos que não são de arquivo, esse identificador geralmente está na forma de uma URL.

specificEditorFlags

UInt32

Sinalizadores cujos valores são obtidos da enumeração __VSSPECIFICEDITORFLAGS.

editorType

Guid

Identificador exclusivo do tipo de editor.

physicalView

String

Identificador exclusivo da exibição física.

logicalView

Guid

Um Guid que identifica a exibição lógica. O modo de exibição padrão é VSConstants.LOGVIEWID_Primary e cada editor deve dar suporte a essa exibição.

Se o editor implementar IVsMultiViewDocumentView no objeto de exibição de documento, o valor passado para ActivateLogicalView(Guid), que determina qual exibição é ativada quando a janela do editor é mostrada.

Ao especificar o modo de exibição lógico Guid, você pode solicitar a exibição específica que corresponda ao motivo pelo qual você está solicitando a exibição. Por exemplo, especifique VSConstants.LOGVIEWID_DebuggingIVsCodeWindowpara obter a exibição apropriada para depuração ou VSConstants.LOGVIEWID_TextView para obter a exibição apropriada para o editor de texto (ou seja, uma exibição que implementa ).

Retornos

IVsTask

Uma tarefa que representa a operação aberta. O resultado da tarefa é um IVsAsyncOpenDocumentResult objeto .

Comentários

A tarefa retornada por esse método não indica que a exibição e o docdata do documento foram carregados. Consulte DocumentLoadTask para obter mais detalhes.

Esse método é usado por VSPackages que não são projetos que precisam abrir um documento em um editor específico, mas não se importam com qual projeto abre o arquivo. Para chamar esse método do VSPackage, você precisa saber exatamente qual fábrica de editores deseja e exatamente qual janela deseja que a fábrica do editor crie (ou seja, o modo de exibição físico). A exibição lógica especificada no logicalView parâmetro permite que você especifique qual guia deve ser exibida pelo editor se o editor implementar IVsMultiViewDocumentView.

Esse método chama OpenItem(UInt32, Guid, IntPtr, IVsWindowFrame). Se nenhum projeto puder atender ao arquivo e o projeto Arquivos Diversos ainda não estiver presente, o ambiente criará o projeto Arquivos Diversos e tentará novamente.