IOpcRelationship インターフェイス (msopc.h)

[アーティクル]
08/25/2023

一部またはパッケージであるソースとターゲットの間のリンクであるリレーションシップを表します。リレーションシップのターゲットは、一部または外部リソースにすることができます。

継承

IOpcRelationship インターフェイスは、IUnknown インターフェイスから継承します。 IOpcRelationship には、次の種類のメンバーもあります。

メソッド

IOpcRelationship インターフェイスには、これらのメソッドがあります。


IOpcRelationship::GetId リレーションシップの一意識別子を取得します。
IOpcRelationship::GetRelationshipType リレーションシップの種類を取得します。
IOpcRelationship::GetSourceUri リレーションシップソースの URI を取得します。
IOpcRelationship::GetTargetMode リレーションシップのターゲットがパッケージの内部か外部かを示す値を取得します。
IOpcRelationship::GetTargetUri リレーションシップターゲットの URI を取得します。

注釈

リレーションシップを表すリレーションシップオブジェクトを作成するには、 IOpcRelationshipSet::CreateRelationship メソッドを呼び出します。既存のリレーションシップを表すリレーションシップオブジェクトのインターフェイスへのポインターを取得するには、 IOpcRelationshipSet::GetRelationship メソッドまたは IOpcRelationshipEnumerator::GetCurrent メソッドを呼び出します。

パーツを対象とするリレーションシップのリレーションシップマークアップの例:

<Relationship Id="rId1"
    Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument"
    Target="word/document.xml" />

リレーションシップの種類 (Relationship 要素の Type 属性) を使用することは、パッケージ内のパーツを見つける決定的な方法です。リレーションシップの種類が使用される理由の詳細については、「パーツの概要」を参照してください。リレーションシップの種類を使用してパーツを検索する例については、「コアプロパティパーツの検索」を参照してください。

リレーションシップの有効な識別子は xsd:ID の制限に準拠しています。これは、「 W3C Recommendation, XML Schema Part 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID)」のセクション 3.3.8 ID に記載されています。

IOpcRelationship インターフェイスメソッドは、リレーションシップ (リレーションシップオブジェクトで表される) のリレーションシッププロパティへのアクセスを提供します。メソッド、関連するプロパティ、および説明を次の表に示します。

メソッド	プロパティ	説明
GetId	リレーションシップ識別子	パッケージに対してローカルなリレーションシップの一意の任意の識別子。
GetRelationshipType	リレーションシップの種類	パッケージデザイナーによって定義されたリレーションシップの修飾名。
GetSourceUri	ソース URI	リレーションシップのソースの URI。ソース URI には、パッケージまたはパーツの URI を指定できます。
GetTargetMode	ターゲットモード	リレーションシップのターゲットがパッケージの内部か外部かを示します。
GetTargetUri	ターゲット URI	リレーションシップのターゲットの URI。

リレーションシップの詳細については、 Open Packaging Conventions Fundamentals と ECMA-376 OpenXML、1st Edition、Part 2: Open Packaging Conventions (OPC) を参照してください。

スレッドセーフ

パッケージ化オブジェクトはスレッドセーフではありません。

詳細については、Packaging API を使用したはじめにに関するページを参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	msopc.h