Compartilhar via


COleDataObject::IsDataAvailable

Chame essa função para determinar se um determinado formato está disponível para recuperar dados do item OLE.

BOOL IsDataAvailable(
   CLIPFORMAT cfFormat,
   LPFORMATETC lpFormatEtc = NULL 
);

Parâmetros

  • cfFormat
    O formato de dados da área de transferência a ser usado na estrutura de apontada por lpFormatEtc. Esse parâmetro pode ser um dos formatos predefinidos de área de transferência ou o valor retornado pelo Windows nativo RegisterClipboardFormat função.

  • lpFormatEtc
    Aponta para um FORMATETC estrutura que descreve o formato desejado.Fornecer um valor para este parâmetro somente se você desejar especificar as informações de formato adicionais além o formato da área de transferência especificado por cfFormat. Se for NULO, os valores padrão são usados para outros campos no FORMATETC estrutura.

Valor de retorno

Diferente de zero se houver dados disponível no formato especificado; caso contrário, 0.

Comentários

Essa função é útil antes de chamar GetData, GetFileData, ou GetGlobalData.

Para obter mais informações, consulte IDataObject::QueryGetData and FORMATETC in the Windows SDK.

Para obter mais informações, consulte RegisterClipboardFormat in the Windows SDK.

Exemplo

Consulte o exemplo para CRichEditView::QueryAcceptData.

Requisitos

Cabeçalho: afxole.h

Consulte também

Referência

Classe COleDataObject

Gráfico de hierarquia

COleDataObject::BeginEnumFormats

COleDataObject::GetData

COleDataObject::GetFileData

COleDataObject::GetGlobalData

COleDataObject::GetNextFormat

Outros recursos

COleDataObject membros