CComSafeArrayBound 클래스

이 클래스는 SAFEARRAYBOUND 구조체에 대한 래퍼입니다.

구문

class CComSafeArrayBound : public SAFEARRAYBOUND

멤버

메서드

연산자

설명

이 클래스는 CComSafeArray에서 SAFEARRAYBOUND 사용하는 구조체에 대한 래퍼입니다. 개체의 단일 차원 CComSafeArray 의 상한과 하한을 쿼리하고 설정하는 메서드와 해당 개체에 포함된 요소 수를 제공합니다. 다차원 개체는 CComSafeArray 각 차원에 하나씩 개체 배열 CComSafeArrayBound 을 사용합니다. 따라서 GetCount와 같은 메서드를 사용하는 경우 이 메서드는 다차원 배열의 총 요소 수를 반환하지 않습니다.

헤더: atlsafe.h

요구 사항

헤더: atlsafe.h

CComSafeArrayBound::CComSafeArrayBound

생성자입니다.

CComSafeArrayBound(ULONG ulCount = 0, LONG lLowerBound = 0) throw();

매개 변수

ulCount
배열의 요소 수입니다.

lLowerBound
배열 번호가 매겨지는 하한입니다.

설명

C++ 프로그램에서 배열에 액세스하려면 하한을 0으로 정의하는 것이 좋습니다. 배열을 Visual Basic과 같은 다른 언어와 함께 사용하는 경우 다른 하한 값을 사용하는 것이 좋습니다.

CComSafeArrayBound::GetCount

요소 수를 반환하려면 이 메서드를 호출합니다.

ULONG GetCount() const throw();

Return Value

요소 수를 반환합니다.

설명

연결된 CComSafeArray 개체가 다차원 배열을 나타내는 경우 이 메서드는 맨 오른쪽 차원의 총 요소 수만 반환합니다. CComSafeArray::GetCount를 사용하여 총 요소 수를 가져옵니다.

CComSafeArrayBound::GetLowerBound

하한을 반환하려면 이 메서드를 호출합니다.

LONG GetLowerBound() const throw();

Return Value

개체의 하한을 CComSafeArrayBound 반환합니다.

CComSafeArrayBound::GetUpperBound

상한을 반환하려면 이 메서드를 호출합니다.

LONG GetUpperBound() const throw();

Return Value

개체의 상한을 CComSafeArrayBound 반환합니다.

설명

상한은 요소 수와 하한 값에 따라 달라집니다. 예를 들어 하한이 0이고 요소 수가 10이면 상한이 자동으로 9로 설정됩니다.

CComSafeArrayBound::operator =

새 CComSafeArrayBound 값으로 설정합니다.

CComSafeArrayBound& operator= (const CComSafeArrayBound& bound) throw();
CComSafeArrayBound& operator= (ULONG ulCount) throw();

매개 변수

경계
CComSafeArrayBound 개체입니다.

ulCount
요소의 수입니다.

Return Value

개체에 대한 포인터를 CComSafeArrayBound 반환합니다.

설명

개체는 CComSafeArrayBound 기존 CComSafeArrayBound개체를 사용하거나 요소 수를 제공하여 할당할 수 있습니다. 이 경우 하한은 기본적으로 0으로 설정됩니다.

CComSafeArrayBound::SetCount

요소 수를 설정하려면 이 메서드를 호출합니다.

ULONG SetCount(ULONG ulCount) throw();

매개 변수

ulCount
요소의 수입니다.

Return Value

개체의 요소 CComSafeArrayBound 수를 반환합니다.

CComSafeArrayBound::SetLowerBound

이 메서드를 호출하여 하한을 설정합니다.

LONG SetLowerBound(LONG lLowerBound) throw();

매개 변수

lLowerBound
하한입니다.

Return Value

개체의 새 하한을 CComSafeArrayBound 반환합니다.

설명

Visual C++ 프로그램에서 배열에 액세스하려면 하한을 0으로 정의하는 것이 좋습니다. 배열을 Visual Basic과 같은 다른 언어와 함께 사용하는 경우 다른 하한 값을 사용하는 것이 좋습니다.

상한은 요소 수와 하한 값에 따라 달라집니다. 예를 들어 하한이 0이고 요소 수가 10이면 상한이 자동으로 9로 설정됩니다.

참고 항목

클래스 개요