DataFormats.GetFormat Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Egy DataFormats.Format ad vissza a Windows vágólap numerikus azonosítójával és nevével.

Túlterhelések

Név	Description
GetFormat(Int32)	Egy DataFormats.Format ad vissza a Windows vágólap numerikus azonosítójával és a megadott azonosító nevével.
GetFormat(String)	Egy DataFormats.Format ad vissza a megadott formátumhoz tartozó Windows vágólap numerikus azonosítójával és nevével.

GetFormat(Int32)

Forrás:

DataFormats.cs

Egy DataFormats.Format ad vissza a Windows vágólap numerikus azonosítójával és a megadott azonosító nevével.

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

Public Shared Function GetFormat (id As Integer) As DataFormats.Format

Paraméterek

id

Int32

A formátum azonosítója.

Válaszok

DataFormats.Format

Egy DataFormats.Format, amely a Windows vágólap numerikus azonosítójával és a formátum nevével rendelkezik.

Példák

Az alábbi példakód bemutatja ennek a tagnak a használatát.

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

Megjegyzések

Ezt a tagot általában natív vágólapformátumok regisztrálásához használják.

Ha olyan példányt GetFormat szeretne lekérni, amely tartalmazza az azonosító/formátum névpárt, hívja DataFormats.Format meg azonosítószámmal. Az azonosító nevét és számát általában annak az alkalmazásnak az létrehozója teszi közzé, amellyel a felületet használja Clipboard . A dinamikus adatok Exchange (DDE) beszélgetési adatainak azonosítószáma például Visual Basic &HBF00, a formátum neve pedig vbCFLink.

Hívja meg ezt a metódust bármilyen egyedi azonosítószámmal, hogy hozzáadja az azonosító/formátum névpárt az staticDataFormats osztály formátumnév-/azonosítópárjainak listájához. Az új név a "Formátum" és az azonosító szám összefűzésével jön létre. Ez a pár nem új Clipboard formátumként van regisztrálva, mert nem adott meg nevet.

Lásd még

• DataFormats.Format

GetFormat(String)

Forrás:

DataFormats.cs

Egy DataFormats.Format ad vissza a megadott formátumhoz tartozó Windows vágólap numerikus azonosítójával és nevével.

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

Public Shared Function GetFormat (format As String) As DataFormats.Format

Paraméterek

format

String

A formátum neve.

Válaszok

DataFormats.Format

Egy DataFormats.Format, amely a Windows vágólap numerikus azonosítójával és a formátum nevével rendelkezik.

Kivételek

ArgumentException

.NET 5-ös és újabb verziók: formatnull, Empty vagy szóköz.

Win32Exception

Az új Clipboard formátum regisztrálása nem sikerült.

Példák

Az alábbi példakód bemutatja, hogyan kérhető le egy DataFormats.Format formátumnév/azonosító pár. A UnicodeText rendszer kéri a formátumot, és a beolvasott DataFormats.Format tartalom megjelenik egy szövegdobozban.

Ezt a kódot textBox1 példányosították.

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

Megjegyzések

Ha Windows vágólap numerikus azonosítóra van szüksége egy meglévő formátumhoz, hívja meg a GetFormat formátumnevet.

Új formátumtípus létrehozásához hívja meg ezt a metódust Clipboard a saját formátumnevével. Ha a megadott formátum nem létezik, ez a metódus vágólapformátumként regisztrálja a nevet a Windows beállításjegyzékben, és egyedi formátumazonosítót kap. Ez az új név/azonosító pár hozzáadódik az static osztály formátumnév-/azonosítópárjainak listájához DataFormats .

Lásd még

• DataFormats.Format