EnumClipboardFormats功能可以枚举剪贴板上当前可用的数据格式。
剪贴板数据格式存储在有序列表中。要执行剪贴板数据格式的枚举,您可以对EnumClipboardFormats功能进行一系列调用。对于每个呼叫,【格式】参数指定可用的剪贴板格式,该函数返回下一个可用的剪贴板格式。
UINT EnumClipboard格式(
UINT 【格式】 | //指定已知的可用剪贴板格式 |
); |
参数
【格式】
指定已知可用的剪贴板格式。
要启动剪贴板格式的枚举,请将【格式】设置为零。当【格式】为零时,该函数将检索第一个可用的剪贴板格式。对于枚举期间的后续呼叫,将【格式】设置为上一次EnumClipboardFormat呼叫的结果。
返回值
如果函数成功,则返回值是遵循指定格式的剪贴板格式。换句话说,下一个可用的剪贴板格式。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.如果剪贴板未打开,则该函数失败。
如果没有更多的剪贴板格式枚举,则返回值为零。在这种情况下,GetLastError函数返回值NO_ERROR。这可以区分功能故障和枚举结束。
备注
在列举格式之前,您必须打开剪贴板。使用OpenClipboard功能打开剪贴板。如果剪贴板未打开,则EnumClipboardFormats功能将失败。
EnumClipboardFormats函数按照它们放在剪贴板上的顺序枚举格式。如果要将信息复制到剪贴板,请将剪贴板对象从最具描述性的剪贴板格式顺序添加到最不具描述性的剪贴板格式。如果您从剪贴板粘贴信息,请检索您可以处理的第一个剪贴板格式。这将是您可以处理的最具描述性的剪贴板格式。
操作系统为某些剪贴板格式提供自动类型转换。在这种格式的情况下,此函数枚举指定的格式,然后枚举可以转换的格式。有关剪贴板格式和自动剪贴板格式类型转换的更多信息,请参阅GetClipboardData和SetClipboardData功能。
也可以看看
CountClipboardFormats, GetClipboardData, OpenClipboard, RegisterClipboardFormat, SetClipboardData