Funktionreferenz


_ClipBoard_RegisterFormat

Beschreibung anzeigen in

Registriert ein neues Zwischenablageformat

#include <Clipboard.au3>
_ClipBoard_RegisterFormat ( $sFormat )

Parameter

$sFormat Der Name des neuen Formats

Rückgabewert

Erfolg: Das registrierte Zwischenablageformat
Fehler: 0

Bemerkungen

Sollte ein registriertes Zwischenablageformat bereits existieren, wird nicht das neu registrierte Format, sondern das bereits existierende Format zurückgegeben.
Dies ermöglicht mehreren Programmen lesenden und schreibenden Zugriff auf das registrierte Format.
Es ist zu beachten, dass bei den Formatnamen Groß/Kleinschreibung nicht beachtet wird.

Verwandte Funktionen

_ClipBoard_EnumFormats

Siehe auch

Suche nach RegisterClipboardFormat in der MSDN Bibliothek.

Beispiel

#include <Clipboard.au3>
#include <GUIConstantsEx.au3>
#include <WinAPIError.au3>
#include <WindowsConstants.au3>

Global $g_idMemo

Example()

Func Example()
    Local $iFormat

    ; Erstellt eine GUI
    GUICreate("Zwischenablage", 600, 400)
    $g_idMemo = GUICtrlCreateEdit("", 2, 2, 596, 396, $WS_VSCROLL)
    GUICtrlSetFont($g_idMemo, 9, 400, 0, "Courier New")
    GUISetState(@SW_SHOW)

    ; Registriere ein neues Clipboard-Format
    $iFormat = _ClipBoard_RegisterFormat("AutoIt-Bibliothek Text")
    If $iFormat <> 0 Then

        ; Zeigt das neue Format an
        MemoWrite(_ClipBoard_GetFormatName($iFormat))
    Else
        _WinAPI_ShowError("_ClipBoard_RegisterFormat fehlgeschlagen!")
    EndIf

    ; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Example

; Schreibt eine Nachricht in das Memo
Func MemoWrite($sMessage = "")
    GUICtrlSetData($g_idMemo, $sMessage & @CRLF, 1)
EndFunc   ;==>MemoWrite