IHeaderCtrl::InsertColumn 메서드(mmc.h)
기본 결과 창에 열을 추가합니다.
구문
HRESULT InsertColumn(
[in] int nCol,
[in] LPCWSTR title,
[in] int nFormat,
[in] int nWidth
);
매개 변수
[in] nCol
삽입할 열의 인덱스(0부터 시작)입니다.
[in] title
삽입할 열의 제목을 나타내는 문자열을 지정하는 값입니다. 이 문자열의 최대 길이는 MAX_PATH 문자일 수 있습니다.
[in] nFormat
열 내의 텍스트 위치를 지정하는 값입니다. 열 0의 경우 nFormat을 LVCFMT_LEFT 합니다. 이 값은 다음 중 하나여야 합니다.
LVCFMT_LEFT
텍스트가 왼쪽 맞춤입니다.
LVCFMT_CENTER
텍스트가 가운데 맞춤입니다.
LVCFMT_RIGHT
텍스트가 오른쪽 맞춤입니다.
[in] nWidth
열의 너비를 픽셀 단위로 지정하는 값입니다. 이 값은 다음 중 하나여야 합니다.
MMCLV_AUTO
MMC는 제목 문자열에 따라 열의 너비를 자동으로 결정합니다.
HIDE_COLUMN
MMC 1.2에 도입되었습니다. 열이 삽입되지만 숨겨집니다. 사용자는 목록 보기를 사용자 지정할 때 열을 표시할 수 있습니다.
MMC 1.2 SDK를 사용하여 빌드되었지만 이전 버전의 MMC에 로드되는 스냅인의 경우 HIDE_COLUMN 너비가 0으로 해석됩니다. 사용자는 마우스로 열을 끌어 열을 확장할 수 있습니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
설명
MMC는 IHeaderCtrl::InsertColumn의 작업으로 인해 열 집합에 대한 변경 내용이 메모리에 유지되지 않으므로 스냅인은 열 집합에 열을 삽입한 후 지속형 열 구성 데이터를 업데이트해야 합니다. 자세한 내용은 IHeaderCtrl2 및 열 지속성을 참조하세요.
발신자에게 참고 사항
결과 보기에 이미 삽입된 항목이 있으면 InsertColumn 에 대한 호출이 실패합니다.요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista |
지원되는 최소 서버 | Windows Server 2008 |
대상 플랫폼 | Windows |
헤더 | mmc.h |
DLL | Mmcndmgr.dll |