Clipboard.ContainsFileDropList Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Indica se há dados na Área de Transferência que estão no formato FileDrop ou que podem ser convertidos nesse formato.

public:
 static bool ContainsFileDropList();

public static bool ContainsFileDropList ();

static member ContainsFileDropList : unit -> bool

Public Shared Function ContainsFileDropList () As Boolean

Retornos

Boolean

true se houver uma lista de destino do arquivo na Área de Transferência; caso contrário, false.

Exceções

ExternalException

Não foi possível limpar a Área de Transferência. Isso geralmente ocorre quando a Área de Transferência está sendo usada por outro processo.

ThreadStateException

O thread atual não está no modo STA (Single-Threaded Apartment). Adicione o STAThreadAttribute ao método Main do aplicativo.

Exemplos

O exemplo a seguir demonstra esse membro.

// Demonstrates SetFileDropList, ContainsFileDroList, and GetFileDropList
public System.Collections.Specialized.StringCollection
    SwapClipboardFileDropList(
    System.Collections.Specialized.StringCollection replacementList)
{
    System.Collections.Specialized.StringCollection returnList = null;
    if (Clipboard.ContainsFileDropList())
    {
        returnList = Clipboard.GetFileDropList();
        Clipboard.SetFileDropList(replacementList);
    }
    return returnList;
}

' Demonstrates SetFileDropList, ContainsFileDroList, and GetFileDropList
Public Function SwapClipboardFileDropList(ByVal replacementList _
    As System.Collections.Specialized.StringCollection) _
    As System.Collections.Specialized.StringCollection

    Dim returnList As System.Collections.Specialized.StringCollection _
        = Nothing

    If Clipboard.ContainsFileDropList() Then

        returnList = Clipboard.GetFileDropList()
        Clipboard.SetFileDropList(replacementList)
    End If

    Return returnList

End Function

Comentários

Uma lista suspensa de arquivos é uma coleção de cadeias de caracteres que contêm informações de caminho para arquivos.

Use esse método para determinar se a Área de Transferência contém uma lista suspensa de arquivos antes de recuperá-la com o GetFileDropList método .

Observação

A Clipboard classe só pode ser usada em threads definidos como modo STA (single thread apartment). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo .

Confira também

• FileDrop
• GetFileDropList()
• SetFileDropList(StringCollection)