Método ClipboardObject.IDataObject.DAdvise

Artigo
05/17/2015

Criar uma conexão entre o objeto da área de transferência e um coletor consultivo. Este método é chamado por um objeto que suporta um coletor consultivo e permite que o coletor consultivo a ser notificado de alterações nos dados de objeto.

Namespace: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (em Microsoft.VisualStudio.Data.Framework.dll)

Sintaxe

'Declaração
Private Function DAdvise ( _
    ByRef pFormatetc As FORMATETC, _
    advf As ADVF, _
    adviseSink As IAdviseSink, _
    <OutAttribute> ByRef connection As Integer _
) As Integer Implements IDataObject.DAdvise

int IDataObject.DAdvise(
    ref FORMATETC pFormatetc,
    ADVF advf,
    IAdviseSink adviseSink,
    out int connection
)

private:
virtual int DAdvise(
    FORMATETC% pFormatetc, 
    ADVF advf, 
    IAdviseSink^ adviseSink, 
    [OutAttribute] int% connection
) sealed = IDataObject::DAdvise

private abstract DAdvise : 
        pFormatetc:FORMATETC byref * 
        advf:ADVF * 
        adviseSink:IAdviseSink * 
        connection:int byref -> int  
private override DAdvise : 
        pFormatetc:FORMATETC byref * 
        advf:ADVF * 
        adviseSink:IAdviseSink * 
        connection:int byref -> int

JScript não oferece suporte a implementações explícitas da interface.

Parâmetros

pFormatetc
Tipo: FORMATETC%

Uma estrutura de FORMATETC , passada por referência, que define o formato, o dispositivo de destino, a aparência, e o meio que será usado para notificações futuras.

advf
Tipo: ADVF

Um valor de enumeração ADVF que especifica um grupo de sinalizadores para controlar a conexão consultiva.

adviseSink
Tipo: IAdviseSink

Um objeto de IAdviseSink que aponta para o coletor consultivo que receberá notificação de alteração.

connection
Tipo: Int32%

Para fora parâmetro. Quando esse método retorna, este parâmetro contém um símbolo que identifica a conexão. Você pode usar este token posteriormente para excluir a conexão consultiva passando a IDataObject.DUnadvise. Se esse valor é zero, a conexão não foi estabelecida. Este parâmetro é passado não inicializado.

Valor de retorno

Tipo: Int32
Esse método oferece suporte aos valores de retorno padrão E_INVALIDARG, E_UNEXPECTED, e E_OUTOFMEMORY, bem como o seguinte:

Valor	Descrição
S_OK	A conexão consultiva foi criada.
E_NOTIMPL	Este método não é implementado no objeto de dados.
DV_E_LINDEX	Há um valor inválido para lindex; apenas -1 são atualmente suportados.
DV_E_FORMATETC	Há um valor válido para o parâmetro de pFormatetc .
OLE_E_ADVISENOTSUPPORTED	O objeto de dados não oferece suporte a notificação de alteração.

Implementações

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Comentários

Este método delega a chamada para o DAdvise correspondente do System.Runtime.InteropServices.ComTypes , supondo que o objeto da área de transferência está envolvendo IDataObjectexistente.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

ClipboardObject Classe

Namespace Microsoft.VisualStudio.Data.Framework

Partilhar via