DataFormats.GetFormat Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mengembalikan DataFormats.Format dengan ID dan nama numerik Windows Clipboard.

Overload

GetFormat(Int32)	DataFormats.Format Mengembalikan dengan ID numerik Windows Clipboard dan nama untuk ID yang ditentukan.
GetFormat(String)	Mengembalikan DataFormats.Format dengan ID numerik Windows Clipboard dan nama untuk format yang ditentukan.

GetFormat(Int32)

DataFormats.Format Mengembalikan dengan ID numerik Windows Clipboard dan nama untuk ID yang ditentukan.

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

Parameter

id

Int32

ID format.

Mengembalikan

DataFormats.Format

DataFormats.Format yang memiliki ID numerik Windows Clipboard dan nama format.

Contoh

Contoh kode berikut menunjukkan penggunaan anggota ini.

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

Keterangan

Anggota ini biasanya digunakan untuk mendaftarkan format Clipboard asli.

Panggil GetFormat dengan nomor ID saat Anda ingin mengambil DataFormats.Format instans yang berisi pasangan nama ID/format. Biasanya, nama dan nomor ID diterbitkan oleh pembuat aplikasi yang Anda gunakan Clipboard untuk berinteraksi. Misalnya, nomor ID untuk informasi percakapan Dynamic Data Exchange (DDE) di Visual Basic adalah &HBF00, dan nama formatnya adalah vbCFLink.

Panggil metode ini dengan nomor ID unik apa pun untuk menambahkan pasangan nama ID/format ke static daftar pasangan nama/ID format di DataFormats kelas. Nama baru akan dibuat dengan menggabungkan "Format" dan nomor ID. Pasangan ini tidak terdaftar sebagai format baru Clipboard karena Anda belum memberikan nama.

Lihat juga

• DataFormats.Format

GetFormat(String)

Mengembalikan DataFormats.Format dengan ID numerik Windows Clipboard dan nama untuk format yang ditentukan.

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

Parameter

format

String

Nama format.

Mengembalikan

DataFormats.Format

DataFormats.Format yang memiliki ID numerik Windows Clipboard dan nama format.

Pengecualian

ArgumentException

.NET 5 dan versi yang lebih baru: format adalah null, Empty, atau spasi kosong.

Win32Exception

Gagal mendaftarkan format baru Clipboard .

Contoh

Contoh kode berikut menunjukkan cara mengambil pasangan DataFormats.Format nama/ID format yang mewakili. UnicodeText Format diminta, dan konten yang diambil DataFormats.Format ditampilkan dalam kotak teks.

Kode ini memerlukan telah diinstansiasi 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

Keterangan

Panggil GetFormat dengan nama format saat Anda memerlukan ID numerik Windows Clipboard untuk format yang sudah ada.

Panggil metode ini dengan nama format Anda sendiri untuk membuat jenis format baru Clipboard . Jika format yang ditentukan tidak ada, metode ini akan mendaftarkan nama sebagai format Clipboard dengan registri Windows dan mendapatkan pengidentifikasi format unik. Pasangan nama/ID baru ini akan ditambahkan ke static daftar pasangan nama/ID format di DataFormats kelas .

Lihat juga

• DataFormats.Format