[教程]剪贴板类库

剪贴板类库（WinClip）是由Deo积累编写的，主要作用是拓展ahk原有的剪贴板函数，支持rtf、html和图片等格式。本类库的翻译工作将会陆续开展，考虑到大家访问国外网站可能会缓慢，我就直接把官网那边的帮助复制过来了。

类库的下载链接：http://www.apathysoftworks.com/ahk/WinClip.zip

下边是函数列表：

下边是使用的例子：

下边所有的例子都要添加以下两个头文件:

#Include WinClipAPI.ahk ;首先要包含这个，先后顺序有影响
#Include WinClip.ahk

Snap( ByRef data )

clipSize := WinClip.Snap( clipData )

;———- iSnap()
wc := new WinClip
clipSize := wc.iSnap() ;copies clip data into inner buffer for later using

Restore( ByRef data )

clipSize := WinClip.Snap( clipData )
bytesRestored := WinClip.Restore( clipData )

;———- iRestore()
wc := new WinClip
clipSize := wc.iSnap() ;copies clip data into inner buffer for later using
bytesRestored := wc.iRestore() ;restoring data back to clipboard

Clear()

clipSize := WinClip.Snap( clipData )
WinClip.Clear() ;clipboard is empty after this point
bytesRestored := WinClip.Restore( clipData )

;———- iClear()
wc := new WinClip
clipSize := wc.iSnap() ;copies clip data into inner buffer for later using
wc.iClear() ;inner buffer will be emptied after this point
bytesRestored := wc.iRestore() ;nothing will be placed back to clipboard, old data will be kept

GetFormats()

objFormats := WinClip.GetFormats()
list =
for nFmt, params in objFormats
{
; format_number : format_name : data_size : data_size again
; the "buffer" is an object member containing actual format data
  list .= "`n" nFmt " : " params.name " : " params.size " : " params.GetCapacity( "buffer " )
}
msgbox % list

;———- iGetFormats()
wc := new WinClip
clipSize := wc.iSnap() ;copies clip data into inner buffer for later using
objFormats := wc.iGetFormats()
list =
for nFmt, params in objFormats
{
; format_number : format_name : data_size : data_size again
; the “buffer” is an object member containing actual format data
list .= “`n” nFmt ” : ” params.name ” : ” params.size ” : ” params.GetCapacity( “buffer ” )
}
msgbox % list

Save( filePath )

WinClip.Save( "clip.txt" )

;———- iSave( filePath )
wc := new WinClip
clipSize := wc.iSnap() ;copies clip data into inner buffer for later using
wc.iSave( “clip.txt” )

Load( filePath )

WinClip.Load( "clip.txt" )

;———- iLoad( filePath )
wc := new WinClip
wc.iLoad( “clip.txt” ) ;copying data from file into inner buffer
wc.iRestore() ;puts data from inner buffer to clipboard

Copy()

WinClip.Copy()

;———- iCopy()
wc := new WinClip
wc.iCopy() ;copying data to inner buffer without changing actual clipboard data

Paste()

WinClip.Paste()
;if you want just paste some text quickly
WinClip.Paste( "SomeRawText" )

;———- iPaste()
wc := new WinClip
clipSize := wc.iSnap() ;copies clip data into inner buffer for later using
wc.Clear() ;clearing win clipboard
wc.iPaste()
bytesRestored := wc.iRestore()

SetText( textData )

WinClip.SetText( "hey, you!" )

;———- iSetText( textData )
wc := new WinClip
wc.iSetText( “hey, you!” )
wc.iRestore()

AppendText( textData )

WinClip.SetText( "hey, you!" )
WinClip.AppendText( "`nand you!" )

;———- iAppendText( textData )
wc := new WinClip
wc.iSetText( “hey, you!” )
wc.iAppendText( “`nand you!” )
wc.iRestore()

GetFiles()

;copy some files from explorer window first
filesList := WinClip.GetFiles()

;———- iGetFiles()
wc := new WinClip
;copy some files from explorer window first
wc.iSnap()
filesList := wc.iGetFiles()

SetFiles()

WinClip.SetFiles( "C:\file1.txt`nC:\file2.txt" )
;try to paste this faile in any explorer window now
;---------- iSetFiles
wc := new WinClip
wc.iSetFiles( "C:\file1.txt`nC:\file2.txt" )
wc.iRestore()

AppendFiles()

WinClip.SetFiles( "C:\file1.txt`nC:\file2.txt" )
WinClip.AppendFiles( "C:\file3.txt`nC:\file4.txt" )
;all four files should be on clipboard now
;---------- iAppendFiles
wc := new WinClip
wc.iSetFiles( "C:\file1.txt`nC:\file2.txt" )
wc.iAppendFiles( "C:\file3.txt`nC:\file4.txt" )
wc.iRestore()

GetBitmap()

;copy any picture first
hBitmap := WinClip.GetBitmap()
Gui, Add, Picture,% "hwndPicHwnd +" SS_BITMAP := 0xE
SendMessage,% STM_SETIMAGE := 0x0172,% IMAGE_BITMAP := 0,% hBitmap,, ahk_id %PicHwnd%
DllCall("DeleteObject", "Ptr", hBitmap )
Gui, Show, w1000 h700

;——- iGetBitmap()
;copy any picture first
wc := new WinClip
wc.iSnap()
hBitmap := wc.iGetBitmap()
Gui, Add, Picture,% “hwndPicHwnd +” SS_BITMAP := 0xE
SendMessage,% STM_SETIMAGE := 0x0172,% IMAGE_BITMAP := 0,% hBitmap,, ahk_id %PicHwnd%
DllCall(“DeleteObject”, “Ptr”, hBitmap )
Gui, Show, w1000 h700

SetBitmap()

WinClip.SetBitmap( "C:\somepicture.jpg" )
;it should be on clipboard right now

;——— iSetBitmap()
wc := new WinClip
wc.iSetBitmap( “C:\somepicture.jpg” )
wc.iRestore
;it should be on clipboard right now

GetText()

plainText := WinClip.GetText()

;——- iGetText()
wc := new WinClip
wc.iSnap()
plainText := wc.iGetText()

GetHTML()

;copy something from browser first
rawHTML := WinClip.GetHTML()

;—- iGetHTML()
;copy something from browser first
wc := new WinClip
wc.iSnap()
rawHTML := wc.iGetHTML()

官网链接：https://autohotkey.com/board/topic/74670-class-winclip-direct-clipboard-manipulations/