Função RegisterClipboardFormatA (winuser.h)
Registra um novo formato de área de transferência. Esse formato pode ser usado como um formato de área de transferência válido.
Sintaxe
UINT RegisterClipboardFormatA(
[in] LPCSTR lpszFormat
);
Parâmetros
[in] lpszFormat
Tipo: LPCTSTR
O nome do novo formato.
Valor de retorno
Tipo: UINT
Se a função for bem-sucedida, o valor retornado identificará o formato de área de transferência registrado.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Observações
Se já existir um formato registrado com o nome especificado, um novo formato não será registrado e o valor retornado identificará o formato existente. Isso permite que mais de um aplicativo copie e cole dados usando o mesmo formato de área de transferência registrado. Observe que a comparação de nomes de formato não diferencia maiúsculas de minúsculas.
Os formatos de área de transferência registrados são identificados por valores no intervalo 0xC000 até 0xFFFF.
Quando os formatos de área de transferência registrados são colocados ou recuperados da área de transferência, eles devem estar na forma de um HGLOBAL valor.
Exemplos
Para obter um exemplo, consulte Registrando um formato de área de transferência.
Nota
O cabeçalho winuser.h define RegisterClipboardFormat 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] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winuser.h (inclua Windows.h) |
| biblioteca | User32.lib |
| de DLL |
User32.dll |
| conjunto de API | ext-ms-win-ntuser-misc-l1-2-0 (introduzido no Windows 8.1) |
Consulte também
Conceitual
EnumClipboardFormats
de referência de