Pivot Zaman çizelgeleri ve Slicer veri durumları

Sürüm 2.384.98'den itibaren XLSX çalışma kitabı cephesi üzerinden desteklenen yerel non-OLAP PivotTable'lar için kullanılabilir

Zaman çizelgesi oluşturma ve bağlama

TimelineCache := Workbook.CreatePivotTimelineCache(Pivot, 'EventDate');
if TimelineCache = nil then
  raise Exception.Create('The Timeline cache was rejected');
TimelineView := ReportSheet.Timelines.Add(TimelineCache, 2, 7, 7, 12);
if TimelineView = nil then
  raise Exception.Create('The Timeline view was rejected');
if TimelineCache.SetDateRange(EncodeDate(2026, 1, 1),
    EncodeDate(2026, 1, 31)) < 0 then
  raise Exception.Create('The Timeline selection was rejected');

TXLSXWorkbook.CreatePivotTimelineCache(ATable: TXLSPivotTable; const AFieldName: WideString): TXLSXTimelineCache, doğrulanmış bir tarih alanı önbelleğini ve gereken paket kimliklerini oluşturur ya da yeniden kullanır; başarısızlık, hazırlanmış durumu işlemeden nil döndürür

TXLSXWorkbook.TimelineCaches; Count, sıfır tabanlı Items[Index] ve büyük/küçük harfe duyarsız FindByName içeren TXLSXTimelineCaches koleksiyonunu açığa çıkarır; bu önbelleklerin sahibi çalışma kitabıdır

TXLSXTimelineCache.Name önbelleği tanımlar, SourceName kaynak alanını tanımlar ve IsNonOlapPivot doğrulanmış desteklenen bağlamayı tanımlar; alınmış desteklenmeyen önbellekler özgün XML'lerini korur

TXLSXTimelineCache.ConnectPivotTable(ATable: TXLSPivotTable): Integer, uyumlu tarih alanlı aynı PivotCache'in başka bir sahipli görünümünü bağlar; mevcut bir bağlantı dahil başarı için 1, reddedilme için -1 döndürür

TXLSXTimelineCache.SetDateRange(AStartDate, AEndDate: TDateTime): Integer kapsayıcı tam gün uçlarını kullanır ve 1 ya da -1 döndürür; uçlar, 1 Ocak 1900 ile 31 Aralık 9999 arasından artan sırada tam tarihler olmalıdır

Desteklenen çalışma kitabı 1900 tarih sistemini kullanır; Date1904 yazımı ve kesirli seçim uçları reddedilir; kaynak tarih değerleri günün saatini koruyabilir ve seçilen son gün boyunca kayıtlar uygun sayılır

TXLSXTimelineCache.SelectionActive, StartDate ve EndDate etkin sınırları açığa çıkarır; ClearSelection: Integer bunları diğer filtreleri değiştirmeden temizler ve 1 ya da -1 döndürür

Seçimler; diğer Slicer'lar, elle ya da sayfa filtreleri ve çağıranın yüklemleriyle kesişir; bu işlemler kaynak önbelleklerini yenilemez, formülleri yeniden hesaplamaz ya da mevcut çalışma sayfası rapor hücrelerini yeniden yazmaz

Zaman çizelgesi görünümleri ve kaldırma

TXLSXWorksheet.Timelines, çalışma sayfasının sahibi olduğu TXLSXTimelines koleksiyonunu açığa çıkarır; Add, FindByName, sıfır tabanlı Items[Index], Count, Delete(Index) ve Clear içerir; silme, paylaşılan önbelleği ve seçimi korurken arayüzü kaldırır

TXLSXTimelines.Add(ACache: TXLSXTimelineCache; ARow1, ACol1, ARow2, ACol2: Integer): TXLSXTimeline, sahiplenilmiş desteklenen bir önbelleği ve sıralı 1 tabanlı bir çalışma sayfası dikdörtgenini kabul eder; sahiplenilmiş bir görünüm ya da nil döndürür

TXLSXTimeline.Name salt okunurdur, Cache paylaşılan önbelleğini tanımlar ve Caption görüntülenen etiketi değiştirir; Level; yıllar için 0, çeyrekler için 1, aylar için 2 ya da günler için 3 kabul eder

TXLSXTimeline.SetBounds, FromRow, FromCol, ToRow ve ToCol tarafından açığa çıkarılan 1 tabanlı dikdörtgeni değiştirir; geçersiz geometri, desteklenmeyen bağlamalar ya da gruplanmış çizim geometrisi değişiklikten önce fırlatır

TXLSXDrawingObject.Timeline, xlsxDrawingTimeline çizim türü için ilişkili görünümü döndürür; doğrudan desteklenmeyen çizim dönüşümleri korumalı kalır

Status := Workbook.RemoveTimelineCache(TimelineCache,
  xlsxSlicerPreserveCurrentSelection);

TXLSXWorkbook.RemoveTimelineCache(ACache: TXLSXTimelineCache; AMode: TXLSXSlicerRemovalMode): Integer; bağlı filtreleri, arayüzü, adları ve paket temizliğini birlikte hazırlar ve 1 ya da -1 döndürür

xlsxSlicerClearSelection seçimi kaldırır; xlsxSlicerPreserveCurrentSelection, etkin bir seçimi yalnızca tarih alanı her bağlı görünümde zaten bir satır ya da sütun eksenindeyken tam gün bir tarih karşılaştırması olarak korur

Kullanılmayan ya da yalnızca sayfalık bir tarih alanı, seçim koruyan kaldırmayı atomik olarak reddeder; o davranış isteniyorsa açık seçim temizleyen kaldırmayı kullanın

Alınmış filtreler yalnızca her bağlantı, devralınan ad alanı ve tam sahipli filtre kökeni doğrulandıktan sonra normalleştirilir; opak aynı-alan öznitelik ya da alt öğeleri, yabancı ad alanları, dış bağlamalar ve desteklenmeyen çoklu arayüz grafikleri XML'lerini korur ve değişikliği reddeder

Yerel somutlaştırma; güncel Zaman çizelgesi seçimini rapor üst verisiyle ve hücrelerle hazırlar ve yalnızca tam olarak kaydedilmiş sahipli filtre imzasını kaldırır; keyfi geri çağırı kısıtlamalarının yerel XML gösterimi yoktur ve Excel yenilemesi tarafından üretemez

OOXML kaydetme; yerel ilişki türlerini, özgün yolları ve ilgisiz uzantıları korur; Strict yalnızca önbellek kaydetme reddedilir, ODS dönüşümü Zaman çizelgesi kaybını bildirir ve XLSB değer-ve-stil alt kümesi Zaman çizelgelerini reddeder

Açık yerel Slicer veri durumu yenilemesi

function TXLSXSlicerCache.RefreshItemDataStates: Integer; overload;
function TXLSXSlicerCache.RefreshItemDataStates(
  AMaxEvaluationSteps: Integer; ACancelFlag: PBoolean = nil): Integer; overload;

İşlem, eksiksiz yerel veri yoksunu vektörünü değerlendirip hazırlar ve sonra bir çalışma kitabı yazma koruması altında işler; başarı 1 döndürür, reddedilme serileştirilmiş öğe bayraklarını ya da seçimleri değiştirmeden -1 döndürür

Bu Slicer'ın kendi seçimini yok sayarken; diğer Slicer ve Zaman çizelgesi seçimlerini, elle ya da sayfa filtrelerini, desteklenen toplama filtrelerini ve çağıranın yüklemlerini kesiştirir; kullanılabilirlik, desteklenen bağlı görünümler boyunca bir birleşimdir

Uygun kaydı olmayan seçili geçmiş üyeler, seçimlerini korurken yerel veri yoksunu bayrağını alır; kararlı önbellek kimlikleri, özgün öğe aktarım sırası ve ilgisiz XML eksiksiz kalır

Varsayılan kümülatif adım sınırı 1000000'dir; sıfır sınırsız adım demektir, negatif bir değer reddedilir ve FormulaArrayMemoryLimit, üst veri hazırlığını ve tüm bağlı görünüm önizlemelerini kümülatif olarak sınırlar

İptal, geri çağırı istisnaları ya da yeniden giriş, donmuş görünümler, desteklenmeyen bağlamalar, tükenen bütçeler ya da değişmiş değerlendirme durumu bayrakları işlemeden önce reddettirir; çağıranın geri çağrılarının yaptığı bağımsız ortak model değişiklikleri çağıranın değişikliği olarak kalır ve yenilemeyi reddettirir

TXLSXSlicerCache.CrossFilter, yerel tablosal çapraz filtre ayarını değişiklik koruması altında okur ve yazar; showItemsWithDataAtTop, öğe aktarım sırasını yeniden yazmadan yerel veri-öncelikli sıralamayı etkinleştirir

ItemHasData salt okunur bir sorgu olarak kalır; kaydetme, değerlendiriciyi çağırmaz ya da veri yoksunu bayraklarını örtükçe güncellemez; yerel arayüz durumunun yenilenmesi gerekiyorsa kaydetmeden önce RefreshItemDataStates'i açıkça çağırın

Gelişmiş tarih filtresi semantiği

TXLSPivotFilter.UseWholeDay, desteklenen tarih filtreleri için tam gün tarih karşılaştırmaları ister; Zaman çizelgesinin ürettiği korunan seçimler bunu kullanırken sıradan tarih filtreleri önceki saate duyarlı davranışlarını korur

Çevresindeki yenileme ve sahiplik sözleşmeleri için yerel Pivot çıktısı ve salt okunur Slicer kullanılabilirliği ile yerel önbellek ve Slicer yaşam döngüsü sayfalarına bakın