HotXLS 文件

TXLSXChartAxis 類別

Unit: lxHandleX
XLSX 圖表主要、次要與立體座標軸的具型別類別、數值、日期與數列座標軸描述器

說明

每張圖表擁有主要類別與數值座標軸、次要類別與數值座標軸,以及一條數列深度座標軸。座標軸類型可以維持自動,或設成類別、數值、日期或數列;匯入的座標軸識別項與交叉連結在多次儲存週期中保持穩定

宣告

type
  TXLSXChartAxis = class
    property Kind: TXLSXChartAxisKind;
    property Position: TXLSXChartAxisPosition;
    property AxisId: Integer;
    property CrossAxisId: Integer;
    property Visible: Boolean;
    property Title: WideString;
    property LogBase: Double;
    property Orientation: TXLSXChartAxisOrientation;
    property MajorGridlines: Boolean;
    property MinorGridlines: Boolean;
    property MinValue: Double;
    property MaxValue: Double;
    property MajorUnit: Double;
    property MinorUnit: Double;
    property MajorUnitSet: Boolean;
    property MinorUnitSet: Boolean;
    property CrossesAt: Double;
    property TickLblPos: WideString;
    property Crosses: TXLSXChartCrosses;
    property CrossesSet: Boolean;
    property MajorTickMark: TXLSXChartTickMark;
    property MinorTickMark: TXLSXChartTickMark;
    property DispUnits: Double;
    property ShowDispUnitsLabel: Boolean;
    property BaseTimeUnit: TXLSXChartTimeUnit;
    property MajorTimeUnit: TXLSXChartTimeUnit;
    property MinorTimeUnit: TXLSXChartTimeUnit;
    property BaseTimeUnitSet: Boolean;
    property MajorTimeUnitSet: Boolean;
    property MinorTimeUnitSet: Boolean;
    property AutoDateAxis: Boolean;
    property AutoDateAxisSet: Boolean;
    property NumberFormat: WideString;
    property NumberFormatSourceLinked: Boolean;
    property NumberFormatSet: Boolean;
    property LabelInterval: Integer;
    property TickMarkInterval: Integer;
    property NoMultiLevelLabels: Boolean;
    property TextStyle: TXLSXChartTextStyle;
    property TitleTextStyle: TXLSXChartTextStyle;
    property TitleLayout: TXLSXChartLayout;
    procedure Assign(Source: TXLSXChartAxis);
    procedure AssignClassicDateAxis(Source: TXLSChartAxis);
  end;

屬性

Kind座標軸類型 — 自動、類別、數值、日期或數列
Position座標軸在繪圖區內的位置 — 一般、低或高
AxisId跨儲存週期保持穩定的座標軸識別項
CrossAxisId與其交叉的座標軸識別項
Visible座標軸是否算繪
Title座標軸標題文字
LogBase對數刻度的底數;零表示線性
Orientation座標軸方向 — 正向或反轉
MajorGridlines以主刻度單位間距顯示主要格線
MinorGridlines以次刻度單位間距顯示次要格線
MinValue固定最小值;NaN 表示自動
MaxValue固定最大值;NaN 表示自動
MajorUnit主要格線的間距;零表示自動
MinorUnit次要格線的間距;零表示自動
MajorUnitSet是否明確存在正的主刻度單位值
MinorUnitSet是否明確存在正的次刻度單位值
CrossesAt交叉軸相交的數值;NaN 表示自動
TickLblPos刻度標籤位置 — 'nextTo'、'low'、'high' 或 'none'
Crosses座標軸交叉模式。指派 Crosses 會輸出 <c:crosses val="..."/> 取代自動交叉;明確設定 CrossesAt 時仍以它為準(兩個都設是不合法的 OOXML,以 CrossesAt 為優先)
CrossesSet交叉模式是否已被明確設定
MajorTickMark主要刻度標記的樣式,繪在主要格線的交點上
MinorTickMark次要刻度標記的樣式,繪在次要格線的交點上
DispUnits顯示單位縮放係數(10、100、1000 ...)或內建單位;零表示停用
ShowDispUnitsLabel在座標軸旁顯示顯示單位標籤('Thousands'、'Millions' ...)
BaseTimeUnit日期座標軸的基底時間單位;指派後即使值是 xlsxChartTimeDays 也會標記為明確
MajorTimeUnit日期座標軸的主時間單位;指派後標記為明確
MinorTimeUnit日期座標軸的次時間單位;指派後標記為明確
BaseTimeUnitSet控制是否輸出 baseTimeUnit;False 會保留來源中缺席的元素,而不是寫出明確的日單位
MajorTimeUnitSet控制是否獨立於 MajorUnit 輸出 majorTimeUnit
MinorTimeUnitSet控制是否獨立於 MinorUnit 輸出 minorTimeUnit
AutoDateAxis明確的日期座標軸自動類別偵測值
AutoDateAxisSet控制是否輸出日期座標軸的 auto 元素
NumberFormat套用到座標軸標籤的數值格式;指派後標記格式為明確
NumberFormatSourceLinked座標軸標籤格式是否跟隨來源資料;指派後標記格式為明確
NumberFormatSet控制是否輸出 ChartML 的 numFmt 元素
LabelInterval類別標籤之間的間隔
TickMarkInterval類別座標軸上刻度標記之間的間隔
NoMultiLevelLabelsTrue 只顯示最末層類別層級,並寫入類別座標軸的 noMultiLvlLbl 開關
TextStyle刻度標籤的文字樣式
TitleTextStyle座標軸標題的文字樣式
TitleLayout座標軸標題的位置與大小

座標軸選取

xlsxAxisAutomatic 對一般圖表群組選類別座標軸,對散佈圖或泡泡圖群組選數值座標軸。xlsxAxisDate 搭配時間單位屬性可做日曆刻度,xlsxAxisSeries 則用於立體圖的深度座標軸
日期座標軸的單位值與其存在旗標彼此獨立。因此匯入的檔案會保留缺席的元素,指派單位時才把該值明確寫出。AssignClassicDateAxis 會映射作用中的 Classic 日期座標軸設定,並把來源模型中被遮蔽或無效的原始欄位保留原樣,讓 Classic 往返無損
單位或間隔缺席時,算繪會檢查所有可見數列一次,推斷日、月或年刻度,並依可見範圍、座標軸寬度、量測文字、數值格式與旋轉,選出有界的標籤密度。主要與次要標籤、座標、刻度與格線都使用產生出來的共用集合
NumberFormat 與 NumberFormatSourceLinked 保留 ChartML 標籤格式狀態。日期座標軸的刻度標籤算繪使用該格式;Orientation 會反轉刻度與資料座標,不會合併重複日期,也不會把稀疏日期均勻拉開
類別座標軸從最靠近座標軸的葉層級開始,逐層向上算繪階層式數列快取。NoMultiLevelLabels 會抑制父層級,模型轉換時映射到等效的 Classic 圖表旗標

文字與標題版面

TextStyle 設定刻度標籤的格式,TitleTextStyle 設定座標軸標題的格式。兩者都暴露具型別的名稱、大小、色彩、強調與旋轉設定。ChartML 的正旋轉值為順時針,會轉換成各輸出後端的原生慣例
TitleLayout 以正規化的 ChartML 座標安排座標軸標題的位置與大小。用 SetPositionAndSize 把四個值當成一組 Office 相容的群組一次啟用並設定

方法

procedure Assign

另請參閱