Splitter.MinExtra Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia minimalną odległość, która musi pozostać między kontrolką podziału a krawędzią przeciwległej strony kontenera (lub najbliższą kontrolką zadokowaną po tej stronie). MinExtra został zastąpiony podobnymi właściwościami w systemie SplitContainer i jest udostępniany tylko pod kątem zgodności z poprzednimi wersjami.

public:
 property int MinExtra { int get(); void set(int value); };

public int MinExtra { get; set; }

member this.MinExtra : int with get, set

Public Property MinExtra As Integer

Wartość właściwości

Int32

Minimalna odległość w pikselach między kontrolką Splitter a krawędzią przeciwległej strony kontenera (lub najbliższą kontrolką zadokowaną po tej stronie). Wartość domyślna to 25.

Przykłady

Poniższy przykład kodu używa Splitter kontrolki w połączeniu z kontrolkami TreeView i , ListView aby utworzyć okno podobne do Eksploratora Windows. Aby zidentyfikować kontrolki TreeView i, ListView węzły i elementy są dodawane do obu kontrolek. W przykładzie użyto MinExtra właściwości i MinSize , Splitter aby uniemożliwić TreeView rozmiar lub ListView kontrolkę za małą lub zbyt dużą. Ten przykład wymaga, aby metoda utworzona w tym przykładzie została zdefiniowana w obiekcie Form i że metoda jest wywoływana z konstruktora klasy Form.

private:
   void CreateMySplitControls()
   {
      // Create TreeView, ListView, and Splitter controls.
      TreeView^ treeView1 = gcnew TreeView;
      ListView^ listView1 = gcnew ListView;
      Splitter^ splitter1 = gcnew Splitter;

      // Set the TreeView control to dock to the left side of the form.
      treeView1->Dock = DockStyle::Left;

      // Set the Splitter to dock to the left side of the TreeView control.
      splitter1->Dock = DockStyle::Left;

      // Set the minimum size the ListView control can be sized to.
      splitter1->MinExtra = 100;

      // Set the minimum size the TreeView control can be sized to.
      splitter1->MinSize = 75;

      // Set the ListView control to fill the remaining space on the form.
      listView1->Dock = DockStyle::Fill;

      // Add a TreeView and a ListView item to identify the controls on the form.
      treeView1->Nodes->Add( "TreeView Node" );
      listView1->Items->Add( "ListView Item" );

      // Add the controls in reverse order to the form to ensure proper location.
      array<Control^>^temp0 = {listView1,splitter1,treeView1};
      this->Controls->AddRange( temp0 );
   }

private void CreateMySplitControls()
{
    // Create TreeView, ListView, and Splitter controls.
    TreeView treeView1 = new TreeView();
    ListView listView1 = new ListView();
    Splitter splitter1 = new Splitter();

    // Set the TreeView control to dock to the left side of the form.
    treeView1.Dock = DockStyle.Left;
    // Set the Splitter to dock to the left side of the TreeView control.
    splitter1.Dock = DockStyle.Left;
    // Set the minimum size the ListView control can be sized to.
    splitter1.MinExtra = 100;
    // Set the minimum size the TreeView control can be sized to.
    splitter1.MinSize = 75;
    // Set the ListView control to fill the remaining space on the form.
    listView1.Dock = DockStyle.Fill;
    // Add a TreeView and a ListView item to identify the controls on the form.
    treeView1.Nodes.Add("TreeView Node");
    listView1.Items.Add("ListView Item");

    // Add the controls in reverse order to the form to ensure proper location.
    this.Controls.AddRange(new Control[]{listView1, splitter1, treeView1});
}

Private Sub CreateMySplitControls()
   ' Create TreeView, ListView, and Splitter controls.
   Dim treeView1 As New TreeView()
   Dim listView1 As New ListView()
   Dim splitter1 As New Splitter()
   
   ' Set the TreeView control to dock to the left side of the form.
   treeView1.Dock = DockStyle.Left
   ' Set the Splitter to dock to the left side of the TreeView control.
   splitter1.Dock = DockStyle.Left
   ' Set the minimum size the ListView control can be sized to.
      splitter1.MinExtra = 100
   ' Set the minimum size the TreeView control can be sized to.
      splitter1.MinSize = 75
   ' Set the ListView control to fill the remaining space on the form.
      listView1.Dock = DockStyle.Fill

      ' Add a TreeView and a ListView item to identify the controls on the form.
      treeView1.Nodes.Add("TreeView Node")
      listView1.Items.Add("ListView Item")
   
   ' Add the controls in reverse order to the form to ensure proper location.
   Me.Controls.AddRange(New Control() {listView1, splitter1, treeView1})
End Sub

Uwagi

W przypadku kontrolki poziomej Splitter (kontrolka Splitter zadokowana do góry lub dołu kontenera) minimalna wysokość obszaru kontenera zarezerwowanego dla oddokowanych kontrolek to ta wartość minus wysokość kontrolki Splitter . W przypadku kontrolki pionowej Splitter (kontrolka Splitter zadokowana po lewej lub prawej stronie kontenera) minimalna szerokość obszaru kontenera zarezerwowanego dla oddokowanych kontrolek to ta wartość minus szerokość Splitter kontrolki. Użytkownik nie może przenieść podziału poza limit określony przez tę właściwość.

Uwaga

MinExtra Jeśli właściwość jest ustawiona na wartość ujemną, wartość właściwości zostanie zresetowana do wartości 0.

Zobacz też

• MinSize