LVCOLUMNW 構造体 (commctrl.h)

[アーティクル]
11/18/2024

レポートビューの列に関する情報が含まれています。この構造体は、列の作成と操作の両方に使用されます。この構造体は、LV_COLUMN構造体よりも優先されます。

構文

typedef struct tagLVCOLUMNW {
  UINT   mask;
  int    fmt;
  int    cx;
  LPWSTR pszText;
  int    cchTextMax;
  int    iSubItem;
  int    iImage;
  int    iOrder;
  int    cxMin;
  int    cxDefault;
  int    cxIdeal;
} LVCOLUMNW, *LPLVCOLUMNW;

メンバーズ

mask

型: UINT

有効な情報を含むメンバーを指定する変数。このメンバーには、0 または 1 つ以上の次の値を指定できます。

価値	意味
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 メンバーによって指 バッファーの TCHARs のサイズ。構造体が列に関する情報を受信していない場合、このメンバーは無視されます。

iSubItem

型: int

列に関連付けられているサブ項目のインデックス。

iImage

型: int

バージョン 4.70をします。イメージリスト内のイメージの 0 から始まるインデックス。指定したイメージが列内に表示されます。

iOrder

型: int

バージョン 4.70をします。 0 から始まる列オフセット。列のオフセットは、左から右の順序で行います。たとえば、0 は左端の列を示します。

cxMin

型: int

Windows Vistaをします。列の最小幅 (ピクセル単位)。

cxDefault

型: int

Windows Vistaをします。通常、列の既定の幅を格納するために使用されるアプリケーション定義の値。このメンバーは、リストビューコントロールでは無視されます。

cxIdeal

型: int

Windows Vistaをします。読み取り専用。列の理想的な幅 (ピクセル単位)。

備考

インデックス 0 (左端の列) を持つリストビューコントロールに列を追加すると、常にLVCFMT_LEFT。列 0 に他のフラグを設定しても、その配置はオーバーライドされません。したがって、インデックス 0 の列を挿入し続ける場合、すべての列のテキストは左揃えになります。最初の列を右揃えまたは中央揃えにする場合は、ダミー列を作成し、インデックス 1 以上の 1 つ以上の列を挿入し、必要な配置を指定します。最後に、ダミー列を削除します。

手記

commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LVCOLUMN を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップアプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップアプリのみ]
ヘッダー	commctrl.h

次の方法で共有

LVCOLUMNW 構造体 (commctrl.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース