com : Class (dans SurrogateServer/Class)com:Class (in SurrogateServer/Class)

  • 2 minutes de lecture

DescriptionDescription

Définit une inscription de classe SurrogateServer.Defines a SurrogateServer class registration.

Hiérarchie d’élémentsElement Hierarchy

<Packages>
<Package>
<Applications>
<Applications>
<Oeuvre>
<Application>
<Extensions>
<Extensions>
<com : extension>
<com:Extension>
<com : COMServer>
<com:ComServer>
<com : SurrogateServer>
<com:SurrogateServer>
<com:Class><com:Class>

SyntaxeSyntax

<com:Class
    Id = A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
    Path = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.
    ThreadingModel = String value, valid choices are: Both, STA, MTA, MainSTA, Neutral.
    DisplayName? = A string between 1 and 256 characters in length. This string is localizable.
    EnableOleDefaultHandler? = Boolean.
    ProgId? = An alphanumeric string separated by a period between 1 and 255 characters in length, e.g. Foo.Bar or Foo.Bar.1
    VersionIndependentProgId? = An alphanumeric string separated by a period between 1 and 255 characters in length, e.g. Foo.Bar or Foo.Bar.1
    AutoConvertTo? = A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
    InsertableObject? = Boolean.
    ShortDisplayName? = A string between 1 and 40 characters in length. >

  <!-- Child elements -->
  ( ImplementedCategories,
  Conversion?,
  DataFormats?,
  MiscStatus?,
  Verbs?,
  DefaultIcon?,
  ToolboxBitmap32? 
  )
</com:Class>

CléKey

?   facultatif (zéro ou un)?   optional (zero or one)

AttributsAttributes

AttributAttribute DescriptionDescription Type de donnéesData type ObligatoireRequired
IdId L’attribut ID correspond au CLSID.The Id attribute corresponds to the CLSID. GUID au format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. OuiYes
PathPath Chemin d’accès complet à la DLL de la classe de substitution.The full path to the surrogate class DLL. Chaîne d’une longueur de 1 à 256 caractères qui ne peut pas contenir les caractères suivants : <, >, :, ", |, ? ou *.A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. OuiYes
ThreadingModelThreadingModel Modèle de thread pour le chargement des dll.The threading model for loading DLLs. Valeur de chaîne, les choix valides sont les suivants :, STA, MTA, mainsta, Neutral.String value, valid choices are: Both, STA, MTA, MainSTA, Neutral. OuiYes
DisplayNameDisplayName Chaîne localisable correspondant à la valeur par défaut de la clé du CLSID.A localizable string corresponding to the default value of the CLSID's key. Chaîne de longueur comprise entre 1 et 256 caractères.A string between 1 and 256 characters in length. NonNo
EnableOleDefaultHandlerEnableOleDefaultHandler Elle doit être définie sur true si la valeur par défaut de la clé InprocHandler32 est « Ole32.dll ».This should be set to true if the default value of the InprocHandler32 key is "Ole32.dll". Dans le cas contraire, il doit être omis.Otherwise it should be omitted. La valeur par défaut est false.The default value is false. Propriété booléenne.Boolean. NonNo
ProgIdProgId Associe un identificateur programmatique (ProgID) à un CLSID.Associates a programmatic identifier (ProgID) with a CLSID. Une chaîne alphanumérique séparée par un point compris entre 1 et 255 caractères, par exemple foo. bar ou foo. bar. 1An alphanumeric string separated by a period between 1 and 255 characters in length, e.g. Foo.Bar or Foo.Bar.1 NonNo
VersionIndependentProgIdVersionIndependentProgId Associe un ProgID à un CLSID.Associates a ProgID with a CLSID. Cette valeur est utilisée pour déterminer la version la plus récente d’une application d’objet.This value is used to determine the latest version of an object application. Une chaîne alphanumérique séparée par un point compris entre 1 et 255 caractères, par exemple foo. bar ou foo. bar. 1An alphanumeric string separated by a period between 1 and 255 characters in length, e.g. Foo.Bar or Foo.Bar.1 NonNo
AutoConvertToAutoConvertTo Spécifie la conversion automatique d’une classe d’objets donnée en une nouvelle classe d’objets.Specifies the automatic conversion of a given class of objects to a new class of objects. GUID au format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. NonNo
InsertableObjectInsertableObject Indique que cette classe peut être insérée.Indicates that this class is insertable. Propriété booléenne.Boolean. NonNo
ShortDisplayNameShortDisplayName Version abrégée du nom complet de la classe.A short version of the class display name. Chaîne de longueur comprise entre 1 et 40 caractères.A string between 1 and 40 characters in length. NonNo

Éléments enfantsChild Elements

Élément enfantChild Element DescriptionDescription
ImplementedCategoriesImplementedCategories Spécifie les catégories implémentées par la classe.Specifies categories implemented by the class.
ConversionConversion Spécifie les autorisations de lecture/écriture d’une classe.Specifies the read/write permissions of a class.
DataFormatsDataFormats Spécifie les formats de données par défaut et principaux pris en charge.Specifies the default and main data formats supported.
MiscStatusMiscStatus Spécifie comment créer et afficher un objet.Specifies how to create and display an object.
Verbes et adverbesVerbs Spécifie les verbes à inscrire pour une application.Specifies the verbs to be registered for an application.
DefaultIconDefaultIcon Fournit des informations sur l’icône par défaut pour les présentations sous forme d’objets.Provides default icon information for iconic presentations of objects.
ToolboxBitmap32ToolboxBitmap32 Identifie le nom de module et l’ID de ressource pour une image bitmap de 16 x 16 à utiliser pour la face d’un bouton de barre d’outils ou de boîte à outils.Identifies the module name and resource ID for a 16 x 16 bitmap to use for the face of a toolbar or toolbox button.

NotesRemarks

Les inscriptions de classe avec le même AppId doivent partager un SurrogateServer, sauf si elles doivent être inscrites sous des éléments de manifeste d’applications/d’application différents.Class registrations with the same AppId should share a SurrogateServer, unless they need to be registered under different Applications/Application manifest elements.

La valeur ThreadingModel correspond au modèle de thread InprocServer32 .The ThreadingModel corresponds to the InprocServer32 threading model. Les inscriptions de classe SurrogateServer doivent avoir une inscription InprocServer32 dans la ruche privée du package.SurrogateServer class registrations should have an InprocServer32 registration in the package's private hive.

ExemplesExamples

SpécificationsRequirements
Espace de nomsNamespace http://schemas.microsoft.com/appx/manifest/com/windows10