com:Class (SurrogateServer/Class 内)

SurrogateServer クラスの登録を定義します。

要素の階層

<パッケージ>

    <アプリケーション>

         <Application>

              <拡張機能>

                   <com:Extension>

                        <com:ComServer>

                             <com:SurrogateServer>

                                  <com:Class>

構文

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

キー

? 省略可能 (0 または 1)

属性と要素

属性

属性 説明 データ型 必須 既定値
Id Id 属性は CLSID に対応します。 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 形式の GUID。 Yes
パス サロゲート クラス DLL への完全パス。 長さが 1 ~ 256 文字の文字列。、">:|?または *の各文字<を含めることはできません。 Yes
ThreadingModel DLL を読み込むスレッド モデル。 次のいずれかの値を指定できる文字列: BothSTAMTAMainSTANeutral Yes
DisplayName CLSID のキーの既定値に対応するローカライズ可能な文字列。 1 ~ 256 文字の長さの値を持つ省略可能な文字列。 いいえ
EnableOleDefaultHandler InprocHandler32 キーの既定値が "Ole32.dll" の場合、これは true に設定する必要があります。 それ以外の場合は省略する必要があります。 既定値は false です。 省略可能なブール値。 いいえ
ProgId プログラム識別子 (ProgID) を CLSID に関連付けます。 1 ~ 255 文字の長さの値を持つピリオドで区切られた省略可能な英数字文字列 (Foo.Bar や Foo.Bar.1 など) いいえ
VersionIndependentProgId ProgID を CLSID に関連付けます。 この値は、オブジェクト アプリケーションの最新バージョンを決定するために使用されます。 1 ~ 255 文字の長さの値を持つピリオドで区切られた省略可能な英数字文字列 (Foo.Bar や Foo.Bar.1 など) いいえ
AutoConvertTo オブジェクトの特定のクラスからオブジェクトの新しいクラスへの自動変換を指定します。 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 形式の省略可能な GUID。 いいえ
InsertableObject このクラスが挿入可能であることを示します。 省略可能なブール値。 いいえ
ShortDisplayName クラスの表示名の短いバージョン。 1 ~ 40 文字の長さの値を持つ省略可能な文字列。 いいえ

子要素

子要素 説明
ImplementedCategories クラスによって実装されるカテゴリを指定します。
変換 クラスの読み取り/書き込みアクセス許可を指定します。
DataFormats サポートされる既定のデータ形式とメインデータ形式を指定します。
MiscStatus オブジェクトを作成して表示する方法を指定します。
動詞 アプリケーションに登録する動詞を指定します。
DefaultIcon オブジェクトの象徴的なプレゼンテーションの既定のアイコン情報を提供します。
ToolboxBitmap32 ツール バーまたはツールボックス ボタンの顔に使用する 16 x 16 ビットマップのモジュール名とリソース ID を識別します。

親要素

親要素 説明
com:SurrogateServer SurrogateServer を 1 つまたは複数のクラス登録に登録します。

注釈

同じ AppId を持つクラス登録は、異なる Applications/Application マニフェスト要素で登録する必要がない限り、 SurrogateServer を共有する必要があります。

ThreadingModel、InprocServer32 スレッド モデルに対応します。 SurrogateServer クラスの登録には、パッケージのプライベート ハイブに InprocServer32 登録が必要です。

必要条件

Item
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10
Minimum OS Version Windows 10 バージョン 1703 (ビルド 15063)