다음을 통해 공유


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

텍스트가 오른쪽 맞춤입니다.

참고LVCFMT_* 상수를 사용하려면 원본 파일에 CommCtrl.h를 포함합니다.
 

[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

추가 정보

IHeaderCtrl

IHeaderCtrl2 및 열 지속성