CreateLoadedCellCursor 메서드

로드된 클래식 XLS 통합 문서에 저장된 셀에 대한 풀 커서를, 독립적으로 스타일이 지정된 빈 셀을 포함하는 옵션과 함께 만듭니다

구문

function CreateLoadedCellCursor: IXLSLoadedCellCursor; overload;
function CreateLoadedCellCursor(
  AIncludeStoredBlanks: Boolean): IXLSLoadedCellCursor; overload;

순회 순서 및 비용

커서는 워크시트를 컬렉션 순서로 방문한 다음 셀을 행과 열의 오름차순으로 방문합니다

SheetIndex, Row및 Col 은 1부터 시작하는 공용 좌표입니다

순회는 할당된 클래식 스파스 저장소 분기를 직접 따르므로 커서 상태는 일정하게 유지되며 워크시트의 행 또는 열 한도 크기의 배열을 할당하지 않습니다

매개변수 없는 오버로드는 빈 셀을 건너뛰고 기존의 값 및 수식 순회 계약을 유지합니다

셀 XF가 상속된 행, 열 또는 워크시트 서식과 다른, 저장된 스타일 빈 셀을 포함하려면 True 를 전달합니다

상속된 서식만으로는 빈 좌표가 실체화되거나 내보내지지 않습니다

스냅샷 필드

Strings and Variants in TXLSLoadedCellSnapshot 의 문자열과 Variant는 소유된 값이며 내부 셀 개체를 노출하지 않습니다

수식 셀의 경우 Value 는 클래식 통합 문서의 일반 값 접근 의미 체계를 따르며 필요한 경우 계산이 포함됩니다

For xlckBlank의 경우 Value 는 Unassigned이고 Formula 는 비어 있으며, StyleIndex 가 저장된 셀 XF를 식별합니다

상태 및 무효화

State 는 첫 번째 TXLSLoadedCellCursorState가 성공할 때까지는 xlccBeforeFirst , MoveNext를 사용할 수 있는 동안은 xlccActive , 순회가 완료된 후에는 Current 입니다 xlccEof after traversal completes

첫 번째 셀 이전이나 EOF 이후에 Current 를 읽으면 EXLSLoadedCellCursorState

저장된 셀 생성 또는 삭제, 워크시트 추가, 삭제, 이동 또는 통합 문서 모델 교체는 커서를 무효화합니다

이후의 MoveNext 또는 Current 호출은 EXLSLoadedCellCursorInvalidated

기존 셀의 값, 수식 또는 서식을 변경해도 커서는 무효화되지 않으며, 이미 캡처된 스냅샷은 변경되지 않고 유지됩니다

예제

Cursor := Workbook.CreateLoadedCellCursor;
while Cursor.MoveNext do
begin
  Cell := Cursor.Current;
  Memo1.Lines.Add(Format('%s!R%dC%d = %s',
    [Cell.SheetName, Cell.Row, Cell.Col, VarToStr(Cell.Value)]));
end;

참고 항목

• IXLSWorkbook 인터페이스
• 로드된 통합 문서 구조 세대
• TXLSWorksheet.ForEachCell 메서드