Compartilhar via

Estrutura LVCOLUMNA (commctrl.h)

  • Artigo

Contém informações sobre uma coluna no modo de exibição de relatório. Essa estrutura é usada para criar e manipular colunas. Essa estrutura substitui a estrutura LV_COLUMN.

Sintaxe

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;

Membros

mask

Tipo: UINT

Variável que especifica quais membros contêm informações válidas. Esse membro pode ser zero ou um ou mais dos seguintes valores:

Valor Significado
LVCF_FMT
 O membro fmt é válido.
LVCF_WIDTH
 O membro cx é válido.
LVCF_TEXT
 O membro pszText é válido.
LVCF_SUBITEM
 O membro iSubItem é válido.
LVCF_IMAGE

versão 4.70. O membro do iImage é válido.
LVCF_ORDER

versão 4.70. O membro iOrder é válido.
LVCF_MINWIDTH

versão 6.00 e Windows Vista.o membro cxMin do é válido.
LVCF_DEFAULTWIDTH

versão 6.00 e Windows Vista.o membro cxDefault é válido.
LVCF_IDEALWIDTH

versão 6.00 e Windows Vista.o membro cxIdeal é válido.

fmt

Tipo: int

Alinhamento do cabeçalho da coluna e do texto do subitem na coluna. O alinhamento da coluna mais à esquerda é sempre LVCFMT_LEFT; não pode ser alterado. Esse membro pode ser uma combinação dos valores a seguir. Observe que nem todas as combinações são válidas.

Valor Significado
LVCFMT_LEFT
 O texto é alinhado à esquerda.
LVCFMT_RIGHT
 O texto está alinhado à direita.
LVCFMT_CENTER
 O texto é centralizado.
LVCFMT_JUSTIFYMASK
 Uma máscara de bits usada para selecionar esses bits de fmt essa justificativa de campo de controle. Para verificar o formato de uma coluna, use um "and" lógico para combinar LCFMT_JUSTIFYMASK com fmt. Em seguida, você pode usar uma instrução switch para determinar se os bits LVCFMT_LEFT, LVCFMT_RIGHT ou LVCFMT_CENTER estão definidos.
LVCFMT_IMAGE

versão 4.70. O item exibe uma imagem de uma lista de imagens.
LVCFMT_BITMAP_ON_RIGHT

versão 4.70. O bitmap aparece à direita do texto. Isso não afeta uma imagem de uma lista de imagens atribuída ao item de cabeçalho.
LVCFMT_COL_HAS_IMAGES

versão 4.70. O item de cabeçalho contém uma imagem na lista de imagens.
LVCFMT_FIXED_WIDTH

versão 6.00 e Windows Vista. Não é possível redimensionar a coluna; igual a HDF_FIXEDWIDTH.
LVCFMT_NO_DPI_SCALE

versão 6.00 e Windows Vista. Se não estiver definido, CCM_DPISCALE controlará o dimensionamento da largura fixa.
LVCFMT_FIXED_RATIO

versão 6.00 e Windows Vista. Largura aumentará com a altura da linha.
LVCFMT_SPLITBUTTON

versão 6.00 e Windows Vista. Column é um botão de divisão (o mesmo que HDF_SPLITBUTTON). O cabeçalho da coluna exibe um botão de divisão (o mesmo que HDF_SPLITBUTTON).

cx

Tipo: int

Largura da coluna, em pixels.

pszText

Tipo: LPTSTR

Se as informações da coluna estiverem sendo definidas, esse membro será o endereço de uma cadeia de caracteres terminada em nulo que contém o texto do cabeçalho da coluna. Se a estrutura estiver recebendo informações sobre uma coluna, esse membro especifica o endereço do buffer que recebe o texto do cabeçalho da coluna.

cchTextMax

Tipo: int

Tamanho em TCHAR do buffer apontado pelo membro pszText . Se a estrutura não estiver recebendo informações sobre uma coluna, esse membro será ignorado.

iSubItem

Tipo: int

Índice de subitem associado à coluna.

iImage

Tipo: int

versão 4.70. Índice baseado em zero de uma imagem na lista de imagens. A imagem especificada será exibida dentro da coluna.

iOrder

Tipo: int

versão 4.70. Deslocamento de coluna baseado em zero. O deslocamento da coluna está em ordem da esquerda para a direita. Por exemplo, zero indica a coluna mais à esquerda.

cxMin

Tipo: int

Windows Vista. Largura mínima da coluna em pixels.

cxDefault

Tipo: int

Windows Vista. O valor definido pelo aplicativo normalmente é usado para armazenar a largura padrão da coluna. Esse membro é ignorado pelo controle de exibição de lista.

cxIdeal

Tipo: int

Windows Vista. Somente leitura. A largura ideal da coluna em pixels, pois a coluna pode atualmente ser dimensionada automaticamente para uma largura menor.

Observações

Se uma coluna for adicionada a um controle de exibição de lista com o índice 0 (a coluna mais à esquerda), ela sempre será LVCFMT_LEFT. Definir outros sinalizadores na coluna 0 não substitui esse alinhamento. Portanto, se você continuar inserindo colunas com o índice 0, o texto em todas as colunas será alinhado à esquerda. Se você quiser que a primeira coluna seja alinhada à direita ou centralizada, você poderá criar uma coluna fictícia, insira uma ou mais colunas com o índice 1 ou superior e especifique o alinhamento necessário. Por fim, exclua a coluna fictícia.

Nota

O cabeçalho commctrl.h define LVCOLUMN como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho commctrl.h

Consulte também

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

de referência de