Clipboard.ContainsText Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Indica si en el Portapapeles hay datos de texto.

Sobrecargas

ContainsText()	Indica si en el Portapapeles hay datos con el formato Text o UnicodeText, en función del sistema operativo.
ContainsText(TextDataFormat)	Indica si en el Portapapeles hay datos de texto con el formato que indica el valor de TextDataFormat especificado.

ContainsText()

Indica si en el Portapapeles hay datos con el formato Text o UnicodeText, en función del sistema operativo.

public:
 static bool ContainsText();

public static bool ContainsText ();

static member ContainsText : unit -> bool

Public Shared Function ContainsText () As Boolean

Devoluciones

Boolean

true si hay datos de texto en el Portapapeles; de lo contrario, false.

Excepciones

ExternalException

No se ha podido vaciar el Portapapeles. Esto ocurre normalmente cuando otro proceso utiliza el Portapapeles.

ThreadStateException

El subproceso actual no está en el modo de contenedor uniproceso (STA). Agregue STAThreadAttribute al método Main de la aplicación.

Ejemplos

En el ejemplo siguiente se muestra una sobrecarga del ContainsText método similar a esta sobrecarga.

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

Comentarios

Este método comprueba la presencia de datos en el UnicodeText formato en Windows XP Home Edition, Windows XP Professional, Windows Server 2003 y Windows 2000. De lo contrario, este método comprueba la presencia de datos en el Text formato .

Use este método para determinar si el Portapapeles contiene datos de texto antes de recuperarlos con el GetText método .

Nota

La clase Clipboard solo se puede usar en subprocesos establecidos en modo de subprocesamiento controlado simple (STA). Para usar esta clase, asegúrese de que el método Main está marcado con el atributo STAThreadAttribute.

Consulte también

• TextDataFormat
• Text
• UnicodeText
• GetText
• SetText

ContainsText(TextDataFormat)

Indica si en el Portapapeles hay datos de texto con el formato que indica el valor de TextDataFormat especificado.

public:
 static bool ContainsText(System::Windows::Forms::TextDataFormat format);

public static bool ContainsText (System.Windows.Forms.TextDataFormat format);

static member ContainsText : System.Windows.Forms.TextDataFormat -> bool

Public Shared Function ContainsText (format As TextDataFormat) As Boolean

Parámetros

format

TextDataFormat

Uno de los valores de TextDataFormat.

Devoluciones

Boolean

true si hay datos de texto en el Portapapeles con el valor especificado para format; de lo contrario, false.

Excepciones

ExternalException

No se ha podido vaciar el Portapapeles. Esto ocurre normalmente cuando otro proceso utiliza el Portapapeles.

ThreadStateException

El subproceso actual no está en el modo de contenedor uniproceso (STA). Agregue STAThreadAttribute al método Main de la aplicación.

InvalidEnumArgumentException

format no es un valor TextDataFormat válido.

Ejemplos

En el ejemplo siguiente se muestra este miembro.

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

Comentarios

Use este método para determinar si el Portapapeles contiene datos de texto antes de recuperarlos con el GetText método .

Nota

La clase Clipboard solo se puede usar en subprocesos establecidos en modo de subprocesamiento controlado simple (STA). Para usar esta clase, asegúrese de que el método Main está marcado con el atributo STAThreadAttribute.

Consulte también

• TextDataFormat
• GetText
• SetText