enumeração _NSTCSTYLE (shobjidl_core.h)

  • Artigo

Descreve as características de um determinado controle de árvore de namespace.

Syntax

typedef enum _NSTCSTYLE {
  NSTCS_HASEXPANDOS = 0x1,
  NSTCS_HASLINES = 0x2,
  NSTCS_SINGLECLICKEXPAND = 0x4,
  NSTCS_FULLROWSELECT = 0x8,
  NSTCS_SPRINGEXPAND = 0x10,
  NSTCS_HORIZONTALSCROLL = 0x20,
  NSTCS_ROOTHASEXPANDO = 0x40,
  NSTCS_SHOWSELECTIONALWAYS = 0x80,
  NSTCS_NOINFOTIP = 0x200,
  NSTCS_EVENHEIGHT = 0x400,
  NSTCS_NOREPLACEOPEN = 0x800,
  NSTCS_DISABLEDRAGDROP = 0x1000,
  NSTCS_NOORDERSTREAM = 0x2000,
  NSTCS_RICHTOOLTIP = 0x4000,
  NSTCS_BORDER = 0x8000,
  NSTCS_NOEDITLABELS = 0x10000,
  NSTCS_TABSTOP = 0x20000,
  NSTCS_FAVORITESMODE = 0x80000,
  NSTCS_AUTOHSCROLL = 0x100000,
  NSTCS_FADEINOUTEXPANDOS = 0x200000,
  NSTCS_EMPTYTEXT = 0x400000,
  NSTCS_CHECKBOXES = 0x800000,
  NSTCS_PARTIALCHECKBOXES = 0x1000000,
  NSTCS_EXCLUSIONCHECKBOXES = 0x2000000,
  NSTCS_DIMMEDCHECKBOXES = 0x4000000,
  NSTCS_NOINDENTCHECKS = 0x8000000,
  NSTCS_ALLOWJUNCTIONS = 0x10000000,
  NSTCS_SHOWTABSBUTTON = 0x20000000,
  NSTCS_SHOWDELETEBUTTON = 0x40000000,
  NSTCS_SHOWREFRESHBUTTON
} ;

Constantes

 
NSTCS_HASEXPANDOS
Valor: 0x1
O controle exibe um triângulo, conhecido como expando, na borda mais à esquerda desses itens que têm itens filho. Clicar no expando expando expande o item para revelar os filhos do item. Não tem efeito quando combinado com NSTCS_SHOWTABSBUTTON, NSTCS_SHOWDELETEBUTTON ou NSTCS_SHOWREFRESHBUTTON.



Mapeia para o estilo de controle de exibição de árvore TVS_HASBUTTONS .
NSTCS_HASLINES
Valor: 0x2
O controle desenha linhas à esquerda dos itens de árvore que levam a seus itens pai individuais. Não tem efeito quando combinado com NSTCS_SHOWTABSBUTTON, NSTCS_SHOWDELETEBUTTON ou NSTCS_SHOWREFRESHBUTTON.



Mapeia para o estilo de controle de exibição de árvore TVS_HASLINES .
NSTCS_SINGLECLICKEXPAND
Valor: 0x4
Um item se expande para mostrar seus itens filho em resposta a um único clique do mouse.



Mapeia para o estilo de controle de exibição de árvore TVS_SINGLEEXPAND .
NSTCS_FULLROWSELECT
Valor: 0x8
A seleção de um item preenche a linha com texto inverso até o final da área da janela, independentemente do comprimento do texto. Quando essa opção não é declarada, apenas a área por trás do texto é invertida. Esse valor não pode ser combinado com NSTCS_HASLINES.



Mapeia para o estilo de controle de exibição de árvore TVS_FULLROWSELECT.
NSTCS_SPRINGEXPAND
Valor: 0x10
Quando um item é selecionado e expandido e você seleciona um segundo item, a primeira seleção é recolhida automaticamente.


Isso é o oposto do estilo de controle de exibição de árvore TVS_EX_NOSINGLECOLLAPSE .
NSTCS_HORIZONTALSCROLL
Valor: 0x20
A área da janela que contém a árvore de itens de namespace tem uma barra de rolagem horizontal.



Mapeia para o estilo WS_HSCROLL Windows.
NSTCS_ROOTHASEXPANDO
Valor: 0x40
O item raiz é precedido por um expando que permite a expansão do item raiz.



Mapeia para o estilo de controle de exibição de árvore TVS_LINESATROOT .
NSTCS_SHOWSELECTIONALWAYS
Valor: 0x80
O nó de um item é descrito quando o controle não tem o foco.



Mapeia para o estilo de controle de exibição de árvore TVS_SHOWSELALWAYS .
NSTCS_NOINFOTIP
Valor: 0x200
Não exiba dicas de informações quando o cursor do mouse estiver sobre um item.



Isso é o oposto do estilo de controle de exibição de árvore TVS_INFOTIP .
NSTCS_EVENHEIGHT
Valor: 0x400
Define a altura dos itens como uma altura uniforme. Por padrão, a altura dos itens pode ser uniforme ou estranha.



Isso é o oposto do estilo de controle de exibição de árvore TVS_NONEVENHEIGHT .
NSTCS_NOREPLACEOPEN
Valor: 0x800
Não substitua o comando Abrir no menu de atalho por uma função definida pelo usuário.
NSTCS_DISABLEDRAGDROP
Valor: 0x1000
Não permita operações de arrastar e soltar dentro do controle. Observe que você ainda pode arrastar um item de fora do controle e solte-o no controle.



Mapeia para o estilo de controle de exibição de árvore TVS_DISABLEDRAGDROP.
NSTCS_NOORDERSTREAM
Valor: 0x2000
Não persista reordenando alterações. Usado com NSTCS_FAVORITESMODE. Se o modo favorito não for especificado, esse sinalizador não terá efeito.
NSTCS_RICHTOOLTIP
Valor: 0x4000
Use uma dica de ferramenta avançada. Dicas de ferramenta avançadas exibem o ícone do item, além do texto do item. Uma dica de ferramenta padrão exibe apenas o texto do item. O modo de exibição de árvore exibe dicas de ferramenta somente para itens na árvore que são parcialmente visíveis.



Mapeia para o estilo de controle de exibição de árvore TVS_EX_RICHTOOLTIP .

NSTCS_RICHTOOLTIP não tem efeito, a menos que seja combinado com NSTCS_NOINFOTIP e/ou NSTCS_FAVORITESMODE. Se NSTCS_NOINFOTIP não for especificado, o modo de exibição de árvore exibirá uma dica de informações em vez de uma dica de ferramenta. Se NSTCS_FAVORITESMODE não for especificado, o controle de árvore de namespace sempre definirá o estilo TVS_EX_RICHTOOLTIP .
NSTCS_BORDER
Valor: 0x8000
Desenhe uma borda fina ao redor do controle. Corresponde a WS_BORDER.
NSTCS_NOEDITLABELS
Valor: 0x10000
Não permita a criação de uma caixa de edição in-loco, o que permitiria ao usuário renomear o item especificado.



Isso é o oposto do estilo de controle de exibição de árvore TVS_EDITLABELS .
NSTCS_TABSTOP
Valor: 0x20000
Se o controle estiver hospedado, você poderá fazer tabstop no controle . Corresponde a WS_EX_CONTROLPARENT.
NSTCS_FAVORITESMODE
Valor: 0x80000
O controle tem a aparência da banda de favoritos no Windows XP.
NSTCS_AUTOHSCROLL
Valor: 0x100000
Quando você passa o ponteiro do mouse sobre um item que se estende até o final da janela de controle, o controle rola automaticamente horizontalmente para que o item apareça mais plenamente na área da janela.



Mapeia para o estilo de controle de exibição de árvore TVS_EX_AUTOHSCROLL .
NSTCS_FADEINOUTEXPANDOS
Valor: 0x200000
Se o controle não tiver o foco e houver itens precedidos por expandos, esses expandos ficarão visíveis somente quando o ponteiro do mouse estiver próximo ao controle.



Mapeia para o estilo de controle de exibição de árvore TVS_EX_FADEINOUTEXPANDOS .
NSTCS_EMPTYTEXT
Valor: 0x400000
Se um item não tiver filhos e não for expandido, esse item conterá uma linha de texto no nível filho que diz "vazio".
NSTCS_CHECKBOXES
Valor: 0x800000
Os itens têm marcar caixas no lado mais à esquerda. Essas caixas de marcar podem ser de tipos parciais, de exclusão ou esmaecidos, que correspondem aos sinalizadores NSTCS_PARTIALCHECKBOXES, NSTCS_EXCLUSIONCHECKBOXES e NSTCS_DIMMEDCHECKBOXES.



Mapeia para o estilo de controle de exibição de árvore TVS_CHECKBOXES .
NSTCS_PARTIALCHECKBOXES
Valor: 0x1000000
Adiciona um ícone de caixa de seleção no lado mais à esquerda de um determinado item com um quadrado no centro, que indica que o nó está parcialmente selecionado. Deve ser combinado com NSTCS_CHECKBOXES.



Mapeia para o estilo de controle de exibição de árvore TVS_EX_PARTIALCHECKBOXES .
NSTCS_EXCLUSIONCHECKBOXES
Valor: 0x2000000
Adiciona um ícone de caixa de seleção no lado mais à esquerda de um determinado item que contém um X vermelho, o que indica que o item é excluído da seleção atual. Sem esse ícone de exclusão, a seleção de um item pai inclui a seleção de seus itens filho. Deve ser combinado com NSTCS_CHECKBOXES.



Mapeia para o estilo de controle de exibição de árvore TVS_EX_EXCLUSIONCHECKBOXES .
NSTCS_DIMMEDCHECKBOXES
Valor: 0x4000000
Adiciona uma caixa de seleção no lado mais à esquerda de um determinado item que contém um ícone de uma marca de marcar esmaecida, que indica que um nó está selecionado porque seu pai está selecionado. Deve ser combinado com NSTCS_CHECKBOXES.



Mapeia para o estilo de controle de exibição de árvore TVS_EX_DIMMEDCHECKBOXES .
NSTCS_NOINDENTCHECKS
Valor: 0x8000000
As caixas de seleção estão localizadas na borda extrema esquerda da área da janela em vez de serem recuadas.



Mapeia para o estilo de controle de exibição de árvore TVS_EX_NOINDENTSTATE .
NSTCS_ALLOWJUNCTIONS
Valor: 0x10000000
Permitir junções. Um ponto de junção, ou apenas junção, é uma raiz de uma extensão de namespace que normalmente é exibida pelo Windows Explorer como uma pasta nas exibições de árvore e pasta. Para que o Windows Explorer exibir os arquivos e subpastas da extensão, especifique onde a pasta raiz está localizada na hierarquia de namespace do Shell.



As junções existem no sistema de arquivos como arquivos, mas não são tratadas como arquivos. Um exemplo é um arquivo compactado com uma extensão de nome de arquivo .zip, que para o sistema de arquivos é apenas um arquivo. No entanto, se esse arquivo for tratado como uma junção, ele poderá representar um namespace inteiro. Isso permite que o controle de árvore de namespace trate arquivos compactados e junções semelhantes como pastas e não como arquivos.
NSTCS_SHOWTABSBUTTON
Valor: 0x20000000
Exibe uma seta no lado direito de um item se o item for uma pasta. A ação associada à seta é específica da implementação. Não pode ser combinado com NSTCS_SHOWDELETEBUTTON ou NSTCS_SHOWREFRESHBUTTON.
NSTCS_SHOWDELETEBUTTON
Valor: 0x40000000
Exibe um X vermelho no lado direito de um item. A ação associada ao X é específica da implementação. Não pode ser combinado com NSTCS_SHOWTABSBUTTON ou NSTCS_SHOWREFRESHBUTTON.
NSTCS_SHOWREFRESHBUTTON
Exibe um botão atualizar no lado direito de um item. A ação associada ao botão é específica da implementação. Não pode ser combinado com NSTCS_SHOWTABSBUTTON ou NSTCS_SHOWDELETEBUTTON.

Comentários

Três valores têm efeito apenas em conjunto com NSTCS_CHECKBOXES: NSTCS_PARTIALCHECKBOXES, NSTCS_EXCLUSIONCHECKBOXES e NSTCS_DIMMEDCHECKBOXES. Os ícones associados a esses estados são inseridos na lista de imagens de estado da seguinte maneira:

Slot de Imagem Imagem Sinalizadores associados
0 Em branco NSTCS_CHECKBOXES
1 Desmarcado NSTCS_CHECKBOXES
2 Verificado NSTCS_CHECKBOXES
3 Parcial NSTCS_CHECKBOXES | NSTCS_PARTIALCHECKBOXES
4 Exclusão (X vermelho) NSTCS_CHECKBOXES | NSTCS_EXCLUSIONCHECKBOXES

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

INameSpaceTreeControl2::GetControlStyle

INameSpaceTreeControl2::SetControlStyle

INameSpaceTreeControl::Initialize