Estrutura LVCOLUMNA (commctrl.h)
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 |
|---|---|
|
O membro fmt é válido. |
|
O membro cx é válido. |
|
O membro pszText é válido. |
|
O membro iSubItem é válido. |
|
Versão 4.70. O membro iImage é válido. |
|
Versão 4.70. O membro iOrder é válido. |
|
Versão 6.00 e Windows Vista.O membro cxMin é válido. |
|
Versão 6.00 e Windows Vista.O membro cxDefault é válido. |
|
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 |
|---|---|
|
O texto é alinhado à esquerda. |
|
O texto está alinhado à direita. |
|
O texto é centralizado. |
|
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. |
|
Versão 4.70. O item exibe uma imagem de uma lista de imagens. |
|
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. |
|
Versão 4.70. O item de cabeçalho contém uma imagem na lista de imagens. |
|
Versão 6.00 e Windows Vista. Não é possível redimensionar a coluna; o mesmo que HDF_FIXEDWIDTH. |
|
Versão 6.00 e Windows Vista. Se não estiver definido, CCM_DPISCALE controlará o dimensionamento de largura fixa. |
|
Versão 6.00 e Windows Vista. A largura aumentará com a altura da linha. |
|
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
Referência