Estrutura SHCOLUMNINFO (shlobj.h)

  • Artigo

Contém informações sobre as propriedades de uma coluna. Ele é usado por IColumnProvider::GetColumnInfo.

Sintaxe

typedef struct {
  SHCOLUMNID scid;
  VARTYPE    vt;
  DWORD      fmt;
  UINT       cChars;
  DWORD      csFlags;
  WCHAR      wszTitle[MAX_COLUMN_NAME_LEN];
  WCHAR      wszDescription[MAX_COLUMN_DESC_LEN];
} SHCOLUMNINFO, *LPSHCOLUMNINFO;

Membros

scid

Tipo: SHCOLUMNID

Uma estrutura SHCOLUMNID que identifica exclusivamente a coluna.

vt

Tipo: VARTYPE

O tipo VARIANT nativo dos dados da coluna.

fmt

Tipo: DWORD

Formato de exibição de lista. Normalmente, esse membro é definido como LVCFMT_LEFT.

cChars

Tipo: UINT

A largura padrão da coluna, em caracteres.

csFlags

Tipo: DWORD

Sinalizadores que indicam o estado da coluna padrão. Pode ser uma combinação dos sinalizadores a seguir.

SHCOLSTATE_TYPE_STR

Uma cadeia de caracteres.

SHCOLSTATE_TYPE_INT

Um inteiro.

SHCOLSTATE_TYPE_DATE

Uma data.

SHCOLSTATE_ONBYDEFAULT

Mostrado por padrão no modo de exibição Detalhes do Windows Explorer, mesmo que o usuário não tenha selecionado a coluna. Se esse sinalizador for definido, a coluna será exibida para todas as pastas. Não há como forçar uma coluna a ser exibida por pasta.

SHCOLSTATE_SLOW

Lento para calcular. O Windows Explorer deve recuperar os dados de forma assíncrona e fazer a computação em um thread em segundo plano.

SHCOLSTATE_EXTENDED

Fornecido por um manipulador, não pelo objeto folder.

SHCOLSTATE_SECONDARYUI

Não exibido no menu de atalho, mas listado na caixa de diálogo Mais... .

SHCOLSTATE_HIDDEN

Não exibido na interface do usuário.

wszTitle[MAX_COLUMN_NAME_LEN]

Tipo: WCHAR[MAX_COLUMN_NAME_LEN]

Uma cadeia de caracteres Unicode terminada em nulo com o título da coluna. Ele não deve conter mais do que MAX_COLUMN_NAME_LEN caracteres, incluindo o NULL de terminação.

wszDescription[MAX_COLUMN_DESC_LEN]

Tipo: WCHAR[MAX_COLUMN_DESC_LEN]

Uma cadeia de caracteres Unicode terminada em nulo com a descrição da coluna. Ele não deve conter mais de MAX_COLUMN_DESC_LEN caracteres, incluindo o NULL de terminação.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho shlobj.h

Confira também

IColumnProvider::GetColumnInfo