DataFormats.GetFormat 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í.
Devuelve un objeto DataFormats.Format con el identificador numérico del Portapapeles de Windows y el nombre.
Sobrecargas
| GetFormat(Int32) |
Devuelve DataFormats.Format con el identificador numérico del Portapapeles de Windows y el nombre del identificador especificado. |
| GetFormat(String) |
Devuelve DataFormats.Format con el id. numérico del Portapapeles y el nombre del formato especificado. |
GetFormat(Int32)
Devuelve DataFormats.Format con el identificador numérico del Portapapeles de Windows y el nombre del identificador especificado.
public:
static System::Windows::Forms::DataFormats::Format ^ GetFormat(int id);public static System.Windows.Forms.DataFormats.Format GetFormat (int id);static member GetFormat : int -> System.Windows.Forms.DataFormats.FormatPublic Shared Function GetFormat (id As Integer) As DataFormats.FormatParámetros
- id
- Int32
Id. de formato.
Devoluciones
DataFormats.Format que contiene el identificador numérico del Portapapeles de Windows y el nombre del formato.
Ejemplos
En el ejemplo de código siguiente se muestra el uso de este miembro.
using namespace System;
using namespace System::Windows::Forms;
int main()
{
// Create a DataFormats::Format for the Unicode data format.
DataFormats::Format^ myFormat = DataFormats::GetFormat( 13 );
// Display the contents of myFormat.
Console::WriteLine( "The Format Name corresponding to the ID {0} is :", myFormat->Id );
Console::WriteLine( myFormat->Name );
}
using System;
using System.Windows.Forms;
public class DataFormat_GetFormat
{
static void Main()
{
// Create a DataFormats.Format for the Unicode data format.
DataFormats.Format myFormat = DataFormats.GetFormat(13);
// Display the contents of myFormat.
Console.WriteLine("The Format Name corresponding to the ID "+myFormat.Id+" is :");
Console.WriteLine(myFormat.Name);
}
}
Imports System.Windows.Forms
Public Class DataFormat_GetFormat
Shared Sub Main()
' Create a DataFormats.Format for the Unicode data format.
Dim myFormat As DataFormats.Format = DataFormats.GetFormat(13)
' Display the contents of myFormat.
Console.WriteLine(("The Format Name corresponding to the ID " + myFormat.Id.ToString + " is :"))
Console.WriteLine(myFormat.Name)
End Sub
End Class
Comentarios
Este miembro se usa normalmente para registrar formatos nativos del Portapapeles.
Llame GetFormat a con un número de identificador cuando desee recuperar una DataFormats.Format instancia que contenga el par de nombres de identificador y formato. Normalmente, el creador de la aplicación con la que se va a usar la Clipboard interfaz para publicar el nombre y el número de identificador. Por ejemplo, el número de identificador de la información de conversación de Intercambio de datos dinámicos (DDE) en Visual Basic es &HBF00y el nombre de formato es vbCFLink.
Llame a este método con cualquier número de identificador único para agregar el par id./nombre de formato a la static lista de pares de nombre/id de formato en la DataFormats clase . El nuevo nombre se creará concatenando "Format" y el número de identificador. Este par no está registrado como un nuevo Clipboard formato porque no ha proporcionado un nombre.
Consulte también
Se aplica a
GetFormat(String)
Devuelve DataFormats.Format con el id. numérico del Portapapeles y el nombre del formato especificado.
public:
static System::Windows::Forms::DataFormats::Format ^ GetFormat(System::String ^ format);public static System.Windows.Forms.DataFormats.Format GetFormat (string format);static member GetFormat : string -> System.Windows.Forms.DataFormats.FormatPublic Shared Function GetFormat (format As String) As DataFormats.FormatParámetros
- format
- String
Nombre de formato.
Devoluciones
DataFormats.Format que contiene el identificador numérico del Portapapeles de Windows y el nombre del formato.
Excepciones
.NET 5 y versiones posteriores: format es null, Emptyo espacio en blanco.
Se ha producido un error al registrar un nuevo formato de Clipboard.
Ejemplos
En el ejemplo de código siguiente se muestra cómo recuperar un DataFormats.Format par de nombre o identificador de formato. Se solicita el UnicodeText formato y el contenido del recuperado DataFormats.Format se muestra en un cuadro de texto.
Se ha creado una instancia de este código textBox1 .
private:
void GetMyFormatInfomation()
{
// Creates a DataFormats.Format for the Unicode data format.
DataFormats::Format^ myFormat = DataFormats::GetFormat(
DataFormats::UnicodeText );
// Displays the contents of myFormat.
textBox1->Text = String::Format( "ID value: {0}\nFormat name: {1}",
myFormat->Id, myFormat->Name );
}
private void GetMyFormatInfomation() {
// Creates a DataFormats.Format for the Unicode data format.
DataFormats.Format myFormat = DataFormats.GetFormat(DataFormats.UnicodeText);
// Displays the contents of myFormat.
textBox1.Text = "ID value: " + myFormat.Id + '\n' +
"Format name: " + myFormat.Name;
}
Private Sub GetMyFormatInfomation()
' Creates a DataFormats.Format for the Unicode data format.
Dim myFormat As DataFormats.Format = _
DataFormats.GetFormat(DataFormats.UnicodeText)
' Displays the contents of myFormat.
textBox1.Text = "ID value: " + myFormat.Id.ToString() + ControlChars.Cr _
+ "Format name: " + myFormat.Name
End Sub
Comentarios
Llame GetFormat con el nombre de formato cuando necesite un identificador numérico del Portapapeles de Windows para un formato existente.
Llame a este método con su propio nombre de formato para crear un nuevo Clipboard tipo de formato. Si el formato especificado no existe, este método registrará el nombre como un formato de Portapapeles con el Registro de Windows y obtendrá un identificador de formato único. Este nuevo par nombre/id se agregará a la static lista de pares de nombre/identificador de formato en la DataFormats clase .
