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 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 é 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 subitem na coluna. O alinhamento da coluna mais à esquerda é sempre LVCFMT_LEFT; ele 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 que controlam a justificativa do campo. Para marcar 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; o mesmo que HDF_FIXEDWIDTH.
LVCFMT_NO_DPI_SCALE

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

Versão 6.00 e Windows Vista. A largura aumentará com a altura da linha.
LVCFMT_SPLITBUTTON

Versão 6.00 e Windows Vista. A coluna é 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 especificará o endereço do buffer que recebe o texto do cabeçalho da coluna.

cchTextMax

Tipo: int

Tamanho em TCHARs 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 aparecerá dentro da coluna.

iOrder

Tipo: int

Versão 4.70. Deslocamento de coluna baseado em zero. O deslocamento de 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.

Comentários

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, crie uma coluna fictícia, insira uma ou mais colunas com índice 1 ou superior e especifique o alinhamento necessário. Por fim, exclua a coluna fictícia.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho commctrl.h

Confira também

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

Referência