Clipboard.ContainsText Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> boolPublic Shared Function ContainsText () As BooleanDevoluciones
true si hay datos de texto en el Portapapeles; de lo contrario, false.
Excepciones
No se ha podido vaciar el Portapapeles. Esto ocurre normalmente cuando otro proceso utiliza el Portapapeles.
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
Se aplica a
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 -> boolPublic Shared Function ContainsText (format As TextDataFormat) As BooleanParámetros
- format
- TextDataFormat
Uno de los valores de TextDataFormat.
Devoluciones
true si hay datos de texto en el Portapapeles con el valor especificado para format; de lo contrario, false.
Excepciones
No se ha podido vaciar el Portapapeles. Esto ocurre normalmente cuando otro proceso utiliza el Portapapeles.
El subproceso actual no está en el modo de contenedor uniproceso (STA). Agregue STAThreadAttribute al método Main de la aplicación.
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.
