LVCOLUMNW 構造体 (commctrl.h)

[アーティクル]
08/22/2023

レポートビューの列に関する情報が含まれます。この構造体は、列の作成と操作の両方に使用されます。この構造体は、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 メンバーが指すバッファーの TCHAR単位のサイズ。構造体が列に関する情報を受信していない場合、このメンバーは無視されます。

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 つ以上の列を挿入し、必要な配置を指定します。最後に、ダミー列を削除します。

Note

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

要件


サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	commctrl.h

LVCOLUMNW 構造体 (commctrl.h)

構文

メンバー

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース