DataFormats.GetFormat Metodo

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

Overload

Nome Descrizione
GetFormat(Int32)

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

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

GetFormat(Int32)

Restituisce un DataFormats.Format con l'ID numerico degli Appunti 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 formato.

Valori restituiti

DataFormats.Format

Oggetto DataFormats.Format con l'ID numerico degli Appunti 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 Clipboard per interfacciarsi. Ad esempio, il numero ID per le informazioni di conversazione DDE (Dynamic Data Exchange) in Visual Basic è &HBF00 e il nome del formato è vbCFLink.

Chiamare questo metodo con qualsiasi numero ID univoco per aggiungere la coppia id/formato nome 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 viene registrata come nuovo Clipboard formato perché non è stato specificato un nome.

Vedi anche

Si applica a

GetFormat(String)

Restituisce un DataFormats.Format con l'ID numerico degli Appunti Windows e il nome 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 del formato.

Valori restituiti

DataFormats.Format

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

Eccezioni

ArgumentException

.NET 5 e versioni successive: format è null, Empty o spazi vuoti.

Win32Exception

Impossibile registrare un nuovo Clipboard formato.

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

Si applica a