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。 寬度會隨著資料列高度而增加。
LVCFMT_SPLITBUTTON

6.00 版和 Windows Vista。 資料行是與HDF_SPLITBUTTON) 相同的分割按鈕 (。 資料行的標頭會顯示與HDF_SPLITBUTTON) 相同的分割按鈕 (。

cx

類型： int

資料行的寬度，以圖元為單位。

pszText

類型： LPTSTR

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

cchTextMax

類型： int

pszText成員所指向之緩衝區的TCHAR大小。 如果結構未收到資料行的相關資訊，則會忽略這個成員。

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

參考