Estrutura OLEUIPASTEENTRYA (oledlg.h)

Artigo
11/20/2024

Uma matriz de entradas a ser especificada na estrutura de OLEUIPASTESPECIAL para a caixa de diálogo Colar Especial. Cada entrada inclui uma estrutura FORMATETC que especifica os formatos aceitáveis, uma cadeia de caracteres que representa o formato na caixa de listagem da caixa de diálogo, uma cadeia de caracteres para personalizar o texto do resultado da caixa de diálogo e um conjunto de sinalizadores da enumeração OLEUIPASTEFLAG. Os sinalizadores indicam se a entrada é válida apenas para colar, vincular somente ou colar e vincular. Se a entrada for válida para vinculação, os sinalizadores indicarão quais tipos de link são aceitáveis por OR'ing juntos os valores OLEUIPASTE_LINKTYPEn apropriados.

Sintaxe

typedef struct tagOLEUIPASTEENTRYA {
  FORMATETC fmtetc;
  LPCSTR    lpstrFormatName;
  LPCSTR    lpstrResultText;
  DWORD     dwFlags;
  DWORD     dwScratchSpace;
} OLEUIPASTEENTRYA, *POLEUIPASTEENTRYA, *LPOLEUIPASTEENTRYA;

Membros

fmtetc

Formato aceitável. A caixa de diálogo Colar Especial verifica se esse formato é oferecido pelo objeto na área de transferência e, em caso afirmativo, oferece-o para seleção para o usuário.

lpstrFormatName

Ponteiro para a cadeia de caracteres que representa o formato para o usuário. Qualquer %s nessa cadeia de caracteres é substituída pelo FullUserTypeName do objeto na área de transferência e a cadeia de caracteres resultante é colocada na caixa de listagem da caixa de diálogo. Apenas um %s é permitido. A presença ou ausência de %s especifica se o texto de resultado deve indicar que os dados estão sendo colados ou se um objeto que pode ser ativado por um aplicativo está sendo colado. Se %s estiver presente, o texto resultante diz que um objeto está sendo colado. Caso contrário, ele diz que os dados estão sendo colados.

lpstrResultText

Ponteiro para a cadeia de caracteres usada para personalizar o texto resultante da caixa de diálogo quando o usuário seleciona o formato correspondente a essa entrada. Qualquer %s nessa cadeia de caracteres é substituída pelo nome do aplicativo ou FullUserTypeName do objeto na área de transferência. Apenas um %s é permitido.

dwFlags

Valores de enumeração OLEUIPASTEFLAG.

dwScratchSpace

Espaço de arranhão disponível para rotinas que percorrem um IEnumFORMATETC para marcar se o formato PasteEntry está disponível. Esse campo pode ser deixado não inicializado.

Observações

Nota

O cabeçalho oledlg.h define OLEUIPASTEENTRY como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	oledlg.h

Consulte também

OLEUIPASTEFLAG

OLEUIPASTESPECIAL

OleUIPasteSpecial

Compartilhar via