ToolBar.BandIndex Propriedade

  • Referência

Definição

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Obtém ou define o número de índice de faixa que indica a posição da barra de ferramentas na faixa.

public:
 property int BandIndex { int get(); void set(int value); };
public int BandIndex { get; set; }
member this.BandIndex : int with get, set
Public Property BandIndex As Integer

Valor da propriedade

Int32

A posição de uma barra de ferramentas na faixa de um ToolBarTray.

Exemplos

O exemplo a seguir mostra como usar essa propriedade para colocar ToolBar controles dentro de um ToolBarTray.

<ToolBarTray Background="White">
  <ToolBar Band="1" BandIndex="1">
    <Button>
      <Image Source="toolbargraphics\cut.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\copy.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\paste.bmp" />
    </Button>
  </ToolBar>
  <ToolBar Band="2" BandIndex="1">
    <Button>
      <Image Source="toolbargraphics\undo.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\redo.bmp" />
    </Button>
  </ToolBar>
  <ToolBar Band="2" BandIndex="2">
    <Button>
      <Image Source="toolbargraphics\paint.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\spell.bmp" />
    </Button>
    <Separator/>
    <Button>
      <Image Source="toolbargraphics\save.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\open.bmp" />
    </Button>
  </ToolBar>
</ToolBarTray>

Comentários

Se você não definir explicitamente essa propriedade, seu valor será determinado pela ordem em que o ToolBar é definido no ToolBarTray. Por exemplo, se você colocar duas barras de ferramentas em uma ToolBarTray sem definir as Band propriedades e BandIndex , o valor de Band será 0 para ambas as barras de ferramentas. O valor de será 0 para a primeira barra de BandIndex ferramentas e 1 para a segunda barra de ferramentas.

A posição do ToolBar em um ToolBarTray depende dos valores das ToolBarTray.Orientationpropriedades , Bande BandIndex . Quando Orientation é definido como Horizontal, uma banda representa uma linha no ToolBarTray. Quando Orientation é Vertical, uma banda representa uma coluna do ToolBarTray. A tabela a seguir descreve a relação entre Orientation, Bande BandIndex.

Orientação Banda Bandindex
Horizontal Indica a linha na qual o ToolBar está posicionado. As barras de ferramentas que definiram Band como um valor menor estão acima daquelas com um valor maior. Indica a posição do ToolBar no Band. As barras de ferramentas que definiram BandIndex como um valor menor ficam à esquerda daquelas com um valor maior.
Vertical Indica a coluna na qual o ToolBar está posicionado. As barras de ferramentas que definiram Band como um valor menor ficam à esquerda daquelas com um valor maior. Indica a posição do ToolBar no Band. As barras de ferramentas que definiram BandIndex como um valor menor estão acima daquelas com um valor maior.

Informações da propriedade de dependência
Campo Identificador BandIndexProperty
Propriedades de metadados definidas como true AffectsParentMeasure

Aplica-se a

Confira também