CMFCFilterChunkValueImpl 클래스
청크 및 속성 값 쌍 논리를 모두 간소화하는 클래스입니다.
구문
class CMFCFilterChunkValueImpl : public ATL::IFilterChunkValue;
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
| CMFCFilterChunkValueImpl::~CMFCFilterChunkValueImpl | 개체를 소멸합니다. |
| CMFCFilterChunkValueImpl::CMFCFilterChunkValueImpl | 개체를 생성합니다. |
공용 메서드
보호된 메서드
| 속성 | 설명 |
|---|---|
| CMFCFilterChunkValueImpl::SetChunk | 청크의 공통 속성을 설정하는 도우미 함수입니다. |
설명
사용하기 위해 올바른 종류의 CMFCFilterChunkValueImpl 클래스를 만들기만 하면 됩니다.
예시:
CMFCFilterChunkValueImpl 청크;
hr = 청크입니다. SetBoolValue(PKEY_IsAttachment, true);
또는
hr = 청크입니다. SetFileTimeValue(PKEY_ItemDate, ftLastModified);
상속 계층 구조
ATL::IFilterChunkValue
요구 사항
헤더: afxwin.h
CMFCFilterChunkValueImpl::Clear
ChunkValue를 지웁니다.
void Clear();
설명
CMFCFilterChunkValueImpl::CMFCFilterChunkValueImpl
개체를 생성합니다.
CMFCFilterChunkValueImpl();
설명
CMFCFilterChunkValueImpl::~CMFCFilterChunkValueImpl
개체를 소멸합니다.
virtual ~CMFCFilterChunkValueImpl();
설명
CMFCFilterChunkValueImpl::CopyChunk
청크의 특성을 설명하는 구조체에 이 청크를 복사합니다.
HRESULT CopyChunk(STAT_CHUNK* pStatChunk);
매개 변수
pStatChunk
청크의 특성을 설명하는 대상 값에 대한 포인터입니다.
Return Value
S_OK 성공하면
설명
CMFCFilterChunkValueImpl::CopyFrom
다른 값에서 이 청크 값을 초기화합니다.
void CopyFrom (IFilterChunkValue* pValue);
매개 변수
pValue
복사할 원본 값을 지정합니다.
설명
CMFCFilterChunkValueImpl::GetChunkGUID
청크 GUID를 검색합니다.
REFGUID GetChunkGUID() const;
Return Value
청크를 식별하는 GUID에 대한 참조입니다.
설명
CMFCFilterChunkValueImpl::GetChunkPID
청크 PID(속성 ID)를 검색합니다.
DWORD GetChunkPID() const;
Return Value
속성 ID를 포함하는 DWORD 값입니다.
설명
CMFCFilterChunkValueImpl::GetChunkType
청크 유형을 검색합니다.
CHUNKSTATE GetChunkType() const;
Return Value
현재 청크가 텍스트 형식 속성인지 아니면 값 형식 속성인지를 지정하는 CHUNKSTATE 열거형 값입니다.
설명
CMFCFilterChunkValueImpl::GetString
문자열 값을 검색합니다.
CString &GetString();
Return Value
청크 값을 포함하는 문자열입니다.
설명
CMFCFilterChunkValueImpl::GetValue
값을 할당된 전파 변수로 검색합니다.
HRESULT GetValue(PROPVARIANT** ppPropVariant);
매개 변수
ppPropVariant
함수가 반환되면 이 매개 변수에는 청크 값이 포함됩니다.
Return Value
PROPVARIANT가 성공적으로 할당되고 청크 값이 ppPropVariant에 성공적으로 복사되었는지 S_OK. 그렇지 않으면 오류 코드입니다.
설명
CMFCFilterChunkValueImpl::GetValueNoAlloc
할당하지 않은(내부 값) 값을 반환합니다.
PROPVARIANT GetValueNoAlloc ();
Return Value
현재 청크 값을 반환합니다.
설명
CMFCFilterChunkValueImpl::IsValid
이 속성 값이 유효한지 여부를 확인합니다.
BOOL IsValid() const;
Return Value
현재 청크 값이 유효한 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCFilterChunkValueImpl::SetBoolValue
오버로드됨. 키로 속성을 부울로 설정합니다.
HRESULT SetBoolValue(
REFPROPERTYKEY pkey,
BOOL bVal,
CHUNKSTATE chunkType = CHUNK_VALUE,
LCID locale = 0,
DWORD cwcLenSource = 0,
DWORD cwcStartSource = 0,
CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);
HRESULT SetBoolValue(
REFPROPERTYKEY pkey,
VARIANT_BOOL bVal,
CHUNKSTATE chunkType = CHUNK_VALUE,
LCID locale = 0,
DWORD cwcLenSource = 0,
DWORD cwcStartSource = 0,
CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);
매개 변수
pkey
속성 키를 지정합니다.
bVal
설정할 청크 값을 지정합니다.
chunkType
플래그는 이 청크에 텍스트 형식 또는 값 형식 속성이 포함되어 있는지 여부를 나타냅니다. 플래그 값은 CHUNKSTATE 열거형에서 가져옵니다.
로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.
cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.
cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.
chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.
Return Value
S_OK 성공하면
설명
CMFCFilterChunkValueImpl::SetChunk
청크의 공통 속성을 설정하는 도우미 함수입니다.
HRESULT SetChunk(
REFPROPERTYKEY pkey,
CHUNKSTATE chunkType=CHUNK_VALUE,
LCID locale=0,
DWORD cwcLenSource=0,
DWORD cwcStartSource=0,
CHUNK_BREAKTYPE chunkBreakType=CHUNK_NO_BREAK);
매개 변수
pkey
속성 키를 지정합니다.
chunkType
플래그는 이 청크에 텍스트 형식 또는 값 형식 속성이 포함되어 있는지 여부를 나타냅니다. 플래그 값은 CHUNKSTATE 열거형에서 가져옵니다.
로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.
cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.
cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.
chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.
Return Value
S_OK 성공하면
설명
CMFCFilterChunkValueImpl::SetDwordValue
키별로 속성을 DWORD로 설정합니다.
HRESULT SetDwordValue(
REFPROPERTYKEY pkey,
DWORD dwVal,
CHUNKSTATE chunkType = CHUNK_VALUE,
LCID locale = 0,
DWORD cwcLenSource = 0,
DWORD cwcStartSource = 0,
CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);
매개 변수
pkey
속성 키를 지정합니다.
dwVal
설정할 청크 값을 지정합니다.
chunkType
플래그는 이 청크에 텍스트 형식 또는 값 형식 속성이 포함되어 있는지 여부를 나타냅니다. 플래그 값은 CHUNKSTATE 열거형에서 가져옵니다.
로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.
cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.
cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.
chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.
Return Value
S_OK 성공하면
설명
CMFCFilterChunkValueImpl::SetFileTimeValue
키별로 속성을 파일 시간으로 설정합니다.
HRESULT SetFileTimeValue(
REFPROPERTYKEY pkey,
FILETIME dtVal,
CHUNKSTATE chunkType = CHUNK_VALUE,
LCID locale = 0,
DWORD cwcLenSource = 0,
DWORD cwcStartSource = 0,
CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);
매개 변수
pkey
속성 키를 지정합니다.
dtVal
설정할 청크 값을 지정합니다.
chunkType
플래그는 이 청크에 텍스트 형식 또는 값 형식 속성이 포함되어 있는지 여부를 나타냅니다. 플래그 값은 CHUNKSTATE 열거형에서 가져옵니다.
로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.
cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.
cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.
chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.
Return Value
S_OK 성공하면
설명
CMFCFilterChunkValueImpl::SetInt64Value
키별로 속성을 int64로 설정합니다.
HRESULT SetInt64Value(
REFPROPERTYKEY pkey,
__int64 nVal,
CHUNKSTATE chunkType = CHUNK_VALUE,
LCID locale = 0,
DWORD cwcLenSource = 0,
DWORD cwcStartSource = 0,
CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);
매개 변수
pkey
속성 키를 지정합니다.
nVal
설정할 청크 값을 지정합니다.
chunkType
플래그는 이 청크에 텍스트 형식 또는 값 형식 속성이 포함되어 있는지 여부를 나타냅니다. 플래그 값은 CHUNKSTATE 열거형에서 가져옵니다.
로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.
cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.
cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.
chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.
Return Value
S_OK 성공하면
설명
CMFCFilterChunkValueImpl::SetIntValue
속성 기준 키를 int로 설정합니다.
HRESULT SetIntValue(
REFPROPERTYKEY pkey,
int nVal,
CHUNKSTATE chunkType = CHUNK_VALUE,
LCID locale = 0,
DWORD cwcLenSource = 0,
DWORD cwcStartSource = 0,
CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);
매개 변수
pkey
속성 키를 지정합니다.
nVal
설정할 청크 값을 지정합니다.
chunkType
플래그는 이 청크에 텍스트 형식 또는 값 형식 속성이 포함되어 있는지 여부를 나타냅니다. 플래그 값은 CHUNKSTATE 열거형에서 가져옵니다.
로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.
cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.
cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.
chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.
Return Value
S_OK 성공하면
설명
CMFCFilterChunkValueImpl::SetLongValue
키별로 속성을 LONG으로 설정합니다.
HRESULT SetLongValue(
REFPROPERTYKEY pkey,
long lVal,
CHUNKSTATE chunkType = CHUNK_VALUE,
LCID locale = 0,
DWORD cwcLenSource = 0,
DWORD cwcStartSource = 0,
CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);
매개 변수
pkey
속성 키를 지정합니다.
lVal
설정할 청크 값을 지정합니다.
chunkType
플래그는 이 청크에 텍스트 형식 또는 값 형식 속성이 포함되어 있는지 여부를 나타냅니다. 플래그 값은 CHUNKSTATE 열거형에서 가져옵니다.
로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.
cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.
cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.
chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.
Return Value
S_OK 성공하면
설명
CMFCFilterChunkValueImpl::SetSystemTimeValue
키별 속성을 SystemTime으로 설정합니다.
HRESULT SetSystemTimeValue(
REFPROPERTYKEY pkey,
const SYSTEMTIME& systemTime,
CHUNKSTATE chunkType = CHUNK_VALUE,
LCID locale=0,
DWORD cwcLenSource=0,
DWORD cwcStartSource=0,
CHUNK_BREAKTYPE chunkBreakType=CHUNK_NO_BREAK);
매개 변수
pkey
속성 키를 지정합니다.
systemTime
설정할 청크 값을 지정합니다.
chunkType
플래그는 이 청크에 텍스트 형식 또는 값 형식 속성이 포함되어 있는지 여부를 나타냅니다. 플래그 값은 CHUNKSTATE 열거형에서 가져옵니다.
로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.
cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.
cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.
chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.
Return Value
S_OK 성공하면
설명
CMFCFilterChunkValueImpl::SetTextValue
키별 속성을 유니코드 문자열로 설정합니다.
HRESULT SetTextValue(
REFPROPERTYKEY pkey,
LPCTSTR pszValue,
CHUNKSTATE chunkType = CHUNK_VALUE,
LCID locale = 0,
DWORD cwcLenSource = 0,
DWORD cwcStartSource = 0,
CHUNK_BREAKTYPE chunkBreakType = CHUNK_NO_BREAK);
매개 변수
pkey
속성 키를 지정합니다.
pszValue
설정할 청크 값을 지정합니다.
chunkType
플래그는 이 청크에 텍스트 형식 또는 값 형식 속성이 포함되어 있는지 여부를 나타냅니다. 플래그 값은 CHUNKSTATE 열거형에서 가져옵니다.
로캘
텍스트 청크에 연결된 언어 및 하위 언어입니다. 청크 로캘은 문서 인덱서에서 텍스트의 적절한 단어 분리를 수행하는 데 사용됩니다. 청크가 텍스트 형식이나 데이터 형식이 VT_LPWSTR, VT_LPSTR 또는 VT_BSTR 있는 값 형식이 아니면 이 필드는 무시됩니다.
cwcLenSource
현재 청크가 파생된 원본 텍스트의 문자 길이입니다. 0 값은 원본 텍스트와 파생 텍스트 간의 문자별 대응을 나타냅니다. 0이 아닌 값은 이러한 직접 대응이 존재하지 않음을 의미합니다.
cwcStartSource
파생 청크의 원본 텍스트가 원본 청크에서 시작되는 오프셋입니다.
chunkBreakType
이전 청크를 현재 청크와 구분하는 나누기 유형입니다. 값은 CHUNK_BREAKTYPE 열거형에서 가져옵니다.
Return Value
S_OK 성공하면