Método ClipboardObject.IDataObject.GetCanonicalFormatEtc
Fornece uma estrutura padrão de FORMATETC que é logicamente equivalente a uma estrutura mais complexa.Use este método para determinar se duas estruturas diferentes de FORMATETC retorna os mesmos dados, eliminando a necessidade para renderização duplicado.
Namespace: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (em Microsoft.VisualStudio.Data.Framework.dll)
Sintaxe
'Declaração
Private Function GetCanonicalFormatEtc ( _
pformatectIn As FORMATETC(), _
pformatetcOut As FORMATETC() _
) As Integer Implements IDataObject.GetCanonicalFormatEtc
int IDataObject.GetCanonicalFormatEtc(
FORMATETC[] pformatectIn,
FORMATETC[] pformatetcOut
)
private:
virtual int GetCanonicalFormatEtc(
array<FORMATETC>^ pformatectIn,
array<FORMATETC>^ pformatetcOut
) sealed = IDataObject::GetCanonicalFormatEtc
private abstract GetCanonicalFormatEtc :
pformatectIn:FORMATETC[] *
pformatetcOut:FORMATETC[] -> int
private override GetCanonicalFormatEtc :
pformatectIn:FORMATETC[] *
pformatetcOut:FORMATETC[] -> int
JScript não oferece suporte a implementações explícitas da interface.
Parâmetros
- pformatectIn
Tipo: array<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
Uma referência a uma estrutura de FORMATETC , passada por referência, que define o formato, o meio, e o dispositivo de destino que o chamador deseja usar para recuperar dados em uma chamada subseqüente, como o IDataObject.GetData.O membro de tymed não é significativo em esse caso e deve ser ignorado.
- pformatetcOut
Tipo: array<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
Quando esse método retornar, contém um ponteiro para a estrutura de FORMATETC que contém as informações mais gerais possível para uma renderização específica, tornando-o canônica o equivalente a pformatectIn.O chamador deve atribuir essa estrutura e o método de GetCanonicalFormatEtc deve preencher os dados.Para recuperar dados em uma chamada subseqüente, como o IDataObject.GetData, o chamador o valor fornecido de pformatetcOut, a menos que o valor fornecido é nulluma referência nula (Nothing no Visual Basic).Esse valor é zero se o método retorna DATA_S_SAMEFORMATETC.O membro de tymed não é significativo em esse caso e deve ser ignorado.Esse parâmetro é passado não inicializado.
Valor de retorno
Tipo: System.Int32
Esse método oferece suporte aos valores de retorno padrão E_INVALIDARG, E_FAIL, E_UNEXPECTED, e E_OUTOFMEMORY, bem como o seguinte:
Valor |
Descrição |
---|---|
S_OK |
A estrutura de FORMATETC retornado é diferente de aquele que foi passada. |
DATA_S_SAMEFORMATETC |
Estruturas de FORMATETC são as mesmas e uma referência nula é retornada no parâmetro de pformatetcOut . |
DV_E_LINDEX |
Há um valor inválido para lindex; atualmente, apenas -1 são suportados. |
DV_E_FORMATETC |
Há um valor válido para o parâmetro de pformatectIn . |
OLE_E_NOTRUNNING |
O aplicativo não está sendo executado. |
Implementações
IDataObject.GetCanonicalFormatEtc(array<FORMATETC[], array<FORMATETC[])
Comentários
Se o objeto da área de transferência envolve IDataObject existente (namespace para Microsoft.VisualStudio.OLE.Interop ), representantes de esse método a chamada para o GetCanonicalFormatEtc correspondente de esse namespace.Caso contrário, tenta converter a chamada para o GetCanonicalFormatEtc de namespace de System.Runtime.InteropServices.ComTypes , no caso do objeto da área de transferência pode envolver 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áveis.