Método IVsUIShellOpenDocument.AddStandardPreviewer (String, String, Int32, String, String, String, String, String, UInt32)

Artigo
08/03/2016

Publicado: abril de 2016

Adiciona um navegador da Web à lista de visualizadores disponíveis.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

int AddStandardPreviewer(
    string pszExePath,
    string pszDisplayName,
    int fUseDDE,
    string pszDDEService,
    string pszDDETopicOpenURL,
    string pszDDEItemOpenURL,
    string pszDDETopicActivate,
    string pszDDEItemActivate,
    uint aspAddPreviewerFlags
)

int AddStandardPreviewer(
    String^ pszExePath,
    String^ pszDisplayName,
    int fUseDDE,
    String^ pszDDEService,
    String^ pszDDETopicOpenURL,
    String^ pszDDEItemOpenURL,
    String^ pszDDETopicActivate,
    String^ pszDDEItemActivate,
    unsigned int aspAddPreviewerFlags
)

abstract AddStandardPreviewer : 
        pszExePath:string *
        pszDisplayName:string *
        fUseDDE:int *
        pszDDEService:string *
        pszDDETopicOpenURL:string *
        pszDDEItemOpenURL:string *
        pszDDETopicActivate:string *
        pszDDEItemActivate:string *
        aspAddPreviewerFlags:uint32 -> int

Function AddStandardPreviewer (
    pszExePath As String,
    pszDisplayName As String,
    fUseDDE As Integer,
    pszDDEService As String,
    pszDDETopicOpenURL As String,
    pszDDEItemOpenURL As String,
    pszDDETopicActivate As String,
    pszDDEItemActivate As String,
    aspAddPreviewerFlags As UInteger
) As Integer

Parâmetros

pszExePath
[in] Caminho completo para o arquivo executável que você deseja iniciar para o visualizador.

pszDisplayName
[in] Nome que aparece no Browse With caixa de diálogo.

fUseDDE
[in] Definido como true para usar o intercâmbio dinâmico de dados (DDE).Para obter mais informações, consulte dinâmico respondendo ao intercâmbio dinâmico de dados (DDE)

pszDDEService
[in] Identifica o serviço DDE.

pszDDETopicOpenURL
[in] Identifica o tópico Abrir URL.

pszDDEItemOpenURL
[in] Fornece o caminho para o arquivo que está sendo navegado.

pszDDETopicActivate
[in] Identifica o tópico ativar URL.

pszDDEItemActivate
[in] Identifica o tópico ativar a seqüência de caracteres.

aspAddPreviewerFlags
[in] Define o visualizador para ser um dos padrões do sistema.Para obter mais informações, consulte __VSASPFLAGS.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De vsshell.idl:

HRESULT IVsUIShellOpenDocument::AddStandardPreviewer(
   [in] LPCOLESTR pszExePath,
   [in] LPCOLESTR pszDisplayName,
   [in] BOOL fUseDDE,
   [in] LPCOLESTR pszDDEService,
   [in] LPCOLESTR pszDDETopicOpenURL,
   [in] LPCOLESTR pszDDEItemOpenURL,
   [in] LPCOLESTR pszDDETopicActivate,
   [in] LPCOLESTR pszDDEItemActivate,
   [in] VSASPFLAGS aspAddPreviewerFlags
);

Este método adiciona um navegador da web à lista de visualizadores disponíveis que pode ser iniciada pelo OpenStandardPreviewer.Após a adição de um visualizador, ele é mantido no registro em HKEY_CURRENT_USER.

Um VSPackage que deseja adicionar um visualizador padrão deve colocar uma entrada de registro em HKEY_LOCAL_MACHINE\...\7.0\AddStandardPreviewer {guidPackage} = subchave "Nome do pacote".O nome é apenas o propósito de depuração e não é utilizado.

No momento adequado, analisa o ambiente de chamadas e as entradas do registro ResetDefaults, passing em um valor de PKGRF_ADDSTDPREVIEWER para o grfFlags parâmetro sobre o VSPackage.Nesse ponto o VSPackage deve chamar IVsUIShellOpenDocument::AddStandardPreviewer.

Por exemplo, se o ambiente não forneceu o Internet Explorer como um visualizador padrão, você pode adicionar uma chamada da seguinte maneira:

AddStandardPreviewer(L"c:\\program files\\internet explorer\\iexplore.exe", L"Microsoft Internet Explorer", TRUE, L"IEXPLORE", L"WWW_OpenURL", L"\"%s\",,0xffffffff,3,,,,",
L"WWW_Activate", L"0xffffffff,0", ASP_MakeDefault);

Use ASP_UnsetOldDefaults com cuidado porque é necessário remover a antigos padrões com ASP_MakeDefault, de modo que nunca são os padrões de zero.Além disso, se vários VSPackages usarASP_UnsetOldDefaults | ASP_MakeDefault, o último VSPackage é o padrão.

Consulte também

Interface IVsUIShellOpenDocument
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via