DataFormats Clase

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

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í.

Proporciona staticnombres de formato predefinidos Clipboard . Úselos para identificar el formato de los datos que se almacenan en .IDataObject

public ref class DataFormats

public class DataFormats

type DataFormats = class

Public Class DataFormats

Herencia: Object
DataFormats

Ejemplos

En el ejemplo de código siguiente se crea un nuevo formato de datos denominado myFormat. A continuación, el código crea un MyNewObject objeto que almacena en .DataObject DataObject se copia en .Clipboard

A continuación, DataObject se recupera de Clipboard y MyNewObject se recupera . El valor de se imprime en un cuadro de MyNewObject texto. Este código requiere que textBox1 se haya creado y colocado en un formulario.

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;

// Creates a new type.

[Serializable]
public ref class MyNewObject: public Object
{
private:
   String^ myValue;

public:

   // Creates a default constructor for the class.
   MyNewObject()
   {
      myValue = "This is the value of the class";
   }


   property String^ MyObjectValue 
   {

      // Creates a property to retrieve or set the value.
      String^ get()
      {
         return myValue;
      }

      void set( String^ value )
      {
         myValue = value;
      }

   }

};

public ref class MyClass: public Form
{
protected:
   TextBox^ textBox1;

public:
   void MyClipboardMethod()
   {
      
      // Creates a new data format.
      DataFormats::Format^ myFormat = DataFormats::GetFormat( "myFormat" );
      
      /* Creates a new object and stores it in a DataObject using myFormat 
               * as the type of format. */
      MyNewObject^ myObject = gcnew MyNewObject;
      DataObject^ myDataObject = gcnew DataObject( myFormat->Name,myObject );
      
      // Copies myObject into the clipboard.
      Clipboard::SetDataObject( myDataObject );
      
      // Performs some processing steps.
      // Retrieves the data from the clipboard.
      IDataObject^ myRetrievedObject = Clipboard::GetDataObject();
      
      // Converts the IDataObject type to MyNewObject type. 
      MyNewObject^ myDereferencedObject = dynamic_cast<MyNewObject^>(myRetrievedObject->GetData( myFormat->Name ));
      
      // Prints the value of the Object in a textBox.
      textBox1->Text = myDereferencedObject->MyObjectValue;
   }

};

using System;
using System.Windows.Forms;

public class MyClass : Form {
    protected TextBox textBox1;
    
    public void MyClipboardMethod() {
       // Creates a new data format.
       DataFormats.Format myFormat = DataFormats.GetFormat("myFormat");
       
       /* Creates a new object and stores it in a DataObject using myFormat 
        * as the type of format. */
       MyNewObject myObject = new MyNewObject();
       DataObject myDataObject = new DataObject(myFormat.Name, myObject);
 
       // Copies myObject into the clipboard.
       Clipboard.SetDataObject(myDataObject);
 
       // Performs some processing steps.
 
       // Retrieves the data from the clipboard.
       IDataObject myRetrievedObject = Clipboard.GetDataObject();
 
       // Converts the IDataObject type to MyNewObject type. 
       MyNewObject myDereferencedObject = (MyNewObject)myRetrievedObject.GetData(myFormat.Name);
 
       // Prints the value of the Object in a textBox.
       textBox1.Text = myDereferencedObject.MyObjectValue;
    }
 }
 
 // Creates a new type.
 [Serializable]
 public class MyNewObject : Object {
    private string myValue;
 
    // Creates a default constructor for the class.
    public MyNewObject() {
       myValue = "This is the value of the class";
    }
 
    // Creates a property to retrieve or set the value.
    public string MyObjectValue {
       get {
          return myValue;
       }
       set {
          myValue = value;
       }
    }
 }

Option Explicit
Option Strict

Imports System.Windows.Forms

Public Class MyClass1
    Inherits Form
    Private textBox1 As TextBox

    Public Sub MyClipboardMethod()
        ' Creates a new data format.
        Dim myFormat As DataFormats.Format = _
            DataFormats.GetFormat("myFormat")
        
        ' Creates a new object and store it in a DataObject using myFormat 
        ' as the type of format. 
        Dim myObject As New MyNewObject()
        Dim myDataObject As New DataObject(myFormat.Name, myObject)
        
        ' Copies myObject into the clipboard.
        Clipboard.SetDataObject(myDataObject)
        
        ' Performs some processing steps.
        ' Retrieves the data from the clipboard.
        Dim myRetrievedObject As IDataObject = Clipboard.GetDataObject()
        
        ' Converts the IDataObject type to MyNewObject type. 
        Dim myDereferencedObject As MyNewObject = _
            CType(myRetrievedObject.GetData(myFormat.Name), MyNewObject)
        
        ' Print the value of the Object in a textBox.
        textBox1.Text = myDereferencedObject.MyObjectValue
    End Sub
End Class


' Creates a new type.
<Serializable()> Public Class MyNewObject
    Inherits Object
    Private myValue As String
    
    
    ' Creates a default constructor for the class.
    Public Sub New()
        myValue = "This is the value of the class"
    End Sub
    
    ' Creates a property to retrieve or set the value.
    
    Public Property MyObjectValue() As String
        Get
            Return myValue
        End Get
        Set
            myValue = value
        End Set
    End Property
End Class

Comentarios

Las IDataObject clases y DataObject también usan la static lista de formato para determinar el tipo de datos que se recuperan del sistema Clipboardo que se transfieren en una operación de arrastrar y colocar.

El GetFormat método le permite:

Obtenga un objeto predefinido DataFormats.Format para un nombre de formato o un número de identificador.
Agregue un nuevo par nombre/número de identificador de formato a la lista de static de esta clase y para registrar el formato con el registro de Windows como un formato Clipboard al pasarlo el nombre de formato.

Puede obtener el Id número o el formato Name de la propiedad adecuada en la DataFormats.Format instancia.

Campos

Nombre	Description
Bitmap	Especifica un formato de mapa de bits Windows. Este `static` campo es de solo lectura.
CommaSeparatedValue	Especifica un formato de valor separado por comas (CSV), que es un formato de intercambio común que usan las hojas de cálculo. El Windows Forms no usa este formato directamente. Este `static` campo es de solo lectura.
Dib	Especifica el Windows formato de mapa de bits independiente del dispositivo (DIB). Este `static` campo es de solo lectura.
Dif	Especifica el Windows formato de intercambio de datos (DIF), que Windows Forms no usa directamente. Este `static` campo es de solo lectura.
EnhancedMetafile	Especifica el Windows formato de metarchivo mejorado. Este `static` campo es de solo lectura.
FileDrop	Especifica el formato de eliminación de archivos Windows, que Windows Forms no usa directamente. Este `static` campo es de solo lectura.
Html	Especifica texto en el formato del Portapapeles HTML. Este `static` campo es de solo lectura.
Locale	Especifica el formato de referencia cultural Windows, que Windows Forms no usa directamente. Este `static` campo es de solo lectura.
MetafilePict	Especifica el formato de metarchivo Windows, que Windows Forms no usa directamente. Este `static` campo es de solo lectura.
OemText	Especifica el formato de texto estándar Windows fabricante de equipos originales (OEM). Este `static` campo es de solo lectura.
Palette	Especifica el formato de paleta de Windows. Este `static` campo es de solo lectura.
PenData	Especifica el formato de datos de lápiz Windows, que consta de trazos de lápiz para software de escritura a mano; Windows Forms no usa este formato. Este `static` campo es de solo lectura.
Riff	Especifica el formato de audio de formato de archivo de intercambio de recursos (RIFF), que Windows Forms no usa directamente. Este `static` campo es de solo lectura.
Rtf	Especifica el texto que consta de datos de formato de texto enriquecido (RTF). Este `static` campo es de solo lectura.
Serializable	Especifica un formato que encapsula cualquier tipo de objeto Windows Forms. Este `static` campo es de solo lectura.
StringFormat	Especifica el formato de clase de cadena Windows Forms, que Windows Forms usa para almacenar objetos de cadena. Este `static` campo es de solo lectura.
SymbolicLink	Especifica el Windows formato de vínculo simbólico, que Windows Forms no usa directamente. Este `static` campo es de solo lectura.
Text	Especifica el formato de texto ANSI estándar. Este `static` campo es de solo lectura.
Tiff	Especifica el formato de archivo de imagen etiquetada (TIFF), que Windows Forms no usa directamente. Este `static` campo es de solo lectura.
UnicodeText	Especifica el formato de texto Unicode estándar Windows. Este `static` campo es de solo lectura.
WaveAudio	Especifica el formato de audio de onda, que Windows Forms no usa directamente. Este `static` campo es de solo lectura.

Métodos

Nombre	Description
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetFormat(Int32)	Devuelve un DataFormats.Format con el identificador numérico del Portapapeles de Windows y el nombre del identificador especificado.
GetFormat(String)	Devuelve un DataFormats.Format con el identificador numérico del Portapapeles Windows y el nombre del formato especificado.
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Se aplica a

Consulte también

Comentarios

¿Le ha resultado útil esta página?