XPS OM 컬렉션 인터페이스 작업

컬렉션 인터페이스의 일반적인 메서드를 사용하는 방법을 설명합니다.

콘텐츠

이 섹션에 설명된 메서드는 다음 목록에 표시됩니다. 일부 컬렉션 인터페이스는 이러한 각 메서드를 지원하지 않으며 일부 인터페이스는 이 페이지에 설명되지 않은 메서드도 지원합니다. 특정 인터페이스에서 지원하는 메서드 목록은 해당 인터페이스의 설명에 대한 설명을 참조하세요.

Append 메서드
GetAt 메서드
GetCount 메서드
InsertAt 메서드
RemoveAt 메서드
SetAt 메서드

참고 항목

Append 메서드

컬렉션의 끝에 개체를 추가합니다.

제네릭 구문

HRESULT Append(
  [in]  Object *object
);

설명

컬렉션의 끝에 이 메서드는 다음 다이어그램과 같이 매개 변수 목록에 전달되는 개체를 추가합니다.

a figure that shows how append adds an entry to the collection

GetAt 메서드

컬렉션의 지정된 위치에서 개체를 가져옵니다.

제네릭 구문

HRESULT GetAt(
  [in]           UINT32 index,
  [out, retval]  Object **object
);

설명

인덱스로 지정된 컬렉션의 위치에 저장된 개체를 개체에서 참조하는 변수에 씁니다. 이 작업은 컬렉션의 내용을 변경하지 않습니다. 다음 다이어그램에서는 이 프로세스를 보여 줍니다.

a figure that shows how getat retrieves an entry from the collection

GetCount 메서드

컬렉션에 저장된 개체 수를 가져옵니다.

제네릭 구문

HRESULT GetCount(
  [out, retval]  UINT32 *count
);

설명

현재 컬렉션에 저장된 개체 수를 개수로 참조되는 변수에 씁니다. 이 작업은 컬렉션의 내용을 변경하지 않습니다. 다음 다이어그램에서는 이 프로세스를 보여 줍니다.

a figure that shows how getcount gets the number of entries in the collection

InsertAt 메서드

컬렉션의 지정된 위치에 개체를 삽입합니다.

제네릭 구문

HRESULT InsertAt(
  [in]  UINT32 index,
  [in]  Object *object
);

설명

개체에 전달되는 개체인덱스로 지정된 위치의 컬렉션에 삽입됩니다. 새 개체를 삽입하기 전에 이 메서드는 이전에 인덱 스에서 위치를 차지한 개체를 1씩 이동하고 인 스에 이어 모든 인터페이스 포인터를 이동합니다. 다음 다이어그램에서는 이 프로세스를 보여 줍니다.

a figure that shows how insertat adds an entry to the collection

RemoveAt 메서드

컬렉션의 지정된 위치에서 개체를 제거합니다.

제네릭 구문

HRESULT RemoveAt(
  [in]  UINT32 index
);

설명

이 메서드는 인덱스로 지정된 위치에서 개체를 해제한 다음 인덱스에 이어 각 포인터의 인덱스를 1씩 줄여 컬렉션을 압축합니다. 다음 다이어그램에서는 이 프로세스를 보여 줍니다.

a figure that shows how removeat removes an entry from the collection

SetAt 메서드

컬렉션의 지정된 위치에 있는 개체를 바꿉니다.

제네릭 구문

HRESULT SetAt(
  [in]  UINT32 index,
  [in]  Object *object
);

설명

이 메서드는 먼저 인덱스에서 참조하는 위치에서 개체를 해제한 다음 해당 개체를 개체에 전달된 개체로 바꿉니다. 다음 다이어그램에서는 이 프로세스를 보여 줍니다.

a figure that shows how setat replaces an entry in the collection

참고 항목

IXpsOMColorProfileResourceCollection
IXpsOMDashCollection
IXpsOMDocumentCollection
IXpsOMFontResourceCollection
IXpsOMGeometryFigureCollection
IXpsOMGradientStopCollection
IXpsOMImageResourceCollection
IXpsOMNameCollection
IXpsOMPageReferenceCollection
IXpsOMPartUriCollection
IXpsOMRemoteDictionaryResourceCollection
IXpsOMSignatureBlockResourceCollection
IXpsOMVisualCollection
IXpsSignatureBlockCollection
IXpsSignatureCollection
IXpsSignatureRequestCollection