com:Class (em SurrogateServer/Class)

  • Artigo

Define um registro de classe SurrogateServer.

Hierarquia de elementos

<Pacote>

    <Aplicativos>

         <Aplicativo>

              <Extensões>

                   <com:Extension>

                        <com:ComServer>

                             <com:SurrogateServer>

                                  <com:Class>

Syntax

<com:Class
    Id = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    Path = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ThreadingModel = 'A string that can be one of the following values: "Both", "STA", "MTA", "MainSTA", "Neutral".'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    EnableOleDefaultHandler = 'An optional boolean value.'
    ProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    VersionIndependentProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    AutoConvertTo = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    InsertableObject = 'An optional boolean value.'
    ShortDisplayName = 'An optional string with a value between 1 and 40 characters in length.' >

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

</com:Class>

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Valor padrão
Id O atributo Id corresponde ao CLSID. Um GUID no formulário xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx. Yes
Caminho O caminho completo para a DLL de classe substituta. Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento que não pode conter esses caracteres: <, >, :, , ", |?ou *. Yes
ThreadingModel O modelo de threading para carregar DLLs. Uma cadeia de caracteres que pode ser um dos seguintes valores: STA, MTA, MainSTA, Neutral. Yes
DisplayName Uma cadeia de caracteres localizável correspondente ao valor padrão da chave do CLSID. Uma cadeia de caracteres opcional com um valor entre 1 e 256 caracteres de comprimento. No
EnableOleDefaultHandler Isso deverá ser definido como true se o valor padrão da chave InprocHandler32 for "Ole32.dll". Caso contrário, ele deverá ser omitido. O valor padrão é false. Um valor booliano opcional. No
ProgId Associa um identificador programático (ProgID) a um CLSID. Uma cadeia de caracteres alfanumérica opcional separada por um período com um valor entre 1 e 255 caracteres de comprimento (por exemplo, Foo.Bar ou Foo.Bar.1) No
VersionIndependentProgId Associa um ProgID a um CLSID. Esse valor é usado para determinar a versão mais recente de um aplicativo de objeto. Uma cadeia de caracteres alfanumérica opcional separada por um período com um valor entre 1 e 255 caracteres de comprimento (por exemplo, Foo.Bar ou Foo.Bar.1) No
AutoConvertTo Especifica a conversão automática de uma determinada classe de objetos em uma nova classe de objetos. Um GUID opcional no formulário xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx. No
InsertableObject Indica que essa classe é inserida. Um valor booliano opcional. No
ShortDisplayName Uma versão curta do nome de exibição da classe. Uma cadeia de caracteres opcional com um valor entre 1 e 40 caracteres de comprimento. No

Elementos filho

Elemento filho Descrição
ImplementedCategories Especifica categorias implementadas pela classe .
Conversão Especifica as permissões de leitura/gravação de uma classe.
Dataformats Especifica os formatos de dados padrão e main com suporte.
Miscstatus Especifica como criar e exibir um objeto.
Verbos Especifica os verbos a serem registrados para um aplicativo.
Defaulticon Fornece informações de ícone padrão para apresentações icônicas de objetos.
ToolboxBitmap32 Identifica o nome do módulo e a ID do recurso para um bitmap de 16 x 16 bits a ser usado para a face de um botão de barra de ferramentas ou caixa de ferramentas.

Elementos pai

Elemento pai Descrição
com:SurrogateServer Registra um SurrogateServer com um ou muitos registros de classe.

Comentários

Os registros de classe com o mesmo AppId devem compartilhar um SurrogateServer, a menos que precisem ser registrados em diferentes elementos de manifesto Aplicativos/Aplicativo.

O ThreadingModel corresponde ao modelo de threading InprocServer32 . Os registros de classe SurrogateServer devem ter um registro InprocServer32 no hive privado do pacote.

Requisitos

Item Valor
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10
Minimum OS Version Windows 10 versão 1703 (Build 15063)