Set the defined autogroup, or create a new layer.
Parameters
----------
labelname: str
The passed string with the name of the group or layer.
References draftguitools.gui_groups.AddToGroup.groups, draftguitools.gui_groups.SetAutoGroup.groups, MaterialEditor.MaterialEditor.groups, Gui::AxisOrigin.labels, Gui::SoFCColorGradient.labels, ArchAxis._ViewProviderAxis.labels, ArchCommands._SurveyObserver.labels, draftguitools.gui_groups.AddToGroup.labels, draftguitools.gui_groups.SetAutoGroup.labels, ChildInfo.labels, Gui::Dialog::Clipping::Private.ui, Gui::Dialog::DemoMode.ui, Gui::Dialog::DlgCustomActionsImp.ui, Gui::Dialog::IconDialog.ui, Gui::Dialog::DlgActivateWindowImp.ui, Gui::Dialog::DlgAddProperty.ui, Gui::Dialog::DlgCheckableMessageBoxPrivate.ui, Gui::Dialog::DlgCustomCommandsImp.ui, Gui::Dialog::DlgCreateNewPreferencePackImp.ui, Gui::Dialog::DlgCustomizeSpNavSettings.ui, Gui::Dialog::DlgDisplayPropertiesImp::Private.ui, Gui::Dialog::DlgSettingsEditorImp.ui, Gui::Dialog::DlgExpressionInput.ui, Gui::Dialog::DlgGeneralImp.ui, Gui::Dialog::DlgInputDialogImp.ui, Gui::Dialog::DlgCustomKeyboardImp.ui, Gui::Dialog::DlgMacroExecuteImp.ui, Gui::Dialog::DlgMacroRecordImp.ui, Gui::Dialog::DlgMaterialPropertiesImp.ui, Gui::DlgObjectSelection.ui, Gui::Dialog::DlgOnlineHelpImp.ui, Gui::Dialog::DlgParameterFind.ui, Gui::Dialog::DlgParameterImp.ui, Gui::Dialog::DlgPreferencePackManagementImp.ui, Gui::Dialog::DlgPreferencesImp.ui, Gui::Dialog::DlgProjectInformationImp.ui, Gui::Dialog::DlgProjectUtility.ui, Gui::Dialog::DlgPropertyLink.ui, Gui::Dialog::DlgReportViewImp.ui, Gui::Dialog::DlgRevertToBackupConfigImp.ui, Gui::Dialog::DlgRunExternal.ui, Gui::Dialog::DlgSettings3DViewImp.ui, Gui::Dialog::DlgSettingsCacheDirectory.ui, Gui::Dialog::DlgSettingsColorGradientImp.ui, Gui::Dialog::DlgSettingsDocumentImp.ui, Gui::Dialog::DlgSettingsImageImp.ui, Gui::Dialog::DlgSettingsLazyLoadedImp.ui, Gui::Dialog::DlgSettingsMacroImp.ui, Gui::Dialog::DlgSettingsNavigation.ui, Gui::Dialog::DlgSettingsPythonConsole.ui, Gui::Dialog::DlgSettingsSelection.ui, Gui::Dialog::DlgSettingsUnitsImp.ui, Gui::Dialog::DlgSettingsViewColor.ui, Gui::Dialog::DlgCustomToolbars.ui, Gui::Dialog::DlgUnitsCalculator.ui, Gui::Dialog::DlgWorkbenchesImp.ui, Gui::Dialog::DocumentRecoveryPrivate.ui, Gui::Dialog::DownloadManager.ui, Gui::LocationDialogImp< Ui >.ui, Gui::LocationImpUi< Ui >.ui, Gui::LocationDialogUiImp.ui, Gui::Dialog::Placement.ui, Gui::Dialog::DlgInspector.ui, Gui::Dialog::AboutDialog.ui, Gui::TaskBoxPosition.ui, Gui::TaskBoxAngle.ui, Gui::ElementColors::Private.ui, Gui::TaskView::TaskAppearance.ui, Gui::TaskView::TaskSelectLinkProperty.ui, Gui::Dialog::TextureMapping.ui, Gui::Dialog::Transform.ui, Gui::VectorListEditor.ui, Gui::CheckListDialog.ui, change_branch.ChangeBranchDialog.ui, package_details.PackageDetails.ui, package_list.PackageList.ui, package_list.CompactView.ui, package_list.ExpandedView.ui, draftguitools.gui_base_original.DraftTool.ui, draftguitools.gui_circulararray.CircularArray.ui, draftguitools.gui_edit.Edit.ui, draftguitools.gui_groups.AddToGroup.ui, draftguitools.gui_groups.SetAutoGroup.ui, draftguitools.gui_orthoarray.OrthoArray.ui, draftguitools.gui_polararray.PolarArray.ui, draftguitools.gui_snapper.Snapper.ui, DrawingGui::TaskOrthoViews.ui, FemGui::DlgSettingsFemCcxImp.ui, FemGui::DlgSettingsFemElmerImp.ui, FemGui::DlgSettingsFemExportAbaqusImp.ui, FemGui::DlgSettingsFemGeneralImp.ui, FemGui::DlgSettingsFemGmshImp.ui, FemGui::DlgSettingsFemInOutVtkImp.ui, FemGui::DlgSettingsFemMaterialImp.ui, FemGui::DlgSettingsFemMystranImp.ui, FemGui::DlgSettingsFemZ88Imp.ui, FemGui::TaskAnalysisInfo.ui, FemGui::TaskCreateNodeSet.ui, FemGui::TaskDriver.ui, FemGui::TaskFemConstraintBearing.ui, FemGui::TaskFemConstraintContact.ui, FemGui::TaskFemConstraintDisplacement.ui, FemGui::TaskFemConstraintFixed.ui, FemGui::TaskFemConstraintFluidBoundary.ui, FemGui::TaskFemConstraintForce.ui, FemGui::TaskFemConstraintHeatflux.ui, FemGui::TaskFemConstraintInitialTemperature.ui, FemGui::TaskFemConstraintPlaneRotation.ui, FemGui::TaskFemConstraintPressure.ui, FemGui::TaskFemConstraintSpring.ui, FemGui::TaskFemConstraintTemperature.ui, FemGui::TaskFemConstraintTransform.ui, FemGui::TaskObjectName.ui, FemGui::TaskPostDisplay.ui, FemGui::TaskPostClip.ui, FemGui::TaskPostDataAlongLine.ui, FemGui::TaskPostDataAtPoint.ui, FemGui::TaskPostScalarClip.ui, FemGui::TaskPostWarpVector.ui, FemGui::TaskPostCut.ui, FemGui::TaskTetParameter.ui, FemGui::PlaneWidget.ui, FemGui::SphereWidget.ui, ImageGui::ImageOrientationDialog.ui, InspectionGui::VisualInspection.ui, MeshGui::DlgDecimating.ui, MeshGui::DlgEvaluateMeshImp::Private.ui, MeshGui::DlgEvaluateSettings.ui, MeshGui::DlgRegularSolidImp.ui, MeshGui::DlgSettingsImportExport.ui, MeshGui::DlgSettingsMeshView.ui, MeshGui::DlgSmoothing.ui, MeshGui::GmshWidget::Private.ui, MeshGui::RemoveComponents.ui, MeshGui::Segmentation.ui, MeshGui::SegmentationBestFit.ui, MeshGui::Selection.ui, MeshPartGui::CrossSections.ui, MeshPartGui::CurveOnMeshWidget.ui, MeshPartGui::Tessellation.ui, PartGui::CrossSections.ui, PartGui::DlgBooleanOperation.ui, PartGui::DlgExtrusion.ui, PartGui::DlgFilletEdges.ui, PartGui::DlgPartImportIgesImp.ui, PartGui::DlgPartImportStepImp.ui, PartGui::DlgPrimitives.ui, PartGui::Location.ui, PartGui::DlgProjectionOnSurface.ui, PartGui::DlgRevolution.ui, PartGui::DlgSettings3DViewPart.ui, PartGui::DlgSettingsGeneral.ui, PartGui::DlgImportExportIges.ui, PartGui::DlgImportExportStep.ui, PartGui::DlgSettingsObjectColor.ui, PartGui::Mirroring.ui, PartGui::SectionCut.ui, PartGui::ShapeFromMesh.ui, PartGui::TaskAttacher.ui, PartGui::FaceColors::Private.ui, PartGui::LoftWidget::Private.ui, PartGui::OffsetWidget::Private.ui, PartGui::ShapeBuilderWidget::Private.ui, PartGui::SweepWidget::Private.ui, PartGui::ThicknessWidget::Private.ui, Mod.PartDesign.FeatureHole.TaskHole.TaskHole.ui, PartDesignGui::DlgActiveBody.ui, PartDesignGui::TaskBooleanParameters.ui, PartDesignGui::TaskChamferParameters.ui, PartDesignGui::TaskDraftParameters.ui, PartDesignGui::TaskExtrudeParameters.ui, PartDesignGui::TaskFeaturePick.ui, PartDesignGui::TaskFilletParameters.ui, PartDesignGui::TaskHelixParameters.ui, PartDesignGui::TaskHoleParameters.ui, PartDesignGui::TaskLinearPatternParameters.ui, PartDesignGui::TaskLoftParameters.ui, PartDesignGui::TaskMirroredParameters.ui, PartDesignGui::TaskMultiTransformParameters.ui, PartDesignGui::TaskPipeParameters.ui, PartDesignGui::TaskPipeOrientation.ui, PartDesignGui::TaskPipeScaling.ui, PartDesignGui::TaskPolarPatternParameters.ui, PartDesignGui::TaskBoxPrimitives.ui, PartDesignGui::TaskRevolutionParameters.ui, PartDesignGui::TaskScaledParameters.ui, PartDesignGui::TaskShapeBinder.ui, PartDesignGui::TaskThicknessParameters.ui, PartDesignGui::TaskTransformedMessages.ui, PathGui::DlgProcessorChooser.ui, PathGui::DlgSettingsPathColor.ui, PathGui::TaskWidgetPathCompound.ui, PointsGui::DlgPointsReadImp.ui, RaytracingGui::DlgSettingsRayImp.ui, ReenGui::FitBSplineSurfaceWidget::Private.ui, ReenGui::PoissonWidget::Private.ui, ReverseEngineeringGui::Segmentation.ui, ReverseEngineeringGui::SegmentationManual.ui, RobotGui::TaskEdge2TracParameter.ui, RobotGui::TaskRobot6Axis.ui, RobotGui::TaskRobotControl.ui, RobotGui::TaskRobotMessages.ui, RobotGui::TaskTrajectory.ui, RobotGui::TaskTrajectoryDressUpParameter.ui, RobotGui::TrajectorySimulate.ui, SketcherGui::ConstraintMultiFilterDialog.ui, SketcherGui::ConstraintSettingsDialog.ui, SketcherGui::SketcherRegularPolygonDialog.ui, SketcherGui::SketcherSettings.ui, SketcherGui::SketcherSettingsDisplay.ui, SketcherGui::SketcherSettingsColors.ui, SketcherGui::SketchMirrorDialog.ui, SketcherGui::SketchOrientationDialog.ui, SketcherGui::SketchRectangularArrayDialog.ui, SketcherGui::TaskSketcherConstraints.ui, SketcherGui::TaskSketcherElements.ui, SketcherGui::SketcherGeneralWidget.ui, SketcherGui::TaskSketcherMessages.ui, SketcherGui::TaskSketcherSolverAdvanced.ui, SketcherGui::SketcherValidation.ui, SpreadsheetGui::DlgBindSheet.ui, SpreadsheetGui::DlgSettingsImp.ui, SpreadsheetGui::DlgSheetConf.ui, SpreadsheetGui::PropertiesDialog.ui, SpreadsheetGui::SheetView.ui, StartGui::DlgStartPreferencesImp.ui, SurfaceGui::FillingPanel.ui, SurfaceGui::FillingEdgePanel.ui, SurfaceGui::FillingVertexPanel.ui, SurfaceGui::GeomFillSurface.ui, SurfaceGui::SectionsPanel.ui, TechDrawGui::DlgPageChooser.ui, TechDrawGui::DlgPrefsTechDrawAdvancedImp.ui, TechDrawGui::DlgPrefsTechDrawAnnotationImp.ui, TechDrawGui::DlgPrefsTechDrawColorsImp.ui, TechDrawGui::DlgPrefsTechDrawDimensionsImp.ui, TechDrawGui::DlgPrefsTechDrawGeneralImp.ui, TechDrawGui::DlgPrefsTechDrawHLRImp.ui, TechDrawGui::DlgPrefsTechDrawScaleImp.ui, TechDrawGui::DlgTemplateField.ui, TechDrawGui::SymbolChooser.ui, TechDrawGui::TaskActiveView.ui, TechDrawGui::TaskAlignViews.ui, TechDrawGui::TaskBalloon.ui, TechDrawGui::TaskCenterLine.ui, TechDrawGui::TaskCosmeticLine.ui, TechDrawGui::TaskCosVertex.ui, TechDrawGui::TaskCustomizeFormat.ui, TechDrawGui::TaskDetail.ui, TechDrawGui::TaskDimension.ui, TechDrawGui::TaskGeomHatch.ui, TechDrawGui::TaskHatch.ui, TechDrawGui::TaskLeaderLine.ui, TechDrawGui::TaskLineDecor.ui, TechDrawGui::TaskRestoreLines.ui, TechDrawGui::TaskLinkDim.ui, TechDrawGui::TaskProjection.ui, TechDrawGui::TaskProjGroup.ui, TechDrawGui::TaskRichAnno.ui, TechDrawGui::TaskSectionView.ui, TechDrawGui::TaskSelectLineAttributes.ui, TechDrawGui::TaskWeldingSymbol.ui, TechDrawTools.CommandMoveView.CommandMoveView.ui, TechDrawTools.CommandShareView.CommandShareView.ui, TaskPanel.TaskPanel.ui, and TestGui::UnitTestDialog.ui.
Referenced by draftguitools.gui_split.Split.action(), draftguitools.gui_edit.Edit.Activated(), draftguitools.gui_pointarray.PointArray.Activated(), draftguitools.gui_move.Move.get_object_selection(), draftguitools.gui_rotate.Rotate.get_object_selection(), draftguitools.gui_scale.Scale.get_object_selection(), and draftguitools.gui_subelements.SubelementHighlight.get_selection().