HotXLS Belgeleri

Gelişmiş XLSX API üyeleri

Bu üyeler, birincil çalışma kitabı, çalışma sayfası, aralık, stil, filtre ve grafik başvuru sayfalarını tamamlayan daha az yaygın ancak genel XLSX düzenleme yüzeylerini kapsar

Çalışma sayfası bölmeleri, görünüm ve arka plan

TXLSXWorksheet.SplitPanes ve RemoveSplit, bölünmüş bölme durumunu düzenler; SplitRow, SplitCol, PaneStateKind ve ScrollCol, saklanan görünüm koordinatlarını açığa çıkarır

DisplayRowColHeaders satır ve sütun başlıklarını denetler, GridLinesSet açık bir kılavuz çizgisi seçimini varsayılandan ayırt eder ve DefaultFormat ile StyleOverlays, sayfa düzeyinde stil durumunu açığa çıkarır

BackgroundImageData ve BackgroundImageFormat, çalışma sayfası arka plan görüntüsünü açığa çıkarır, BackgroundImageResource arka uca bağlı olmayan salt okunur bir yük ve biçim açıklaması sağlar, ClearBackgroundImage ise onu kaldırır

Bölme seçimleri ve kaydırma

GetSelectedAreas ve bölme öncelikli SelectAreas aşırı yüklemesi, paylaşılan TXLSPanePosition türünü kullanır, sıralı ve üst üste binen A1 aralıklarını korur ve etkin alan indeksiyle birlikte çağıranın sahipliğindeki anlık görüntüleri döndürür

Tüm satır ve tüm sütunu kapsayan yapısal düzenlemeler her bölme seçimini yeniden eşler; kalan sırayı ve etkin alan kimliğini korur ve etkin alan kaldırıldığında belirleyici halef, öncül ya da sınır hücre yedeklerini (fallback) kullanır

Seçim normalleştirme, yapısal yeniden eşleme ve anlık görüntü oluşturma; geniş alanların amortize-lineer işlenmesi için tek geçişli oluşturucular ve geometrik kapasite büyümesi kullanır

TryGetWindowScroll ve ScrollWindow, genel sheetView ile alt ya da sağ pane kaydırma konumlarını bağımsız tutarken aynı mantıksal bölmeleri ve 1 tabanlı koordinatları kullanır

Eksik bölmeler ve geçersiz güncellemeler çalışma sayfasını değiştirmez; bkz. Çalışma sayfası bölme seçimleri ve kaydırma

Sayfalama birlikte-tutma aralıkları

KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether ve KeepTogetherCount, geometri izin verdiğinde tek bir sayfada kalması gereken blokları tanımlar

BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow ve KeepColBlockBreakCol, önerilen sayfa sonlarının bu bloklarla nasıl etkileştiğini inceler

Çalışma sayfası düzenleme yardımcıları

AddImagePair, SVG ve PNG gibi bir birincil görüntü ile fallback eşini yazar, AddChartFromRanges, türlenmiş kategori ve değer aralıklarından bir grafik oluşturur ve CheckDataValidations ihlal eden her hücreyi döndürür

CheckDataValidation, bir hücreyi kapsayan her doğrulama kuralına karşı tek bir aday değeri sınar; geçerliyse -1, aksi hâlde ilk başarısız kuralın 1 tabanlı indeksini döndürür ve isteğe bağlı olarak yalnızca geçerli adayı kaydeder

GetCellVisibleFormat, boş bir hücre oluşturmadan etkin çalışma sayfası, satır, sütun, aralık katmanı ve açık hücre biçimlendirmesini çözümler; Subtotal, sıralı bir aralığı tek bir sütundaki değişimlere göre gruplandırır ve ara toplam formüllerini, isteğe bağlı genel toplam formüllerini, devralınan biçimlendirmeyi ve anahat düzeylerini ekler

SortRangeInternal, aralık ve rapor işlemlerinin kullandığı gelişmiş kararlı sıralama giriş noktasıdır; çağıranlar normalde SortRange veya TXLSXRange.Sort öğesini tercih etmelidir

ClearColWidth ve ClearRowHeight, bir sütunun ya da satırın açık boyutunu kaldırarak sayfa varsayılanına dönmesini sağlar; HasColWidth / HasRowHeight yoklama yöntemlerini tamamlar

Anahat düğümü denetimi

TryGetOutlineNode, 1 tabanlı bir satır ya da sütun indeksi için yön duyarlı özet düğümünü, ayrıntı aralığını, anahat düzeyini, gizli durumunu ve açık daraltma işaretini döndürür

SetOutlineNodeCollapsed tek bir özet düğümünü idempotent olarak daraltır ya da genişletir; SetOutlineDisplayLevel, 1 tabanlı anahat düğmesi düzeyini somutlaşmış tüm gruplara uygular; ikisi de xocPreserve, xocCollapse ya da xocExpand alt öğe davranışını kabul eder

ToggleRowGrouped ve ToggleColGrouped, ilk ayrıntı indeksini kabul eden ve gerçek özet düğümünü SummaryBelow ya da SummaryRight üzerinden çözümleyen uyumluluk sarmalayıcıları olarak kalır

Yerel OpenDocument satır ve sütun grupları table:display üzerinden eşlenir, doğrudan üst veri ve yapısal düzenlemelerden sağ çıkar ve üye düzeyinde daraltma bayraklarını saklamadan XLSX özet düğümü işaretlerine dönüştürülür; bkz. Seyrek anahat geometrisi

Adlandırılmış stiller ve tablo stili çözümlemesi

TXLSXRange.ApplyNamedStyle, bir aralığı adlandırılmış hücre stiline bağlar; TXLSXLinkedStyle.AutomaticChoose, etkilenen biçim parçalarını stilden türetirken LinkedParts, yazı tipini, dolguyu, kenarlığı, sayı biçimini, hizalamayı ya da korumayı açıkça seçer

TXLSXNamedStyle.Style düzenlemeleri, yerel geçersiz kılmaları atmadan bağlı parçaları günceller; GetCellVisibleFormat sonucu, boş hücre somutlaştırmadan çalışma sayfası katmanları ve tablo stilleriyle birlikte çözümler

TXLSXNamedStyles.FindByName, adlandırılmış stil girdisini koleksiyonu elle taramadan görünen adına göre bulur

Yerleşik 60 light, medium ve dark tablo stili adının tamamı; HTML, PDF, görüntü, önizleme ve görüntüleyici çıktılarının paylaştığı eksiksiz temaya dayalı bölüm biçimlerine çözümlenir

Formül dönüştürme

TXLSXCell.ConvertFormulaToValue, bir formülü önbelleğe alınmış değeriyle değiştirir ve TXLSXCells.ConvertFormulasToValues, aynı işlemi saklanan hücre koleksiyonuna uygular

Formül girişi doğrulama

TXLSXWorkbook.FormulaEntryPolicy ve TXLSXWorksheet.ValidateFormulaEntry, paylaşılan, veriyi değiştirmeyen formül girişi sözleşmesini açığa çıkarır; boş metni, bilinmeyen işlevleri, bilinmeyen adları, sözdizimi hatalarını ve geçersiz hedefleri ayırt eder ve kayıtlı kullanıcı işlevlerini çağırmadan tanır; bkz. Formül girişi doğrulama politikası

Hücre depolama tanılaması

TXLSXCells.PackedStorageEnabled, uyumlu satır-öncelikli türlü toplu yazımların kullandığı paketlenmiş RLE arka ucunu denetler; PackedCellCount, nesne düzeyinde erişim kararlı hücre tanıtıcılarını somutlaştırmadan önce orada tutulan hücreleri bildirir

GetStorageStatistics; ölçülebilir bellek kararları için satır bloklarını, dolu satırları, nesne, metin, formül, zengin metin, tahmini paketlenmiş, etkin paketlenmiş, ayrılmış, kullanılan ve paketlenmiş dize bayt sayılarını bildirir; stil yükü sayıları ve kaçınılan stilli-boş yük baytları, copy-on-write paylaşımını doğrudan açığa çıkarır

Otomatik Filtre ayrıntıları

TXLSXAutoFilterColumn.ClearValueFilters, sütun girdisini korurken değer ve tarih grubu filtrelerini temizler

HasCriteria2 ve AndConnector, iki koşullu özel filtreleri açıklar; renk filtreleri HasColorFilter, HasColorFilter_CellColor ve HasColorFilter_DxfId kullanır; simge filtreleri HasIconFilter, HasIconFilter_Set ve HasIconFilter_Id kullanır

Dinamik filtreler HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVal ve HasDynamicFilter_MaxValSet kullanır; RawXml desteklenmeyen filtre yükünü korur

Degrade dolgular

TXLSXFill.AddGradientStop bir renk durağı ekler. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCount ve GradientStops, doğrusal veya yol geometrisini açığa çıkarır

BackgroundColorTheme, BackgroundColorIndex ve BackgroundTintAndShade, RGB olmayan arka plan renklerini korur ve TXLSXFills.AddLinearGradient, eksiksiz bir doğrusal degrade oluşturup kaydeder

TXLSXFill.ForegroundColorTheme, ForegroundColorIndex ve ForegroundTintAndShade, ön plan karşılıklarıdır; tema, palet indeksi ve tint-and-shade ön plan renklerini RGB değerin yanında korur

Grafikler

TXLSXChart; PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly ve uyumluluk amaçlı DataLabelsRange cephesini açığa çıkarır; bu cephenin setter'ı geçerli serilere yayın yapar ve sonraki serilere tohum olur, getter'ı ise yalnızca seriler arası ortak bir formül döndürür

TXLSXChartPlotGroup.Assign bir çizim grubunu kopyalar; ZOrder, BarGrouping, GapWidth ve Overlap onun sıralamasını ve çubuk geometrisini denetler

TXLSXChartSeries, SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos ve LabelPosSet öğelerini açığa çıkarır

Seri başına hücre kaynaklı etiketler DataLabelsRange, DataLabelsCache, ShowDataLabelsRange ve ShowDataLabelsRangeSet kullanır; SetPointShowDataLabelsRange ve TryGetPointShowDataLabelsRange, seyrek sıfır tabanlı görünürlük geçersiz kılmalarını yönetirken ResolveDataLabelsRange, çalışma kitabı üretimi başına bir kez erişilebilir çalışma sayfası metnini yeniler ve bir veri kaynağı açmadan harici önbellekleri korur

TXLSXChartSeries.CategoriesMultiLevel, hiyerarşik eksen etiketleri için c:multiLvlStrRef kategorileri üretir; varsayılan, düz c:strRef / c:numRef üretimini korur

TXLSXChartTrendline, Intercept, InterceptSet, Forward ve Backward öngörü dönemlerini açığa çıkarırken TXLSXChartAxis.ShowDispUnitsLabel, görüntüleme birimleri etiketini denetler

Koşullu biçimler ve doğrulamalar

TXLSXConditionalFormat.ContainsCellFast dizinli üyelik denetimleri gerçekleştirir, HasStyle farklı bir stil bildirir ve StdDev, EqualAverage ile IsPivot gelişmiş kural bayraklarını açığa çıkarır

TXLSXConditionalFormat.AcquireWriteGuard, çalışma kitabının IXLSWorkbookWriteGuard arayüzünü döndürür; böylece toplu kural düzenlemeleri, tamamlanma anında çalışma kitabı üretimini bir kez ilerletir

TXLSXDataValidation.ContainsCellFast, eşdeğer dizinli doğrulama aralığı üyelik denetimini gerçekleştirir

Tablolar, sayfalar, bağlantılar, yorumlar ve çizimler

TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds ve HasHeaderRow, sorgu destekli ve başlıksız tablo meta verilerini korur

TXLSXTable.FindFirst ve FindNext, adlandırılmış sütunu bir değere eşit olan satırlar için çağıranın verdiği çalışma sayfasını tarar; büyük/küçük harfe duyarsız dize, sayısal ve Boolean karşılaştırmalarla 1 tabanlı bir satır ya da 0 döndürür

TXLSXSheets.AddCopy, bağımlı nesnelerle bir çalışma sayfasını çoğaltır ve ByPos, koleksiyona geçerli sekme konumundan erişir

TXLSXExternalLink.AddDefinedName ve DefinedNameCount, önbelleğe alınan dış adları korur; FindDefinedName bir girdiyi adıyla bulur. Salt okunur RelationshipId, SourceSlot ve LinkKind özellikleri; dış bağlantı parçasının ilişki kimliğini, dış formüllerin kullandığı 1 tabanlı [N] yuvasını ve bağlantı sınıflandırmasını (çalışma kitabı, DDE, OLE ya da bilinmeyen) açığa çıkarır; TXLSXHyperlink.TargetFrame, hedef gözatma bağlamını korur

TXLSXDefinedName.UnknownAttributes, tanımlı bir ad üzerindeki tanınmayan öznitelikleri korur; böylece desteklenmeyen uzantılar round-trip'lerden sağ çıkar

TXLSXComment.AutoSizeFromText, yorum şeklini metnine göre boyutlandırır ve ClearFont, açık zengin metin yazı tipi akışlarını kaldırır

TXLSXImage.SvgData, SVG eşini saklar ve CameraRange, bağlantılı resim kaynak aralığını tanımlar; TXLSXTextBox.PrstToken, DrawingML hazır geometri belirtecini korur

Görüntüler baytları kopyalamadan yükleri paylaşır: TXLSXImage.Blob ataması (Data, SvgData, CacheKey, ContentDigest, SvgContentDigest ve ByteSize taşıyan IXLSXImageBlob arayüzü), tekrarlanan rapor görüntüleri için sıfır kopyalı yoldur; özetler (digest) kaydetme anındaki medya internine uygun olarak bir kez hesaplanır ve salt okunur TXLSXImage.CacheKey ile ContentDigest atanan kimliği bildirir; rapor önbelleği, aynı cache key'in farklı bayt ya da biçimlerle yeniden kullanılmasını reddeder

DrawingObjectCount ve DrawingObject; görüntüler, grafikler, metin kutuları, korunan ham çıtalar ve gruplar arasında kararlı tek bir karma sıra açığa çıkarır; her TXLSXDrawingObject Kind, Parent, ChildCount ve TextBox öğelerini açığa çıkarır ve BringToFront, SendToBack, BringForward, SendBackward ile yeniden sıralanabilir

GroupDrawingObjects, seçili nesnelerden dönüştürme duyarlı bir DrawingML grubu oluşturur; UngroupDrawingObject, mevcut bir paketten yüklenmiş gruplar dahil alt öğeleri sırayla geri getirir

Klasik çalışma sayfası karşılıkları

TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage ve BackgroundImageResource; BIFF8 çalışma sayfası arka planlarını yazar, kaldırır ve inceler; bitmap verisi standart bir BMP olarak açığa çıkar, yerel ya da bilinmeyen biçimler ham yüklerini ve biçim kodlarını korur ve bilinen arka planlar Klasik ile XLSX motorları arasında iki yönlü dönüştürülür

TXLSWorksheet.ConvertFormulasToValues, formülleri önbelleğe alınmış sonuçlarla değiştirir, OpenRTF aşırı yüklemeleri bir RTF tablosunu varsayılan veya çağıranın seçtiği hedefe içe aktarır, WriteAutoValue bir varyanttan hücre türü seçer ve DefaultFormat, çalışma sayfası varsayılan XF değerini açığa çıkarır

Ayrıca bkz.