IVsAsyncShellOpenDocument.OpenDocumentViaProjectWithSpecificAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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_Debugging
IVsCodeWindowpara 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
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.