DataFormats Clase

Definición

Proporciona nombres de formato de Clipboard predefinidos y static.Provides static, predefined Clipboard format names. Pueden utilizarse para identificar el formato de los datos almacenados en un objeto IDataObject.Use them to identify the format of data that you store in an IDataObject.

public ref class DataFormats
public class DataFormats
type DataFormats = class
Public Class DataFormats
Herencia
DataFormats

Ejemplos

En el ejemplo de código siguiente se crea un nuevo formato de datos denominado myFormat.The following code example creates a new data format named myFormat. A continuación, el código crea un MyNewObject que almacena en un DataObject.The code then creates a MyNewObject which it stores in a DataObject. El DataObject se copia en el Clipboard.The DataObject is copied to the Clipboard.

A continuación, el DataObject se recupera del Clipboard y se recupera el MyNewObject.Next, the DataObject is retrieved from the Clipboard and the MyNewObject is recovered. El valor del MyNewObject se imprime en un cuadro de texto.The value of the MyNewObject is printed in a text box. Este código requiere que textBox1 se haya creado y colocado en un formulario.This code requires that textBox1 has been created and placed on a form.

#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 clases IDataObject y DataObject también utilizan la lista de formatos de static para determinar el tipo de datos que se recuperan del Clipboarddel sistema, o que se transfieren en una operación de arrastrar y colocar.The IDataObject and DataObject classes also use the static format list to determine the type of data that is retrieved from the system Clipboard, or that is transferred in a drag-and-drop operation.

El método GetFormat le permite:The GetFormat method allows you to:

  • Obtiene un objeto DataFormats.Format predefinido para un nombre de formato o número de identificador.Get a predefined DataFormats.Format object for a format name or ID number.

  • Agregue un nuevo par de nombre de formato/número de identificador a la lista de static de esta clase y registre el formato con el registro de Windows como formato de Clipboard al pasarle el nombre de formato.Add a new format name/ID number pair to the static list in this class, and to register the format with the Windows registry as a Clipboard format when you pass it the format name.

Puede obtener el Id número o formato Name de la propiedad adecuada en la instancia de DataFormats.Format.You can get the Id number or format Name from the appropriate property in the DataFormats.Format instance.

Campos

Bitmap

Especifica un formato de mapa de bits de Windows.Specifies a Windows bitmap format. Este campo static es de solo lectura.This static field is read-only.

CommaSeparatedValue

Especifica un formato de valores separados por comas (CSV), que es un formato de intercambio común utilizado en hojas de cálculo.Specifies a comma-separated value (CSV) format, which is a common interchange format used by spreadsheets. Este formato no se utiliza directamente en los formularios Windows Forms.This format is not used directly by Windows Forms. Este campo static es de solo lectura.This static field is read-only.

Dib

Especifica el formato de mapa de bits independientes del dispositivo (DIB) de Windows.Specifies the Windows device-independent bitmap (DIB) format. Este campo static es de solo lectura.This static field is read-only.

Dif

Especifica el formato de intercambio de datos de Windows (DIF), que no utilizan directamente los formularios Windows Forms.Specifies the Windows Data Interchange Format (DIF), which Windows Forms does not directly use. Este campo static es de solo lectura.This static field is read-only.

EnhancedMetafile

Especifica el formato de metarchivo mejorado de Windows.Specifies the Windows enhanced metafile format. Este campo static es de solo lectura.This static field is read-only.

FileDrop

Especifica el formato para colocar archivos de Windows, que no utilizan directamente los formularios Windows Forms.Specifies the Windows file drop format, which Windows Forms does not directly use. Este campo static es de solo lectura.This static field is read-only.

Html

Especifica el texto en el formato del portapapeles HTML.Specifies text in the HTML Clipboard format. Este campo static es de solo lectura.This static field is read-only.

Locale

Especifica el formato de referencia cultural de Windows, que no utilizan directamente los formularios Windows Forms.Specifies the Windows culture format, which Windows Forms does not directly use. Este campo static es de solo lectura.This static field is read-only.

MetafilePict

Especifica el formato de metarchivo de Windows, que no utilizan directamente los formularios Windows Forms.Specifies the Windows metafile format, which Windows Forms does not directly use. Este campo static es de solo lectura.This static field is read-only.

OemText

Especifica el formato de texto estándar para Windows del fabricante de equipo original (OEM).Specifies the standard Windows original equipment manufacturer (OEM) text format. Este campo static es de solo lectura.This static field is read-only.

Palette

Especifica el formato de paleta de Windows.Specifies the Windows palette format. Este campo static es de solo lectura.This static field is read-only.

PenData

Especifica el formato de datos del lápiz de Windows, que se compone de trazos de lápiz para software de escritura a mano; los formularios Windows Forms no utilizan este formato.Specifies the Windows pen data format, which consists of pen strokes for handwriting software; Windows Forms does not use this format. Este campo static es de solo lectura.This static field is read-only.

Riff

Especifica el formato de audio Resource Interchange File Format (RIFF), que no utilizan directamente los formularios Windows Forms.Specifies the Resource Interchange File Format (RIFF) audio format, which Windows Forms does not directly use. Este campo static es de solo lectura.This static field is read-only.

Rtf

Especifica texto formado por datos en formato de texto enriquecido (RTF).Specifies text consisting of Rich Text Format (RTF) data. Este campo static es de solo lectura.This static field is read-only.

Serializable

Especifica un formato que encapsula cualquier tipo de objeto de formularios Windows Forms.Specifies a format that encapsulates any type of Windows Forms object. Este campo static es de solo lectura.This static field is read-only.

StringFormat

Especifica el formato de clase de cadena de los formularios Windows Forms que estos utilizan para almacenar objetos de cadena.Specifies the Windows Forms string class format, which Windows Forms uses to store string objects. Este campo static es de solo lectura.This static field is read-only.

SymbolicLink

Especifica el formato de vínculo simbólico de Windows que no utilizan directamente los formularios Windows Forms.Specifies the Windows symbolic link format, which Windows Forms does not directly use. Este campo static es de solo lectura.This static field is read-only.

Text

Especifica el formato de texto ANSI estándar.Specifies the standard ANSI text format. Este campo static es de solo lectura.This static field is read-only.

Tiff

Especifica el formato de imagen TIFF (Tagged Image File Format) que no utilizan directamente los formularios Windows Forms.Specifies the Tagged Image File Format (TIFF), which Windows Forms does not directly use. Este campo static es de solo lectura.This static field is read-only.

UnicodeText

Especifica el formato de texto Unicode estándar de Windows.Specifies the standard Windows Unicode text format. Este campo static es de solo lectura.This static field is read-only.

WaveAudio

Especifica el formato de onda de audio que no utilizan directamente los formularios Windows Forms.Specifies the wave audio format, which Windows Forms does not directly use. Este campo static es de solo lectura.This static field is read-only.

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetFormat(Int32)

Devuelve DataFormats.Format con el identificador numérico del Portapapeles de Windows y el nombre del identificador especificado.Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified ID.

GetFormat(String)

Devuelve DataFormats.Format con el id. numérico del Portapapeles y el nombre del formato especificado.Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified format.

GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también: