sgcEditors 기능 표
sgcEditors의 모든 기능을 작업별로 정리했으며, 각 기능의 도움말 항목으로 연결됩니다. 각 컨트롤은 VCL, FireMonkey, WinForms, WPF, Avalonia용으로 동일한 속성과 이벤트를 가지고 있습니다.
sgcEditors의 모든 기능을 작업별로 정리했으며, 각 기능의 도움말 항목으로 연결됩니다. 각 컨트롤은 VCL, FireMonkey, WinForms, WPF, Avalonia용으로 동일한 속성과 이벤트를 가지고 있습니다.
Registered 에디션은 Registered 에디션과 체험판 에디션에 포함되지만 무료 Community 에디션에는 없는 기능을 나타냅니다. ~는 Community에 일부만 포함된 기능이며, 차이점은 아래에 설명되어 있습니다.
모든 행은 해당 도움말 항목으로 연결됩니다. Community 열은 무료 .NET Community 에디션에 포함된 내용을 보여 주며, 모든 기능은 Registered와 체험판에 들어 있습니다.
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 월 달력 | 단일 날짜 또는 범위, MinDate와 MaxDate, 비활성화된 날짜와 요일, ISO 8601 주 번호, 월, 연도, 10년 단위 보기. | 도움말 | |
| 날짜 선택기 | 드롭다운 달력과 월 이름도 이해하는 유연한 파서를 갖춘 날짜 입력. | 도움말 | |
| 시간 선택기 | 네이티브 편집 컨트롤에서의 시간 입력. | 도움말 | |
| 날짜 및 시간 선택기 | 하나의 컨트롤에서 날짜와 시간을 입력합니다. | 도움말 | |
| 범위 슬라이더 | 슬라이더로 값 하나 또는 범위를 선택합니다. 두 번째 핸들은 Registered 에디션에 있습니다. | ~핸들 하나만 그려지고 편집되며, EndValue는 유지되지만 표시되지 않습니다. | 도움말 |
| 색상 선택기 | 색상을 고릅니다. HSV 사각형과 알파 막대는 Registered 에디션에 있습니다. | ~견본과 16진수만 제공하며 HSV 사각형과 알파 막대는 그려지지 않고 알파는 항상 $FF입니다. | 도움말 |
| 토큰 편집기 | 태그와 수신자를 위한 칩. 자동 완성 목록은 Registered 에디션에 있습니다. | ~칩, 유효성 검사, 제한은 동작하지만 자동 완성 목록은 열리지 않습니다. | 도움말 |
| 별점 | 별 모양 평점 입력. | 도움말 | |
| 스핀 편집기 | 마우스 휠과 자동 반복을 지원하는 숫자 입력. | 도움말 | |
| 버튼 편집기 | 찾아보기, 드롭다운, 검색, 지우기, 더하기, 빼기, 텍스트, 오너 드로우 버튼을 양쪽에 둘 수 있는 네이티브 편집기이며 버튼마다 단축키가 있습니다. 화면 읽기 프로그램이 모든 버튼을 나열하고 누를 수 있습니다. | 도움말 | |
| 검색 편집기 | 입력이 잠시 멈추면, 또는 Enter를 누르면 즉시 OnSearch가 발생하며, 검색 및 지우기 버튼과 이전 검색의 드롭다운 기록이 있습니다. | 도움말 | |
| 마스크 편집기 | Delphi EditMask 구문 또는 .NET MaskedTextBox 구문의 입력 마스크를 MaskSyntax로 선택하므로, 하나의 마스크가 Delphi와 .NET에서 똑같이 동작합니다. 불완전한 값은 유효성 검사기에 보고됩니다. | 도움말 | |
| 통화 편집기 | 정확한 Currency 값(.NET에서는 decimal)이며, 로케일의 통화 형식, 기호 또는 ISO 코드, 한도, 입력 중 그룹화를 지원합니다. | 도움말 | |
| 조회 편집기 | 선택적 머리글 행이 있는 다중 열 드롭다운이며 입력하는 대로 필터링되고 키 열과 표시 열이 있습니다. 행은 Items, OnGetItems에서 오며 .NET에서는 ItemsSource에서도 올 수 있습니다. | 도움말 | |
| 메모 | 자리 표시자, 선택적 한도가 있는 글자 수 카운터, 줄 수에 따라 변하는 높이를 갖춘 테마 적용 여러 줄 편집기입니다. | 도움말 | |
| 토글 스위치 | TsgcVCLToggleSwitch와 TsgcFMXToggleSwitch(TsgcWinFormsToggleSwitch, TsgcWpfToggleSwitch, TsgcAvaloniaToggleSwitch는 .NET)는 설정용 켜기와 끄기 스위치입니다. 약 150 ms 만에 새 상태로 미끄러지는 둥근 손잡이가 있는 둥근 트랙, 오른쪽 또는 왼쪽 캡션(CaptionPosition), 트랙 안의 켜짐과 꺼짐 텍스트(ShowText), ReadOnly, 기본적으로 테마를 따르는 트랙과 손잡이 색상을 갖췄습니다. OnChanging은 사용자의 변경을 취소하고, OnChange는 변경할 때마다 발생하며, Toggle은 사용자처럼 상태를 바꿉니다. 클릭, 손잡이 끌기, 스페이스, 왼쪽과 오른쪽 키, 오른쪽에서 왼쪽 표시, 화면 읽기 프로그램을 위한 Toggle 패턴이 있는 체크 박스를 지원합니다. Checked는 WPF와 Avalonia에서 양방향으로 바인딩됩니다. | 도움말 | |
| IP 주소 편집기 | TsgcVCLIPAddressEdit과 TsgcFMXIPAddressEdit(TsgcWinFormsIPAddressEdit, TsgcWpfIPAddressEdit, TsgcAvaloniaIPAddressEdit는 .NET)는 IPv4 또는 IPv6 주소(Mode)를 받습니다. IPv4는 입력하는 대로 다음으로 넘어가는 옥텟 필드 네 개를 보여 주고, 255를 넘는 값을 제한하며 포커스가 벗어날 때 빈 필드를 0으로 채웁니다. IPv6는 포커스가 벗어날 때 검증하여 RFC 5952 표준 형식으로 쓰는 텍스트 필드 하나입니다. Address, Octets, IsValid, 테마의 오류 테두리를 쓰는 Required, ReadOnly, Clear, OnChange를 제공합니다. 전체 주소 붙여넣기, 오른쪽에서 왼쪽 표시, 화면 읽기 프로그램을 위한 Value 패턴이 있는 편집기를 지원합니다. Address는 WPF와 Avalonia에서 양방향으로 바인딩됩니다. | 도움말 | |
| 시간 간격 편집기 | TsgcVCLTimeSpanEdit과 TsgcFMXTimeSpanEdit(TsgcWinFormsTimeSpanEdit, TsgcWpfTimeSpanEdit, TsgcAvaloniaTimeSpanEdit는 .NET)는 일부터 밀리초까지의 세그먼트(Segments)로 기간을 편집하며, 시계 형식 또는 단위 형식(DisplayFormat)으로 표시합니다. Value는 밀리초 단위(.NET에서는 TimeSpan)이며, MinValue, MaxValue, AllowNegative, Increment, 스핀 버튼용 ShowButtons, ReadOnly를 제공합니다. 입력, 위쪽과 아래쪽 키, PageUp과 PageDown, 휠, 스핀 버튼이 포커스가 있는 세그먼트를 다음 세그먼트로 올림하며 증감합니다. 화면 읽기 프로그램을 위한 RangeValue 패턴이 있는 스핀너입니다. Value는 WPF와 Avalonia에서 양방향으로 바인딩됩니다. | 도움말 | |
| 글꼴 선택기 | TsgcVCLFontPicker와 TsgcFMXFontPicker(TsgcWinFormsFontPicker, TsgcWpfFontPicker, TsgcAvaloniaFontPicker는 .NET)는 각 이름을 자기 글꼴로 그리는 드롭다운(ShowPreview, PreviewText)에서 글꼴 계열을 고르며, 사용자가 입력하는 대로 걸러집니다. FontName, 애플리케이션이 채우기 전까지 플랫폼에서 채워지는 Fonts, RefreshFonts, 최근에 고른 계열을 먼저 보여 주는 기능(RecentCount, RecentFonts), 고정폭 필터(FontFilter)를 제공합니다. Delphi의 미리보기 글꼴은 Windows에서 그려집니다. FontName은 WPF와 Avalonia에서 양방향으로 바인딩됩니다. | 도움말 | |
| 체크 목록 상자 | TsgcVCLCheckListBox와 TsgcFMXCheckListBox(TsgcWinFormsCheckListBox, TsgcWpfCheckListBox, TsgcAvaloniaCheckListBox는 .NET)는 행마다 체크 박스가 있는 Items를 나열합니다. Checked, 회색 상태(AllowGrayed)가 있는 State, 항목별 ItemEnabled를 제공합니다. 3상태 모두 선택 행(ShowCheckAll), 상태를 절대 바꾸지 않는 필터 상자(ShowFilter), CheckAll, UncheckAll, CheckedCount, OnChange 앞의 OnClickCheck가 있습니다. 화면에 보이는 행만 그리므로 10000개 항목도 빠릅니다. 스페이스, Ctrl+A, 문자를 눌러 이동, 화면 읽기 프로그램을 위한 Toggle 패턴이 있는 목록 항목을 지원합니다. | 도움말 | |
| 이중 목록 상자 | TsgcVCLDualListBox와 TsgcFMXDualListBox(TsgcWinFormsDualListBox, TsgcWpfDualListBox, TsgcAvaloniaDualListBox는 .NET)는 목록 사이의 버튼, 더블 클릭, 끌어서 놓기로 AvailableItems와 SelectedItems 사이에서 항목을 옮기고, 위쪽과 아래쪽 버튼(ShowReorderButtons)으로 SelectedItems의 순서를 바꿉니다. SortAvailable, ShowFilter, ShowCaptions, ReadOnly, MoveToSelected, MoveAllToSelected, MoveToAvailable, MoveAllToAvailable, MoveUp, MoveDown 메서드, 항목을 유지하는 OnMoving, 작업당 한 번 발생하는 OnChange를 제공합니다. 다중 선택, 키보드 이동, 오른쪽에서 왼쪽 표시를 지원합니다. SelectedItems는 WPF와 Avalonia에서 양방향으로 바인딩됩니다. | 도움말 | |
| 터치 패널용 NumPad | TsgcVCLNumPad는 폼에 도킹하는 화면 숫자 키패드이고, TsgcVCLNumPadPopup은 같은 패드를 대상 컨트롤 아래의 드롭다운으로 엽니다(FireMonkey에서는 TsgcFMXNumPad와 TsgcFMXNumPadPopup, .NET에서는 NumPad). 스핀 편집기, 통화 편집기, sgcGauges의 노브 및 슬라이더 게이지, 표준 편집 컨트롤에 입력하며, 대상은 Associate로 지정하거나 포커스가 있는 컨트롤에서 가져옵니다. 패드는 대상의 범위와 소수 자릿수를 읽고 값을 사용자 변경으로 기록하며, 손가락이나 장갑 낀 손으로도 누를 수 있을 만큼 큰 키를 갖추고 있습니다. | 도움말 | |
| 화상 키보드 | TsgcVCLKeyboard는 폼에 도킹하는 완전한 화상 키보드이고, TsgcVCLKeyboardPopup은 포커스를 받은 편집기 아래의 드롭다운으로 같은 키보드를 열며 AutoPopup, AutoPopupAll, PopupPosition, CloseOnEnter를 지원합니다(FireMonkey에서는 TsgcFMXKeyboard와 TsgcFMXKeyboardPopup, .NET에서는 TsgcWinFormsKeyboard, TsgcWpfKeyboard, TsgcAvaloniaKeyboard와 각 팝업). 포커스가 있는 컨트롤이나 Associate에 기록하며 포커스를 가져가지 않습니다. 문자, 기호, 숫자 페이지, Shift, Caps Lock, AltGr, 데드 키, 기본 제공 레이아웃 10종(en-US, en-GB, es-ES, fr-FR, de-DE, it-IT, pt-BR, nl-NL, pl-PL, tr-TR), sgcKeyboardRegisterLayout으로 만드는 사용자 레이아웃, Layouts를 순환하는 레이아웃 키, 테마, 오른쪽에서 왼쪽 표시, 접근성을 지원합니다. OnKeyText는 입력한 텍스트를 변경하거나 취소하고 OnEnterKey는 Enter 뒤에 실행됩니다. | 도움말 | |
| 레이아웃 컨트롤 | TsgcVCLLayoutControl과 TsgcFMXLayoutControl(.NET에서는 TsgcWinFormsLayoutControl, TsgcWpfLayoutControl, TsgcAvaloniaLayoutControl)은 sgcEditors 컨트롤과 표준 컨트롤 모두를 그룹, 탭 그룹, 열로 배치하며, 캡션을 하나의 너비로 맞추고, 사용자가 끌 수 있는 스플리터, 사용자가 숨길 수 있는 항목, 오른쪽에서 왼쪽 레이아웃을 지원합니다. 스크린 리더는 그룹과 탭을 인식합니다. 모든 에디션에 포함되며, Delphi Community에는 sgcEditors용 디자인 타임 패키지가 없으므로 그곳에서는 레이아웃 컨트롤을 코드로 생성합니다. | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 데이터 인식 편집기 | 날짜 선택기, 시간 선택기, 스핀 편집기, 별점, 범위 슬라이더, 버튼 편집기, 마스크 편집기, 통화 편집기, 메모, 조회 편집기는 DataSource와 DataField에 바인딩되며, 범위 슬라이더는 EndDataField에도 바인딩되고, 조회 편집기는 ListSource, KeyField, ListField를 통해 두 번째 데이터셋에서 목록을 채웁니다. Null 필드는 비어 있는 것으로 표시됩니다. Delphi와 C++ Builder용입니다. | Registered 에디션 | 도움말 |
| WinForms 데이터 바인딩 | WinForms의 날짜 및 시간 선택기, 스핀 편집기, 별점, 범위 슬라이더와 버튼, 마스크, 통화, 조회, 메모 편집기는 DataSource, DataMember, DataField를 통해 필드에 바인딩됩니다. BindingSource, DataTable, DataView, List를 사용할 수 있습니다. | Registered 에디션 | 도움말 |
| 모든 컬렉션에서 가져오는 조회 목록 | ItemsSource, DisplayMember, ValueMember가 WinForms, WPF, Avalonia에서 조회 편집기를 채우며, SelectedValue와 SelectedItem은 형식이 있는 객체를 반환합니다. | 도움말 | |
| 유효성 검사 | sgcUICore의 유효성 검사기는 sgcEditors 컨트롤과 표준 컨트롤을 필수, 범위, 길이, 정규식, 이메일, 비교, 사용자 지정 규칙에 따라 검사하며, 테두리, 아이콘, 요약 목록, 접근 가능한 메시지를 제공하고 VCL, FireMonkey, WinForms, WPF, Avalonia에서 동작합니다. .NET에서는 IDataErrorInfo와 INotifyDataErrorInfo 오류도 보여 줍니다. | 도움말 | |
| 스마트 붙여넣기 | 월 달력, 날짜, 시간, 날짜 및 시간 선택기, 스핀 편집기, 별점, 토큰 편집기, 색상 선택기, 버튼, 마스크, 통화, 조회 편집기, 메모가 스마트 붙여넣기에 참여합니다. TsgcVCLSmartPaste와 TsgcFMXSmartPaste(.NET에서는 TsgcWinFormsSmartPaste, TsgcWpfSmartPaste, TsgcAvaloniaSmartPaste)는 이메일이나 주소 블록 같은 붙여넣은 텍스트를 폼 컨트롤의 값으로 바꿉니다. sgcEditors 컨트롤과 표준 편집, 콤보, 체크 박스, 날짜 컨트롤 모두 해당하며, 실행 취소와 스마트 붙여넣기 버튼도 있습니다. AI 공급자에는 붙여넣은 텍스트와 필드 설명만 전송되며, 공급자가 없으면 로컬 파서가 Name: value 같은 줄을 읽습니다. | 도움말 | |
| 데이터 폼 생성기 | TsgcVCLDataForm과 TsgcFMXDataForm은 레이아웃 컨트롤 위에 완전한 편집 폼을 만듭니다. TDataSet에서는 필드마다 형식에 맞는 sgcEditors 컨트롤 하나를 고르고, 클래스에서는 RTTI와 BindObject로 published 속성을 사용합니다. .NET에서는 TsgcWinFormsDataForm, TsgcWpfDataForm, TsgcAvaloniaDataForm이 DataTable, DataView, 목록 또는 단일 객체를 받습니다. Fields는 각 필드의 캡션, 종류, 그룹, 탭, 순서를 정하며, 내비게이터는 처음, 이전, 다음, 마지막, 새로 만들기, 편집, 삭제, 저장, 취소를 제공합니다. Delphi, C++ Builder, .NET. | Registered 에디션 | 도움말 |
| 데이터 폼 유효성 검사 | 모든 필드는 sgcUICore 유효성 검사기의 규칙이 됩니다. 필수, 범위, 길이, 정규식, 이메일이 있으며, 직접 만든 검사에는 OnValidateField를 사용합니다. Post는 먼저 레코드를 검사하고, 요약이 오류를 나열하며, 보이지 않는 탭에 있는 잘못된 필드는 그 탭을 선택합니다. | Registered 에디션 | 도움말 |
| 데이터 폼 스마트 붙여넣기 | SmartPaste, SmartPasteAsync, SmartPasteFromClipboard(내비게이터의 버튼으로도 제공)는 편집기가 자체 스마트 붙여넣기에 쓰는 AI 계층을 통해, 붙여넣은 텍스트로 레코드의 모든 필드를 채웁니다. 채워진 필드에는 AI 배지가 표시되고, SmartPasteUndo는 이전 값을 되돌립니다. 공급자가 없으면 로컬 파서가 Name: value 같은 줄을 읽습니다. | Registered 에디션 | 도움말 |
| JSON으로 저장하는 레이아웃 | SaveLayout과 LoadLayout은 모든 항목의 순서, 부모, 크기, 표시 여부와 각 탭 그룹의 활성 탭, 사용자가 숨긴 항목을 JSON으로 문자열, 스트림 또는 파일에 보관합니다. 이전 빌드에서 저장한 레이아웃도 새 빌드에서 불러올 수 있습니다. | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 실제 텍스트 입력 | 날짜, 시간, 숫자, 16진수 필드가 네이티브 편집 컨트롤이므로 IME, 클립보드, 실행 취소, 화면 읽기 프로그램이 동작합니다. | 도움말 | |
| 현지화 | 각 컨트롤이 자체 로캘을 가집니다. 요일과 월 이름, 형식, 한 주의 시작 요일, 컨트롤별 FormatSettings. | 도움말 | |
| 키보드 | 드롭다운은 F4 또는 Alt+Down, 달력에서는 방향키와 PageUp, PageDown, 스핀 편집기에서는 마우스 휠과 자동 반복, 편집 버튼마다 단축키, 포커스 링. | 도움말 | |
| 모니터별 DPI | 96 DPI 논리 픽셀로 레이아웃을 구성하고 모니터별로 확대하며, 드롭다운은 해당 모니터의 DPI로 그려집니다. | 도움말 | |
| 오른쪽에서 왼쪽 (아랍어와 히브리어) | 스핀, 드롭다운, 지우기 버튼이 반대쪽으로 이동하고, 슬라이더와 평점의 방향, 캘린더의 요일 순서, 화살표, 토큰 배치가 미러링되며, 내부 편집 필드도 같은 방향을 갖습니다. | 도움말 | |
| 화면 읽기 프로그램과 고대비 | 모든 편집기가 역할, 이름, 값을 UI Automation에 노출하며, 복합 편집기의 부분(날짜 부분, 토큰, 평점 별, 색, 편집 버튼, 조회 목록)과 열려 있는 동안의 팝업도 함께 노출하고, 잘못된 필드는 상태와 오류 메시지를 보고합니다. 포커스 링은 항상 보이며 Windows 고대비를 따릅니다. Delphi 7~13의 VCL, Windows의 FireMonkey, WinForms, WPF, Avalonia에서 기본으로 켜져 있습니다. | 도움말 |
| 작업 | 기본 Delphi 컨트롤 | sgcEditors |
|---|---|---|
| 드롭다운에서 날짜 또는 시간 선택 | TDateTimePicker | TsgcVCLDatePicker, TsgcVCLTimePicker |
| 하나의 컨트롤에서 날짜와 시간 | TDateTimePicker | TsgcVCLDateTimePicker |
| 최대 길이가 있는 날짜 범위 선택 | TMonthCalendar | esmRange, MaxRangeDays |
| 개별 날짜와 요일 차단 | TMonthCalendar | DisabledDates, DisabledWeekDays, OnIsDateDisabled |
| 컨트롤별 로케일 | TDateTimePicker | FormatSettings |
| Delphi 또는 .NET 마스크 구문으로 마스크 입력 | TMaskEdit | TsgcVCLMaskEdit, MaskSyntax |
| 다중 열 목록에서 행 선택 | TDBLookupComboBox | TsgcVCLLookupEdit, TsgcVCLDBLookupEdit |
| 버튼이 있는 편집기 | TButtonedEdit | TsgcVCLButtonEdit |
| 터치 패널에서 숫자 입력 | TTouchKeyboard | TsgcVCLNumPad, TsgcVCLNumPadPopup |
| 터치 스크린에서 텍스트 입력 | TTouchKeyboard | TsgcVCLKeyboard, TsgcVCLKeyboardPopup |
| 설정용 켜기와 끄기 스위치 | TToggleSwitch | TsgcVCLToggleSwitch |
| IPv4 또는 IPv6 주소 편집 | TMaskEdit | TsgcVCLIPAddressEdit |
| 타임아웃 같은 기간 입력 | TSpinEdit | TsgcVCLTimeSpanEdit |
| 미리보기와 함께 글꼴 계열 선택 | TComboBox와 Screen.Fonts, TFontDialog | TsgcVCLFontPicker |
| 체크 박스가 있는 옵션 목록 | TCheckListBox | TsgcVCLCheckListBox |
| 두 목록 사이에서 항목 이동 | TListBox 두 개와 버튼 | TsgcVCLDualListBox |
도움말에 문서화된 기능만 비교하며, 성능에 대한 주장은 포함하지 않습니다.
.NET 편집기는 동일한 이름과 이벤트를 가진 C# 포트이며 WinForms, WPF, Avalonia를 지원합니다. WPF에서는 값 속성이 양방향으로 바인딩되는 종속성 속성입니다. 조회 편집기는 모든 호스트에서 ItemsSource, DisplayMember, ValueMember를 받고, Registered 에디션에서는 WinForms 편집기가 DataSource, DataMember, DataField를 통해 필드에 바인딩됩니다.
| 패키지 | 에디션 | 내용 |
|---|---|---|
esegece.sgcEditors.Community | Community (무료) | 코어 라이브러리 |
esegece.sgcEditors.WinForms.Community | Community (무료) | Windows Forms 컨트롤 |
esegece.sgcEditors.Wpf.Community | Community (무료) | WPF 컨트롤 |
esegece.sgcEditors.Avalonia.Community | Community (무료) | Avalonia 컨트롤 |
esegece.sgcEditors.Rendering.Community | Community (무료) | 헤드리스 렌더링 |
esegece.sgcEditors | Registered 에디션 | 코어 라이브러리 |
esegece.sgcEditors.WinForms | Registered 에디션 | Windows Forms 컨트롤 |
esegece.sgcEditors.Wpf | Registered 에디션 | WPF 컨트롤 |
esegece.sgcEditors.Avalonia | Registered 에디션 | Avalonia 컨트롤 |
esegece.sgcEditors.Rendering | Registered 에디션 | 헤드리스 렌더링 |
sgcEditors의 모든 기능은 sgcUI 도움말에 문서화되어 있으며, 개발 환경별로 별도의 도움말이 제공됩니다.
sgcUI 전체 도움말을 PDF 파일로 제공하며, 오프라인으로 읽거나 인쇄할 수 있습니다.
Delphi (PDF) →