共用方式為

LVCOLUMNA 結構 （commctrl.h）

  • 發行項

包含報表檢視中數據行的相關信息。 此結構同時用於建立及操作數據行。 這個結構會取代LV_COLUMN結構。

語法

typedef struct tagLVCOLUMNA {
  UINT  mask;
  int   fmt;
  int   cx;
  LPSTR pszText;
  int   cchTextMax;
  int   iSubItem;
  int   iImage;
  int   iOrder;
  int   cxMin;
  int   cxDefault;
  int   cxIdeal;
} LVCOLUMNA, *LPLVCOLUMNA;

成員

mask

類型：UINT

變數，指定哪些成員包含有效的資訊。 這個成員可以是零，或下列其中一或多個值：

價值 意義
LVCF_FMT
 fmt 成員有效。
LVCF_WIDTH
 cx 成員有效。
LVCF_TEXT
 pszText 成員有效。
LVCF_SUBITEM
 iSubItem 成員有效。
LVCF_IMAGE

4.70 版。 iImage 成員有效。
LVCF_ORDER

4.70 版。 iOrder 成員有效。
LVCF_MINWIDTH

6.00 版 和 Windows Vista。cxMin 成員有效。
LVCF_DEFAULTWIDTH

6.00 版 和 Windows Vista。cxDefault 成員有效。
LVCF_IDEALWIDTH

6.00 版 和 Windows Vista。cxIdeal 成員有效。

fmt

類型：int

數據行行首和數據行中子專案的對齊方式。 最左邊數據行的對齊一律LVCFMT_LEFT;無法變更。 這個成員可以是下列值的組合。 請注意，並非所有組合都是有效的。

價值 意義
LVCFMT_LEFT
 文字靠左對齊。
LVCFMT_RIGHT
 文字靠右對齊。
LVCFMT_CENTER
 文字置中。
LVCFMT_JUSTIFYMASK
 位掩碼，用來選取控制字段理由 fmt 的位。 若要檢查資料行的格式，請使用邏輯 「and」 來結合LCFMT_JUSTIFYMASK與 fmt。 接著，您可以使用 switch 語句來判斷是否已設定LVCFMT_LEFT、LVCFMT_RIGHT或LVCFMT_CENTER位。
LVCFMT_IMAGE

4.70 版。 項目會顯示影像清單中的影像。
LVCFMT_BITMAP_ON_RIGHT

4.70 版。 點陣圖會出現在文字右側。 這不會影響指派給標頭專案之影像清單中的影像。
LVCFMT_COL_HAS_IMAGES

4.70 版。 標頭專案包含影像清單中的影像。
LVCFMT_FIXED_WIDTH

6.00 版 和 Windows Vista。 無法調整數據行的大小;與HDF_FIXEDWIDTH相同。
LVCFMT_NO_DPI_SCALE

6.00 版 和 Windows Vista。 如果未設定，CCM_DPISCALE會控管相應增加固定寬度。
LVCFMT_FIXED_RATIO

6.00 版 和 Windows Vista。 Width 會隨著數據列高度而增強。
LVCFMT_SPLITBUTTON

6.00 版 和 Windows Vista。 Column 是分割按鈕（與HDF_SPLITBUTTON相同）。 數據行的標頭會顯示分割按鈕（與HDF_SPLITBUTTON相同）。

cx

類型：int

數據行的寬度，以像素為單位。

pszText

類型：LPTSTR

如果設定數據行資訊，這個成員就是包含數據行行首文字之 Null 終止字串的位址。 如果 結構接收數據行的相關信息，這個成員會指定接收數據行行首文字之緩衝區的位址。

cchTextMax

類型：int

TCHARpszText 成員所指向之緩衝區的大小。 如果結構未收到數據行的相關信息，則會忽略此成員。

iSubItem

類型：int

與數據行相關聯的子專案索引。

iImage

類型：int

4.70 版。 影像清單中的影像以零起始的索引。 指定的影像會出現在數據行內。

iOrder

類型：int

4.70 版。 以零起始的數據行位移。 數據行位移以由左至右的順序。 例如，零表示最左邊的數據行。

cxMin

類型：int

Windows Vista。 以像素為單位的數據行寬度下限。

cxDefault

類型：int

Windows Vista。 應用程式定義的值通常用來儲存數據行的預設寬度。 清單檢視控件會忽略此成員。

cxIdeal

類型：int

Windows Vista。 唯讀的。 數據行的理想寬度，以像素為單位，因為數據行目前可能會自動調整為較小的寬度。

言論

如果數據行已新增至索引 0 的清單檢視控件（最左邊的數據行），則一律LVCFMT_LEFT。 在數據行 0 上設定其他旗標並不會覆寫該對齊方式。 因此，如果您持續插入索引 0 的數據行，則所有數據行中的文字會靠左對齊。 如果您想要讓第一個數據行靠右對齊或置中，您可以建立虛擬數據行，然後插入一或多個具有索引 1 或更新的數據行，並指定您需要的對齊方式。 最後刪除虛擬數據行。

注意

commctrl.h 標頭會將 LVCOLUMN 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 commctrl.h

另請參閱

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

參考