IXpsOMDictionary::InsertAt 메서드(xpsobjectmodel.h)

사전의 지정된 위치에 IXpsOMShareable 인터페이스를 삽입하고 인터페이스를 식별하도록 키를 설정합니다.

구문

HRESULT InsertAt(
  [in] UINT32          index,
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

매개 변수

[in] index

IXpsOMShareable 인터페이스를 삽입할 사전의 인덱스(0부터 시작)입니다.

[in] key

사전에서 IXpsOMShareable 인터페이스를 식별하는 데 사용할 키입니다.

키에서 참조하는 문자열은 사전에서 고유해야 합니다.

[in] entry

인덱스로 지정된 위치에 삽입할 IXpsOMShareable 인터페이스 포인터입니다.

사전에 중복 인터페이스 포인터를 포함할 수 없습니다. 이 매개 변수는 사전에 없는 인터페이스 포인터를 포함해야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 이에 국한되지 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.

설명

사전에 저장된 인터페이스 포인터는 일반적으로 IXpsOMShareable 인터페이스에서 파생된 IXpsOMBrush 및 IXpsOMVisual과 같은 인터페이스에 대한 포인터입니다. 인터페이스 형식을 확인하려면 IXpsOMShareable::GetType 메서드를 호출합니다.

인덱스로 지정된 위치에서 이 메서드는 IXpsOMShareable 인터페이스 포인터를 삽입하고 키를 설정합니다. 인터페이스 포인터와 키는 각각 값과 키로 전달됩니다. 값과 키를 삽입하기 전에 이 위치와 모든 후속 위치의 인터페이스 포인터와 키가 하나의 인덱스로 위로 이동합니다.

다음 그림에서는 InsertAt 메서드에 의해 사전이 변경되는 방법을 보여 줍니다.

요구 사항

추가 정보

IXpsOMDictionary

IXpsOMShareable

XML Paper Specification

XPS 문서 오류