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 | 類別座標軸上刻度標記之間的間隔 |
| NoMultiLevelLabels | True 只顯示最末層類別層級,並寫入類別座標軸的 noMultiLvlLbl 開關 |
| TextStyle | 刻度標籤的文字樣式 |
| TitleTextStyle | 座標軸標題的文字樣式 |
| TitleLayout | 座標軸標題的位置與大小 |
座標軸選取
xlsxAxisAutomatic 對一般圖表群組選類別座標軸,對散佈圖或泡泡圖群組選數值座標軸。xlsxAxisDate 搭配時間單位屬性可做日曆刻度,xlsxAxisSeries 則用於立體圖的深度座標軸
日期座標軸的單位值與其存在旗標彼此獨立。因此匯入的檔案會保留缺席的元素,指派單位時才把該值明確寫出。AssignClassicDateAxis 會映射作用中的 Classic 日期座標軸設定,並把來源模型中被遮蔽或無效的原始欄位保留原樣,讓 Classic 往返無損
單位或間隔缺席時,算繪會檢查所有可見數列一次,推斷日、月或年刻度,並依可見範圍、座標軸寬度、量測文字、數值格式與旋轉,選出有界的標籤密度。主要與次要標籤、座標、刻度與格線都使用產生出來的共用集合
NumberFormat 與 NumberFormatSourceLinked 保留 ChartML 標籤格式狀態。日期座標軸的刻度標籤算繪使用該格式;Orientation 會反轉刻度與資料座標,不會合併重複日期,也不會把稀疏日期均勻拉開
類別座標軸從最靠近座標軸的葉層級開始,逐層向上算繪階層式數列快取。NoMultiLevelLabels 會抑制父層級,模型轉換時映射到等效的 Classic 圖表旗標
文字與標題版面
TextStyle 設定刻度標籤的格式,TitleTextStyle 設定座標軸標題的格式。兩者都暴露具型別的名稱、大小、色彩、強調與旋轉設定。ChartML 的正旋轉值為順時針,會轉換成各輸出後端的原生慣例
TitleLayout 以正規化的 ChartML 座標安排座標軸標題的位置與大小。用 SetPositionAndSize 把四個值當成一組 Office 相容的群組一次啟用並設定
方法
另請參閱