SpreadsheetView/Framework/Sources/SpreadsheetViewDataSource.swift at 27a836af23e3722528ecae16cce2cb102221d47e · bannzai/SpreadsheetView · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
//
//  SpreadsheetViewDataSource.swift
//  SpreadsheetView
//
//  Created by Kishikawa Katsumi on 4/21/17.
//  Copyright © 2017 Kishikawa Katsumi. All rights reserved.
//

import UIKit

/// Implement this protocol to provide data to an `SpreadsheetView`.
public protocol SpreadsheetViewDataSource: AnyObject {
    /// Asks your data source object for the number of columns in the spreadsheet view.
    ///
    /// - Parameter spreadsheetView: The spreadsheet view requesting this information.
    /// - Returns: The number of columns in `spreadsheetView`.
    func numberOfColumns(in spreadsheetView: SpreadsheetView) -> Int
    /// Asks the number of rows in spreadsheet view.
    ///
    /// - Parameter spreadsheetView: The spreadsheet view requesting this information.
    /// - Returns: The number of rows in `spreadsheetView`.
    func numberOfRows(in spreadsheetView: SpreadsheetView) -> Int

    /// Asks the data source for the width to use for a row in a specified location.
    ///
    /// - Parameters:
    ///   - spreadsheetView: The spreadsheet view requesting this information.
    ///   - column: The index of the column.
    /// - Returns: A nonnegative floating-point value that specifies the width (in points) that column should be.
    func spreadsheetView(_ spreadsheetView: SpreadsheetView, widthForColumn column: Int) -> CGFloat
    /// Asks the data source for the height to use for a row in a specified location.
    ///
    /// - Parameters:
    ///   - spreadsheetView: The spreadsheet view requesting this information.
    ///   - row: The index of the row.
    /// - Returns: A nonnegative floating-point value that specifies the height (in points) that row should be.
    func spreadsheetView(_ spreadsheetView: SpreadsheetView, heightForRow row: Int) -> CGFloat

    /// Asks your data source object for the view that corresponds to the specified cell in the spreadsheetView.
    /// The cell that is returned must be retrieved from a call to `dequeueReusableCell(withReuseIdentifier:for:)`
    ///
    /// - Parameters:
    ///   - spreadsheetView: The spreadsheet view requesting this information.
    ///   - indexPath: The location of the cell
    /// - Returns: A cell object to be displayed at the location.
    ///   If you return nil from this method, the blank cell will be displayed by default.
    func spreadsheetView(_ spreadsheetView: SpreadsheetView, cellForItemAt indexPath: IndexPath) -> Cell?

    /// Asks your data source object for the array of cell ranges that indicate the range of merged cells in the spreadsheetView.
    ///
    /// - Parameter spreadsheetView: The spreadsheet view requesting this information.
    /// - Returns: An array of the cell ranges indicating the range of merged cells.
    func mergedCells(in spreadsheetView: SpreadsheetView) -> [CellRange]
    /// Asks your data source object for the number of columns to be frozen as a fixed column header in the spreadsheetView.
    ///
    /// - Parameter spreadsheetView: The spreadsheet view requesting this information.
    /// - Returns: The number of columns to be frozen
    func frozenColumns(in spreadsheetView: SpreadsheetView) -> Int
    /// Asks your data source object for the number of rows to be frozen as a fixed row header in the spreadsheetView.
    ///
    /// - Parameter spreadsheetView: The spreadsheet view requesting this information.
    /// - Returns: The number of rows to be frozen
    func frozenRows(in spreadsheetView: SpreadsheetView) -> Int
}

extension SpreadsheetViewDataSource {
    public func spreadsheetView(_ spreadsheetView: SpreadsheetView, cellForItemAt indexPath: IndexPath) -> Cell? { return nil }
    public func mergedCells(in spreadsheetView: SpreadsheetView) -> [CellRange] { return [] }
    public func frozenColumns(in spreadsheetView: SpreadsheetView) -> Int { return 0 }
    public func frozenRows(in spreadsheetView: SpreadsheetView) -> Int { return 0 }
}