3-1. SmartForm, SmartInnerForm 생성 및 배경 이미지 삽입

최신 프로젝트에 Old Ver. 프로젝트와 동일한 이름으로 Form 관련 소스코드 파일(ex. MainForm.cs, ChildForm.cs 등)을 생성하고 각 파일에 알맞게 SmartForm, SmartInnerForm을 직접 생성합니다.

[Old 버전의 프로젝트 예시] [최신 버전의 프로젝트 예시] 3-2. 모든 컴포넌트 배치

해당 작업은 Form별로 진행하며 배치 작업을 먼저 끝낸 후 세부 속성 및 이미지 작업을 진행합니다.

Old Ver.의 모든 컴포넌트는 최신 버전의 프로젝트로 복사하여 사용할 수 있습니다. 단, 복사를 하는 경우에도 폼 디자이너에서 일부 속성을 설정해야 합니다.

[컴포넌트 배치 및 속성 설정 예시] 3-3. 컴포넌트 이미지 설정

최신 버전 프로젝트에 배치한 모든 사용자 인터페이스 컴포넌트에 대해, 아래의 “변경된 이미지 속성 표”를 참고하여 Old 버전과 동일한 이미지가 적용되도록 폼 디자이너를 통해 설정합니다.

[컴포넌트별 이미지 설정 예시]

컴포넌트	변경된 이미지 속성
Smart Button	주의마스킹 처리가 안돼있는 버튼 이미지 사용 시 BackGround를 없음으로 사용하시기 바랍니다.
Smart Radio Button	변경사항 없음
Smart Draw
Smart ListBox	리스트박스 내부에 Scroll Up, Down 버튼이 추가되었습니다.
Smart Combo Box
Smart UpDown	배경 이미지를 설정하는 속성 삭제되었습니다.
Smart Group Box

3-4. 컴포넌트 속성 변경

폼 디자이너에서는 복사 여부와 관계없이, 최신 버전의 모든 컴포넌트에 대해 Old 버전과 동일하게 속성을 재설정해야 합니다. 자세한 내용은 아래 “컴포넌트별 공통 변경 사항 표”를 참고해주시기 바랍니다.
또한, 컴포넌트를 복사해서 사용할 경우 추가로 설정이 필요한 항목이 있으니, 해당 내용은 아래 "사용자 인터페이스 컴포넌트를 복사할 경우 재설정해야 하는 주요 속성 표" 를 확인하시기 바랍니다.

[컴포넌트별 공통 변경 사항 표]

설명	공통 변경 사항
투명 효과 처리를 위한 배경 컴포넌트 설정 속성 통합
컴포넌트 배경 색상 설정 속성 이름 변경

[사용자 인터페이스 컴포넌트를 복사할 경우 재설정해야 하는 주요 속성 표]

컴포넌트	폼 디자이너에서 재설정해야 하는 주요 속성
Smart Form	복사 불가능
Smart InnerForm	복사 불가능
Smart Label	BackGround, BackGroundColor, TextColor
Smart Button	ButtonImage, BackGround, ButtonText 주의마스킹 처리가 안돼있는 버튼 이미지 사용 시 BackGround를 없음으로 사용하시길 바랍니다.
Smart Radio Button	TextColor, RadioOutlineColor
Smart Check Box	TextColor
Smart List Box	SmartButton 삭제(기존에는 SmartButton을 사용하여 항목을 스크롤 했지만 ScrollBar속성으로 대체 되었습니다.), BackGroundColor, BorderStyle, ScrollBar 속성
Smart Combo Box	ButtonImage, BackGround, BackGroundColor, ItemList의 BackGround, scrollButtonImage, DropDownButtonWidth 드롭다운박스 버튼의 가로는 DropDownButtonWidth, 세로는 ComboBox의 Size를 변경해서 맞춥니다. 리스트박스의 업다운 버튼 넓이 변경 시 ScrollButtonWidth를 변경 해야합니다.
Smart UpDown	(기존의 SmartUpDown 자체의 BackImage 설정은 삭제 되었으며 배경이 되는 컴포넌트에 이미지를 삽입 하고 BackGround 설정을 통해 배경을 적용해야 합니다.) LayoutStyle 설정→ UpDownButton의 이미지를 삽입 후 UpDownButtonSize를 조절하여 크기 맞추기→ Location 속성을 이용해 Button위치조정 → TextLocation, Text H,V Align속성을 통해 Text의 위치 조정 → BackGround, BorderStyle, Maximum, Minimum 설정
Smart Group Box	BackImage
Smart Key board	RoundRectFillColor, KeyTextColor, KeyTextFont, KeyPressFill, Outline, Text Color
Smart Key Pad	복사 불가능
Smart Draw	SmartDraw의 SetBackImage 속성이 삭제되어 단순 이미지를 적용하는 컴포넌트인 SmarPictureBox로 대체 되었습니다. 그 외의 Draw 기능은 사용 가능합니다.
Smart Progress Bar	변경점X
Smart TrackBar	StepRange

[컴포넌트 별 변경 사항]    전체 펼침  전체 닫기

SmartForm +

- 자식 폼에서 Index가 0번인 메인 폼을 표시하는 방법이 변경됨

• 변경 전

  ((Form1)(Owner)).SmartForm1.Show(0);

• 변경 후

  smarForm1.Show(0);

- 기존에는 화면 전환 시 잔상 및 겹침 현상을 SuspendLayoutInterval 속성으로 개선했으나, 해당 속성은 제거되었고, 현재는 SmartForm 내부에 해당 기능이 내장되어 자동으로 처리됨.
- 속성삭제 : ChildForms

SmartInnerForm +

- 기존에는 화면 전환 시 잔상 및 겹침 현상을 SuspendLayoutInterval 속성으로 개선했으나, 해당 속성은 제거되었고, 현재는 SmartForm 내부에 해당 기능이 내장되어 자동으로 처리됨.

SmartLabel +

- 속성명 변경 : ForeColor → TextColor

• 변경 전

  smartLabel1.ForeColor = Color.Red;

• 변경 후

  smartLabel1.TextColor = Color.Red;

SmartButton +

- 속성명 변경
DownImage, DisableImage → ImageUp, ImageDown, ImageDisable
Text → ButtonText

• 변경 전

  smartButton1.Text = "Line";

• 변경 후

  smartButton1.ButtonText = "Line";

SmartRadioButton +

- 속성명 변경 : RadioForeColor, ForeColor → RadioOutlineColor, TextColor

• 변경 전
  
• 변경 후
  

SmartListBox +

※ Old ver.에서는 구분자를 이용해 컬럼을 구분했지만, New ver.은 컬럼 개념이 명확해져 인덱스로 각 컬럼에 직접 접근할 수 있습니다.
- 컬럼 스타일 맞추기 : 구분자 사용 → 직접 컬럼에 접근 가능

• 변경 전

  int[] iColumnos = new int[2];
  iColumnos[0] = 82;
  iColumnos[1] = 301;
  
  smartListBox1.ColumnAlign = SmartX.SmartListBox.COLUMNALIGNS.CENTER;
  smartListBox1.ColumnOffsets = iColumnos;
  smartListBox1.ColumnDelimiter = "\t";
  
  
  
  
  
  
  

• 변경 후

  SmartX. SmartListBox.COLUMNSTYLE[] csColumnStyle = new SmartX.SmartListBox.COLUMNSTYLE[2];
  
  csColumnStyle[0].iColumnWidth = 82;
  csColumnStyle[0].eColumnAlign = SmartX.SmartListBox.COLUMNALIGNS.CENTER;
  csColumnStyle[0].iOffsetColumn = 40;
  
  csColumnStyle[1].iColumnWidth = 301;
  csColumnStyle[1].eColumnAlign = SmartX.SmartListBox.COLUMNALIGNS.CENTER;
  csColumnStyle[1].iOffsetColumn = 65;
  
  smartListBox1.ColumnStyles = csColumnStyle;
  

- 원하는 컬럼 값 가져오기 : Old 버전과 같은 방식으로 사용하려면 행 전체 문자열을 가져오되, 자동 삽입되는 \n 구분자를 고려해야 합니다.

[한 줄(행)씩 읽어오는 방법]

• 변경 전

  strNewFile = smartListBox1.Items[i];
  
  

• 변경 후

  strNewFile = smartListBox1.GetItemColumnText(i, 0) + "\t" + smartListBox1.GetItemColumnText(i, 1);

[Old 버전과 동일한 방법으로 사용하고 싶은 경우의 변경 후]

string raw = smartListBox1.Items[i];
string[] parts = raw.Split('\n');
strNewFile = parts[0] + "\t" + parts[1];

[Column Item 하나씩 읽어오는 방법]

• 변경 전

  string row = smartListBox1.Items[i];
  string[] parts = raw.Split('\t');
  
  string column0 = parts.Length > 0 ? parts[0] : "";
  string column1 = parts.Length > 1 ? parts[1] : "";

• 변경 후

  string column0 = smartListBox1.GetItemColumnText(i, 0);
  string column1 = smartListBox1.GetItemColumnText(i, 1);
  
  
  
  

SmartComboBox +

- 속성명 변경 : ItemListSelectItemIndex → SelesctItemIndex

• 변경 전

  m_iportSelect = comboPortNo.ItemListSelectltemIndex;

• 변경 후

  m_iportSelect = comboPortNo.SelectItemIndex;

SmartUpDown +

- 최대/최소값 설정 속성 통합 : fMaxValue, fMinValue (실수형 decimal) + MaxValue, MinValue (정수형 long)
→ Maximum, Minimum (실수와 정수 모두 설정 가능 decimal - 실수로 설정 시 Format String 값 설정 필수)
- 속성명 변경 : LabelTextArray → Items
- 속성명 변경 : TxtValue → ValueItems

• 변경 전

  m_strUpdown = smartUpDown1.TxtValue;

• 변경 후

  m_strUpdown = smartUpDown1.Valueltems;

SmartGroupBox +

- 속성명 변경 : Image → BackImage

SmartKeyboard +

- 메서드 삭제 : LableClear() (Old 버전에 경우 버퍼에 저장된 Text가 지워지지 않아 SmartKeyboard를 통해 Text 입력 시 기존의 Text에 새로 입력한 Text가 추가 되었지만 최신 버전에서 개선되어 해당 메서드는 삭제되었습니다.)

SmartKeyPad +

- 메서드 삭제 : LableClear() (Old 버전에 경우 버퍼에 저장된 Text가 지워지지 않아 SmartKeyboard를 통해 Text 입력 시 기존의 Text에 새로 입력한 Text가 추가 되었지만 최신 버전에서 개선되어 해당 메서드는 삭제되었습니다.)
- 속성명 변경 : SmartX.SmartKeyPad.KeyCode → SmartX.SmartKeyPad.KeyItemInfos.KeyCode

• 변경 전

  SmartKeyPad. KeyCode.A

• 변경 후

  SmartKeyPad_KeyPadItemInfos. Keycode.A

SmartPictureBox +

새로 추가된 인터페이스. SmartDraw에서 단순 이미지 관련 처리는 모두 SmartPictureBox로 변경해서 사용

• 변경 전

  smartDraw2.AddImageList(Resource1.Layer1);
  smartDraw2.AddImageList(Resource1.Layer2);
  smartDraw2.AddImageList(Resource1.Layer3);
  smartDraw2.AddImageList(Resource1.Layer4);
  smartDraw2.AddImageList(Resource1.Layer5);
  smartDraw2.AddImageList(Resource1.Layer6);
  smartDraw2.AddImageList(Resource1.Layer7);
  smartDraw2.AddImageList(Resource1.Layer8);

• 변경 후

  smartPictureBox2.AddImageList(Resource1.Layer1);
  smartPictureBox2.AddImageList(Resource1.Layer2);
  smartPictureBox2.AddImageList(Resource1.Layer3);
  smartPictureBox2.AddImageList(Resource1.Layer4);
  smartPictureBox2.AddImageList(Resource1.Layer5);
  smartPictureBox2.AddImageList(Resource1.Layer6);
  smartPictureBox2.AddImageList(Resource1.Layer7);
  smartPictureBox2.AddImageList(Resource1.Layer8);

SmartDraw +

[Chart 관련]
ChartChannelPenstyle는 기존 코드에서만 수정이 가능 했지만 폼 디자이너에서도 설정 할 수 있게 바뀌었다. 코드가 매우 간결해지고 수정이 간편해 폼 디자이너 사용을 적극 권장합니다.

• 변경 전

  SmartX.SmartDraw.CHARTREFRESH chartRefreshType = SmartX.SmartDraw.CHARTREFRESH.LEFTSCROLL;
  SmartX.SmartDraw.CHARTPENSTYLE[] chartchPenStyle = new SmartX.SmartDraw.CHARTPENSTYLE[1];
  
  chartchPenStyle[0].m_chColor = Color.Yellow;
  chartchPenStyle[0].m_iPenWidth = 2;
  
  chartchPenStyle[2].m_chColor = Color.Red;
  chartchPenStyle[2].m_iPenWidth = 1;
  
  smartDraw1.ChartChannelPenStyle = chartchPenStyle;
  
  smartDraw1.SetChartCfg(10, 260, 630, 270, 3, chartRefreshType, 2);
  

• 변경 후

  SmartX.SmartDraw.ChartRefresh chartRefreshType = SmartX.SmartDraw.ChartRefresh.LEFTSCROLL;
  SmartX.SmartDraw_ChartChannelPenStyle.
  ChartPenStyle[] cChartPenStyle = new
  SmartX.SmartDraw_ChartChannelPenStyle.
  ChartPenStyle[1];
  
  cChartPenStyle[0].ChannelColor = Color.Yellow;
  cChartPenStyle[0].PenWidth = 2;
  cChartPenStyle[1].ChannelColor = Color.Red;
  cChartPenStyle[1].PenWidth = 1;
  
  smartDraw1.Chart.ChartChannelPenStyle = smartDraw_ChartChannelPenStyle1;
  smartDraw1.Chart.SetChartConfig(10, 260, 630, 270, 3, chartRefreshType);
  
  

[이미지 관련, 속성명 변경]
단순 이미지 관련 처리는 새로 추가된 SmartPictureBox로 변경해서 사용

• 변경 전

  drawStressMode.SetBackimage = Resource1.t_1;

• 변경 후

  picboxStressMode.Image = Recource1.t_1;

- 속성명 변경
BackDraw → BackLayer
SlideShowStart, SlideShowStop → SmartPictureBox 의 Play, Stop

SmartProgressBar +

속성명 변경 : ForeColor → TextColor

SmartCheckBox +

속성명 변경 : ForeColor → TextColor

SmartTrackBar +

속성명 변경 : Step → StepRange

SmartGPIO +

구버전 SmartGPIO는 하나의 컴포넌트로 모든 포트를 설정 했지만 최신버전의 SmartGPIO는 컴포넌트 하나에 원하는 포트 하나만 사용가능하게 변경됐습니다. 따라서 속성 뒤에 붙은 포트의 이름이 사라졌고 PortSelect 속성을 이용해 제어할 포트 하나만 설정합니다.

• 변경 전

  smartGPIO1.PORTADIRS = iPortDir;
  
  

• 변경 후

  smartGPIO1.PortSelect = SmartX.SamrtGPIO.PORTID.PORTA;
  smartGPIO1.PortDirs = iPortDir;

SmartADC +

FilteringEnable 속성 삭제 (원래 있던 ReadDataDetailFiltering 메서드로 대체 되었습니다.)
[사용 방법]
ReadDataDetailFiltering(int ich, int iRawdataCnt, int iRawdataCnt * 0.6)

SmartSerialPort +

변경사항 없음

SmartModbus +

ReadCoilStatus, ReadInputStatus, ReadHoldingRegister, ReadInputRegister 의 코일, 레지스터 단위의 응답 데이터 ref → out 응답 데이터 파라미터가 ref에서 out으로 변경되어, 메서드 호출 시 new로 객체를 생성하지 않아도 됩니다.

SmartModbusSlave +

변경사항 없음

SmartTCPMultiServer +

변경사항 없음

SmartTCPClient +

변경사항 없음

SmartSplash +

- SmartSplash에 포함된 내부 이미지 이름 변경

참고홈페이지(www.smartx.co.kr) > Reference Guide > Part 4 > 13. SmartSplash 참고하시기 바랍니다.

• 변경 전

  smartSplash1 = new SmartX.SmartSplash();
  smartSplash1.AnimationInterval = 300;
  smartSplash1.LoadingImagePathname = "SmartLoading1";
  smartSplash1.Start();
  
  smartSplash1.Finsh();
  

• 변경 후

  SmartX.SmartSplash.Start(SmartX.SmartSplash.
  BuiltInLoadingImages.LOADING2_MEDIUM, 300);
  
  SmartX.SmartSplash.Finish();
  
  
  

- Splash Loading 애니메이션 출력 관련 처리 속성 사용 변경 , Start, Finish 정적 메서드로 변경

• 변경 전

  smartSplash1.Finish();

• 변경 후

  SmartX.SmartSplash.Finish();

SmartUpdate +

속성명 변경 : SetStartInterval → UpdateStartInterval

SmartFile +

- FileSearch 정적 메서드로 변경됨.

• 변경 전

  FSEARCHFILEINFOS[] ffoundFileList =
  smartFile1.FileSearch(strFileRoot, "*.txt", False);

• 변경 후

  SmartX.SmartFile.SEARCHFILEINFOS[] foundFileList =
  SmartX.SmartFile.FileSearch(strFileRoot, "*.txt", False);

- 앞에 파일 타입을 붙이는 형식으로 변경 됨

기능	Old	최신
파일의 데이터 개수 읽기	GetCount	파일 형식(StringType, BinaryType, StructType).GetCount
파일 쓰기, 파일 읽기	Read / Write + 파일 형식(String, Structure)	파일 형식(StringType, BinaryType, StructType).Read / .Write
일괄(버퍼) 파일 쓰기	Write + 파일 형식 (String, Structure)_Begin / _End	파일 형식(StringType, StructType).WriteBuffer / .WriteBufferSave
일괄(버퍼) 파일 읽기	Read + 파일 형식 (String, Structure) + AllBuffer	파일 형식(StringType, StructType).FillBuffe

• 변경 전

  iCount = Convert.ToInt32(smartFile.GetCount());
  
  smartFile1.WriteString(strAddList);
  smartFile1.WriteString_Begin(strNewFile);
  smartFile1.WriteString_End();
  smartFile1.ReadStringAllBuffer();
  smartFile1.ReadStringBuffer(i);

• 변경 후

  iCount = Convert.ToInt32(smartFile.StringType.GetCount());
  
  smartFile1.StringType.Write(strAddList);
  smartFile1.StringType.WriteBuffer(strNewFile);
  smartFile1.StringType.WriteBufferSave();
  smartFile1.StringType.FillBuffer(i);
  smartFile1.StringType.ReadBuffer(i);

SmartTimer +

StartTime, EndTime → TimeCount, CounterMode 속성으로 대체

• 변경 전

  // StartTime속성 값이 Endtime값보다 크면 Down-Timer 동작모드
  smartTimer1.StartTime = 180000; // 3분
  smartTimer1.EndTime = 0;
  
  

• 변경 후

  // StartTime속성 값이 Endtime값보다 크면 Down-Timer 동작모드
  smartTimer1.CounterMode = SmartX.SmartTimer.CounterModes.Down_Counter;
  smartTimer1.EndCount = 0;
  

NowFormatTime,NowFormatTimes 메서드 삭제 → GetNowTimeFormatString, GetNowTimeFormat 메서드로 대체
NowIncMillisecond 메서드 삭제
NowMillisecond 메서드 삭제 → RunningTime 속성으로 대체
SetNowMillisecondDec, SetNowMillisecondInc → SetTimeCount 메서드로 대체

• 1) Old 버전 컴포넌트의 이벤트 이름확인
• 2) New 버전 컴포넌트에서 동일한 명의 이벤트 찾기
• 3) New 버전 컴포넌트 이벤트 연결확인

[이벤트 별 변경 사항에 대한 표]