Interface IOpcRelationship (msopc.h)

Artigo
03/05/2024

Representa uma relação, que é um link entre uma origem, que é uma parte ou o pacote e um destino. O destino da relação pode ser uma parte ou um recurso externo.

Herança

A interface IOpcRelationship herda da interface IUnknown . IOpcRelationship também tem estes tipos de membros:

Métodos

A interface IOpcRelationship tem esses métodos.


IOpcRelationship::GetId Obtém o identificador exclusivo da relação.
IOpcRelationship::GetRelationshipType Obtém o tipo de relação.
IOpcRelationship::GetSourceUri Obtém o URI da origem da relação.
IOpcRelationship::GetTargetMode Obtém um valor que descreve se o destino da relação é interno ou externo ao pacote.
IOpcRelationship::GetTargetUri Obtém o URI do destino da relação.

Comentários

Para criar um objeto de relação para representar uma relação, chame o método IOpcRelationshipSet::CreateRelationship . Para obter um ponteiro para a interface de um objeto de relação que representa uma relação existente, chame o método IOpcRelationshipSet::GetRelationship ou IOpcRelationshipEnumerator::GetCurrent .

Exemplo de marcação de relação para uma relação direcionada a uma parte:

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

Usar o tipo de relação (atributo Type do elemento Relationship ) é a maneira definitiva de encontrar uma parte em um pacote. Para obter mais informações sobre por que o tipo de relação é usado, consulte a Visão geral de partes. Para obter um exemplo de como usar o tipo de relação para localizar uma parte, consulte Localizando a parte de propriedades principais.

Identificadores válidos para relações estão em conformidade com as restrições para xsd:ID, que estão documentadas na seção 3.3.8 ID da Recomendação W3C, Esquema XML Parte 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID).

Os métodos de interface IOpcRelationship fornecem acesso às propriedades de relação para uma relação (que é representada por um objeto de relação). Os métodos, as propriedades e descrições associadas estão listados na tabela a seguir.

Método	Propriedade	Descrição
GetId	Identificador de relação	O identificador exclusivo e arbitrário de uma relação que é local para o pacote.
GetRelationshipType	Tipo de relação	O nome qualificado de uma relação definida pelo designer de pacote.
GetSourceUri	URI de origem	O URI da origem da relação. O URI de origem pode ser o URI do pacote ou de uma parte.
GetTargetMode	Modo de destino	Indica se o destino da relação é interno ou externo ao pacote.
GetTargetUri	URI de destino	O URI do destino da relação.

Para obter mais informações sobre relações, consulte Open Packaging Conventions Fundamentals and the ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

Acesso thread-safe

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução com a API de Empacotamento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h