Estrutura OLEUIPASTEENTRYA (oledlg.h)

Uma matriz de entradas a ser especificada na estrutura 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, vinculando somente ou colando e vinculando. 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 apropriados OLEUIPASTE_LINKTYPEn .

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ído 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. Somente um %s é permitido. A presença ou ausência de %s especifica se o resultado-texto 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 indicará 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ído pelo nome do aplicativo ou FullUserTypeName do objeto na área de transferência. Somente um %s é permitido.

dwFlags

Valores da enumeração OLEUIPASTEFLAG .

dwScratchSpace

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

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

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

Confira também

OLEUIPASTEFLAG

OLEUIPASTESPECIAL

Oleuipastespecial