共用方式為

如何新增清單檢視數據行

  • 發行項

本主題示範如何將數據行新增至清單檢視控件。 當清單檢視控件在報表（詳細數據）檢視中時，數據行可用來顯示專案和子專案。 選取數據行的文字也可以顯示在圖格檢視中。

您需要知道的事項

技術

必要條件

  • C/C++
  • Windows 使用者介面程序設計

指示

若要將數據行新增至清單檢視控件，請傳送 LVM_INSERTCOLUMN 訊息或使用 ListView_InsertColumn 宏。 若要刪除資料行，請使用 LVM_DELETECOLUMN 訊息。

下列 C++ 程式代碼範例會呼叫 ListView_InsertColumn 宏，以將數據行新增至清單檢視控件。 數據行標題會在應用程式的頭檔中定義為字串資源，而字串資源會從 IDS_FIRSTCOLUMN 開始連續編號。 數據行數目會在頭檔中 定義為 C_COLUMNS。

// InitListViewColumns: Adds columns to a list-view control.
// hWndListView:        Handle to the list-view control. 
// Returns TRUE if successful, and FALSE otherwise. 
BOOL InitListViewColumns(HWND hWndListView) 
{ 
    WCHAR szText[256];     // Temporary buffer.
    LVCOLUMN lvc;
    int iCol;

    // Initialize the LVCOLUMN structure.
    // The mask specifies that the format, width, text,
    // and subitem members of the structure are valid.
    lvc.mask = LVCF_FMT | LVCF_WIDTH | LVCF_TEXT | LVCF_SUBITEM;

    // Add the columns.
    for (iCol = 0; iCol < C_COLUMNS; iCol++)
    {
        lvc.iSubItem = iCol;
        lvc.pszText = szText;
        lvc.cx = 100;               // Width of column in pixels.

        if ( iCol < 2 )
            lvc.fmt = LVCFMT_LEFT;  // Left-aligned column.
        else
            lvc.fmt = LVCFMT_RIGHT; // Right-aligned column.

        // Load the names of the column headings from the string resources.
        LoadString(g_hInst,
                   IDS_FIRSTCOLUMN + iCol,
                   szText,
                   sizeof(szText)/sizeof(szText[0]));

        // Insert the columns into the list view.
        if (ListView_InsertColumn(hWndListView, iCol, &lvc) == -1)
            return FALSE;
    }
    
    return TRUE;
}

清單檢視控件參考

關於清單檢視控件

使用清單檢視控件