IVsProjectAsyncOpen.OpenItemAsync(UInt32, Guid, Boolean, Object) 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.
Abre de forma assíncrona um item no projeto.
public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenItemAsync (uint itemId, Guid logicalView, bool shouldGetDocDataFromRdt, object? docData);
abstract member OpenItemAsync : uint32 * Guid * bool * obj -> Microsoft.VisualStudio.Shell.Interop.IVsTask
Public Function OpenItemAsync (itemId As UInteger, logicalView As Guid, shouldGetDocDataFromRdt As Boolean, docData As Object) As IVsTask
Parâmetros
- itemId
- UInt32
Identificador do item a ser aberto.
Deve ser VSITEMID_ROOT
ou outro identificador de item válido.
Consulte a VSITEMID
enumeração .
- logicalView
- Guid
Identificador exclusivo da exibição lógica.
Caso contrário GUID_NULL
, indica um tipo específico de exibição a ser criado.
Para obter mais informações, veja LOGVIEWID
.
- shouldGetDocDataFromRdt
- Boolean
Se true
, o ambiente usará o objeto de dados do documento obtido da Tabela de Documentos em Execução; caso contrário, o serviço abrirá o documento usando os dados do documento passados para docData
.
- docData
- Object
Uma referência ao objeto de dados do documento do item a ser aberto ou null
. Esse valor passado para esse parâmetro será ignorado se shouldGetDocDataFromRdt
for true
.
Retornos
Uma tarefa que representa a operação aberta. O resultado da tarefa é um IVsAsyncOpenDocumentResult para o item aberto.
Comentários
Ao implementar a IVsProjectSpecificEditorMap2
interface em seu objeto de projeto, você pode fazer o tratamento específico do projeto de arquivos. Ou seja, você pode dar suporte a abrir o arquivo em um editor específico do projeto ou permitir que o editor global abra o item. Abrir um item requer a inicialização de um editor usando OpenStandardEditorAsync(...)
ou OpenSpecificEditorAsync(...)
, dependendo da manipulação que você deseja implementar. Para obter mais informações, consulte GetSpecificEditorProperty
.
OBSERVAÇÃO: na implementação do OpenItemAsync(UInt32, Guid, Boolean, Object), não chame Show()
no quadro de janela retornado.
Comparar com ReopenItemAsync(UInt32, Guid, String, Guid, Boolean, Object)
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.