DataFormats.GetFormat Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Zwraca element DataFormats.Format z identyfikatorem liczbowym i nazwą Schowka systemu Windows.

Przeciążenia

GetFormat(Int32)	Zwraca element DataFormats.Format z identyfikatorem liczbowym schowka systemu Windows i nazwą dla określonego identyfikatora.
GetFormat(String)	Zwraca element DataFormats.Format z identyfikatorem liczbowym schowka systemu Windows i nazwą dla określonego formatu.

GetFormat(Int32)

Zwraca element DataFormats.Format z identyfikatorem liczbowym schowka systemu Windows i nazwą dla określonego identyfikatora.

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

Parametry

id

Int32

Identyfikator formatu.

Zwraca

DataFormats.Format

Element DataFormats.Format o identyfikatorze liczbowym schowka systemu Windows i nazwie formatu.

Przykłady

W poniższym przykładzie kodu pokazano użycie tego elementu członkowskiego.

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

Uwagi

Ten element członkowski jest zwykle używany do rejestrowania natywnych formatów Schowka.

Wywołaj metodę GetFormat z numerem identyfikacyjnym, jeśli chcesz pobrać DataFormats.Format wystąpienie zawierające parę nazw identyfikatorów/formatu. Zazwyczaj nazwa identyfikatora i numer są publikowane przez twórcę aplikacji, z którą używasz interfejsu Clipboard . Na przykład numer identyfikacyjny informacji konwersacji dynamicznej wymiany danych (DDE) w Visual Basic to &HBF00, a nazwa formatu to vbCFLink.

Wywołaj tę metodę przy użyciu dowolnego unikatowego numeru identyfikatora, aby dodać parę nazw identyfikatorów/formatu do static listy par nazw/identyfikatorów formatu w DataFormats klasie. Nowa nazwa zostanie utworzona przez połączenie ciągu "Format" i numeru identyfikatora. Ta para nie jest zarejestrowana jako nowy Clipboard format, ponieważ nie podano nazwy.

Zobacz też

• DataFormats.Format

GetFormat(String)

Zwraca element DataFormats.Format z identyfikatorem liczbowym schowka systemu Windows i nazwą dla określonego formatu.

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

Parametry

format

String

Nazwa formatu.

Zwraca

DataFormats.Format

Element DataFormats.Format o identyfikatorze liczbowym schowka systemu Windows i nazwie formatu.

Wyjątki

ArgumentException

.NET 5 i nowsze wersje: format to null, Emptylub biały znak.

Win32Exception

Rejestrowanie nowego Clipboard formatu nie powiodło się.

Przykłady

W poniższym przykładzie kodu pokazano, jak pobrać reprezentującą DataFormats.Format parę nazwa/identyfikator formatu. Żądany UnicodeText format, a zawartość pobranego DataFormats.Format pliku jest wyświetlana w polu tekstowym.

Ten kod wymaga textBox1 utworzenia wystąpienia.

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

Uwagi

Wywołaj metodę GetFormat z nazwą formatu, jeśli potrzebujesz identyfikatora liczbowego schowka systemu Windows dla istniejącego formatu.

Wywołaj tę metodę przy użyciu własnej nazwy formatu, aby utworzyć nowy Clipboard typ formatu. Jeśli określony format nie istnieje, ta metoda zarejestruje nazwę jako format Schowka w rejestrze systemu Windows i pobierze unikatowy identyfikator formatu. Ta nowa para nazw/identyfikatorów zostanie dodana do static listy par nazw/identyfikatorów formatu w DataFormats klasie.

Zobacz też

• DataFormats.Format