DataFormats.GetFormat Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Restituisce un oggetto DataFormats.Format con il nome e l'ID numerico degli Appunti di Windows.

Overload

GetFormat(Int32)	Restituisce un oggetto DataFormats.Format con l'ID numerico degli Appunti di Windows e il nome per l'ID specificato.
GetFormat(String)	Restituisce un oggetto DataFormats.Format con il nome e l'ID numerico degli Appunti di Windows per il formato specificato.

GetFormat(Int32)

Restituisce un oggetto DataFormats.Format con l'ID numerico degli Appunti di Windows e il nome per l'ID specificato.

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

Parametri

id

Int32

ID di formato.

Restituisce

DataFormats.Format

DataFormats.Format con l'ID numerico degli Appunti di Windows e il nome del formato.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo membro.

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

Commenti

Questo membro viene in genere usato per registrare i formati nativi degli Appunti.

Chiamare GetFormat con un numero ID quando si desidera recuperare un'istanza DataFormats.Format che contiene la coppia di nomi ID/formato. In genere, il nome e il numero id vengono pubblicati dall'autore dell'applicazione con cui si sta usando per Clipboard interfacciarsi. Ad esempio, il numero ID per le informazioni di conversazione DDE (Dynamic Data Exchange) in Visual Basic è &HBF00e il nome del formato è vbCFLink.

Chiamare questo metodo con qualsiasi numero ID univoco per aggiungere la coppia nome/formato ID all'elenco static di coppie nome/ID di formato nella DataFormats classe . Il nuovo nome verrà creato concatenando "Format" e il numero ID. Questa coppia non è registrata come nuovo Clipboard formato perché non è stato specificato un nome.

Vedi anche

• DataFormats.Format

GetFormat(String)

Restituisce un oggetto DataFormats.Format con il nome e l'ID numerico degli Appunti di Windows per il formato specificato.

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

Parametri

format

String

Nome di formato.

Restituisce

DataFormats.Format

DataFormats.Format con l'ID numerico degli Appunti di Windows e il nome del formato.

Eccezioni

ArgumentException

.NET 5 e versioni successive: format è null, Emptyo spazio vuoto.

Win32Exception

Registrazione di un nuovo formato Clipboard non riuscita.

Esempio

Nell'esempio di codice seguente viene illustrato come recuperare un oggetto DataFormats.Format che rappresenta una coppia nome/ID di formato. Viene richiesto il UnicodeText formato e il contenuto dell'oggetto recuperato DataFormats.Format viene visualizzato in una casella di testo.

È stata creata un'istanza di questo codice 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

Commenti

Chiamare GetFormat con il nome del formato quando è necessario un ID numerico degli Appunti di Windows per un formato esistente.

Chiamare questo metodo con il proprio nome di formato per creare un nuovo Clipboard tipo di formato. Se il formato specificato non esiste, questo metodo registrerà il nome come formato degli Appunti con il Registro di sistema di Windows e otterrà un identificatore di formato univoco. Questa nuova coppia nome/ID verrà aggiunta all'elenco static di coppie nome/ID di formato nella DataFormats classe .

Vedi anche

• DataFormats.Format