WANIGrid Control 사용법 1

WANIGrid 는 데이터를 Grid 형태로 제공하고 행 추가 및 수정, 삭제 등의 기본적인 기능들을 제공하는 WinForm용 Control이다.

 

Grid Control 만들기를 연재하면서 스스로 공부하면서 정리한 내용으로 Grid Control 만들기의 소스를 좀 더 다듬고 개선해서 WinForm 개발 시에 무료로 제한없이 사용할 수 있도록 WANIGrid Control 만들어 갈 생각이다.

WANIGrid Control 사용에 필요한 속성 정보와 API 들을 정리하고 보다 쉽게 사용할 수 있는 매뉴얼을 제공해서 Windows 개발자들이 보다 손 쉽게 사용할 수 있도록 할 것이다. 

 

제공하는 WANIGrid Control과 예제 소스를 통해서 직접 사용해 보면서 추가 개발 또는 개선이 필요한 사항이 있으면 언제든 댓글로 알려주세요.

 

WANIGrid Control을 사용하기 위한 기본적인 속성과 구성을 살펴보자.

[그림 1] WANIGrid Control 구성

WANIGrid Control 의 Client Size를 기준으로 보여지는 첫 번째 컬럼과 마지막 컬럼의 번호를 기준으로 가로 영역을 표현하고, 행 또한 첫 번째 행의 번호와 마지막 행의 번호를 기준으로 세로 영역을 표현하게 된다.

가로/세로 스크롤바를 움직임에 따라 컬럼과 행의 시작/마지막 번호가 변경되며 이 값을 기준으로 표현되어야 할 데이터 영역을 표현하게 된다.

• LeftHeader 영역은 첫 시작 컬럼이며 WANIGrid의 기본 컬럼이다. 폭의 기본 사이즈는 22이다.
• XscHeight/YscWidth 영역은 가로/세로 스크롤바의 높이와 폭의 사이즈를 말한다.
• RowHeight 는 각 행의 높이를 의미하며 기본 높이는 20의 값을 가지고 사용자가 변경할 수 있다.
• TopHeader 는 헤더 영역의 각 컬럼 속성 정보들을 담고 있다.
• TopHeaderHeight 는 헤더 영역의 높이를 말하며 기본 높이는 20의 값을 가지고 사용자가 변경할 수 있다.
• FirstVisibleCol/LastVisibleCol 은 화면 상에서 보여지는 첫 번째 컬럼의 Index와 마지막 컬럼의 Index 값을 가지고 있다.
• FirstVisibleRow/LastVisinleRow 는 화면 상에서 보여지는 첫 번째 행의 Index와 마지막 컬럼의 Index 값을 가지고 있다.

WANIGrid Control에서 제공되는 기본 속성(Property)들을 아래와 같이 정리해 보았다.

Scope	Type	명칭	내용
public	Cell	ActiveCell	선택한 셀의 행/열 정보를 저장
public	int	RowHeight	행 높이를 설정 또는 반환
public	int	TopHeaderHeight	WANIGrid의 Top Header 영역의 높이를 설정 또는 반환
public	TopHeader	TopHeaderList	Top Header에 정의한 컬럼 목록을 가져온다
public	bool	LeftHeaderVisible	맨 왼쪽의 컬럼을 보여줄 경우 true, 그렇지 않으면 false
public	int	FixedCol	고정할 컬럼 개수. 스크롤 시에 고정되는 컬럼의 개수를 설정 또는 반환. 첫번째 컬럼부터 시작하며 컬럼의 Visiable 속성이 true인 컬럼의 개수만큼 고정이됨
public	int	XscHeight	가로 스크롤의 높이
public	int	YscWidth	세로 스크롤의 폭
public	bool	FixedColEditable	고정컬럼 영역의 값 수정 여부. false인 경우 Column의 값을 수정할 수 없음
public	int	AllRowsHeight	헤더 영역을 제외한 행(Row)의 총 높이(길이) 값을 반환
public	RowCollection	Rows	행(Row) 정보를 담고 있는 RowCollection을 반환
public	List<int>	SelectedRows	선택된 행(Row)의 Index정보 목록을 반환
public	List<int>	SelectedCols	선택된 열(Column)의 Index정보 목록을 반환
public	bool	ReadOnly	WANIGrid의 내용을 읽기 전용으로 설정 또는 반환. ReadOnly 값이 true인 경우 WANIGrid 내의 값을 변경할 수 없다.

 

WANIGrid Control 사용 예제를 담은 파일은 아래를 참조.

WANIGridExample_20200430.zip

0.21MB