XPS OM 컬렉션 인터페이스 작업
컬렉션 인터페이스의 일반적인 메서드를 사용하는 방법을 설명합니다.
콘텐츠
이 섹션에 설명된 메서드는 다음 목록에 표시됩니다. 일부 컬렉션 인터페이스는 이러한 각 메서드를 지원하지 않으며 일부 인터페이스는 이 페이지에 설명되지 않은 메서드도 지원합니다. 특정 인터페이스에서 지원하는 메서드 목록은 해당 인터페이스의 설명에 대한 설명을 참조하세요.
Append 메서드
컬렉션의 끝에 개체를 추가합니다.
제네릭 구문
HRESULT Append(
[in] Object *object
);
설명
컬렉션의 끝에 이 메서드는 다음 다이어그램과 같이 매개 변수 목록에 전달되는 개체를 추가합니다.
GetAt 메서드
컬렉션의 지정된 위치에서 개체를 가져옵니다.
제네릭 구문
HRESULT GetAt(
[in] UINT32 index,
[out, retval] Object **object
);
설명
인덱스로 지정된 컬렉션의 위치에 저장된 개체를 개체에서 참조하는 변수에 씁니다. 이 작업은 컬렉션의 내용을 변경하지 않습니다. 다음 다이어그램에서는 이 프로세스를 보여 줍니다.
GetCount 메서드
컬렉션에 저장된 개체 수를 가져옵니다.
제네릭 구문
HRESULT GetCount(
[out, retval] UINT32 *count
);
설명
현재 컬렉션에 저장된 개체 수를 개수로 참조되는 변수에 씁니다. 이 작업은 컬렉션의 내용을 변경하지 않습니다. 다음 다이어그램에서는 이 프로세스를 보여 줍니다.
InsertAt 메서드
컬렉션의 지정된 위치에 개체를 삽입합니다.
제네릭 구문
HRESULT InsertAt(
[in] UINT32 index,
[in] Object *object
);
설명
개체에 전달되는 개체 는 인덱스로 지정된 위치의 컬렉션에 삽입됩니다. 새 개체를 삽입하기 전에 이 메서드는 이전에 인덱 스에서 위치를 차지했던 개체를 1씩 이동하고 인 덱스 다음에 오는 모든 인터페이스 포인터를 이동합니다. 다음 다이어그램에서는 이 프로세스를 보여 줍니다.
RemoveAt 메서드
컬렉션의 지정된 위치에서 개체를 제거합니다.
제네릭 구문
HRESULT RemoveAt(
[in] UINT32 index
);
설명
이 메서드는 인덱스에 지정된 위치에서 개체를 해제한 다음 인덱스에 이어 각 포인터의 인덱스를 1씩 줄여 컬렉션을 압축합니다. 다음 다이어그램에서는 이 프로세스를 보여 줍니다.
SetAt 메서드
컬렉션의 지정된 위치에 있는 개체를 바꿉니다.
제네릭 구문
HRESULT SetAt(
[in] UINT32 index,
[in] Object *object
);
설명
이 메서드는 먼저 인덱스에서 참조하는 위치에서 개체를 해제한 다음 해당 개체를 개체에 전달된 개체로 바꿉니다. 다음 다이어그램에서는 이 프로세스를 보여 줍니다.
참고 항목
IXpsOMColorProfileResourceCollection
IXpsOMDashCollection
IXpsOMDocumentCollection
IXpsOMFontResourceCollection
IXpsOMGeometryFigureCollection
IXpsOMGradientStopCollection
IXpsOMImageResourceCollection
IXpsOMNameCollection
IXpsOMPageReferenceCollection
IXpsOMPartUriCollection
IXpsOMRemoteDictionaryResourceCollection
IXpsOMSignatureBlockResourceCollection
IXpsOMVisualCollection
IXpsSignatureBlockCollection
IXpsSignatureCollection
IXpsSignatureRequestCollection
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기