Method TableSetupColumn

KBotExt/imgui/imgui_tables.cpp:1448–1513

See "COLUMN SIZING POLICIES" comments at the top of this file If (init_width_or_weight <= 0.0f) it is ignored

// See "COLUMN SIZING POLICIES" comments at the top of this file
// If (init_width_or_weight <= 0.0f) it is ignored
void ImGui::TableSetupColumn(const char* label, ImGuiTableColumnFlags flags, float init_width_or_weight, ImGuiID user_id)
{
	ImGuiContext& g = *GImGui;
	ImGuiTable* table = g.CurrentTable;
	IM_ASSERT(table != NULL && "Need to call TableSetupColumn() after BeginTable()!");
	IM_ASSERT(table->IsLayoutLocked == false && "Need to call call TableSetupColumn() before first row!");
	IM_ASSERT((flags & ImGuiTableColumnFlags_StatusMask_) == 0 && "Illegal to pass StatusMask values to TableSetupColumn()");
	if (table->DeclColumnsCount >= table->ColumnsCount)
	{
		IM_ASSERT_USER_ERROR(table->DeclColumnsCount < table->ColumnsCount, "Called TableSetupColumn() too many times!");
		return;
	}

	ImGuiTableColumn* column = &table->Columns[table->DeclColumnsCount];
	table->DeclColumnsCount++;

	// Assert when passing a width or weight if policy is entirely left to default, to avoid storing width into weight and vice-versa.
	// Give a grace to users of ImGuiTableFlags_ScrollX.
	if (table->IsDefaultSizingPolicy && (flags & ImGuiTableColumnFlags_WidthMask_) == 0 && (flags & ImGuiTableFlags_ScrollX) == 0)
		IM_ASSERT(init_width_or_weight <= 0.0f && "Can only specify width/weight if sizing policy is set explicitly in either Table or Column.");

	// When passing a width automatically enforce WidthFixed policy
	// (whereas TableSetupColumnFlags would default to WidthAuto if table is not Resizable)
	if ((flags & ImGuiTableColumnFlags_WidthMask_) == 0 && init_width_or_weight > 0.0f)
		if ((table->Flags & ImGuiTableFlags_SizingMask_) == ImGuiTableFlags_SizingFixedFit || (table->Flags & ImGuiTableFlags_SizingMask_) == ImGuiTableFlags_SizingFixedSame)
			flags |= ImGuiTableColumnFlags_WidthFixed;

	TableSetupColumnFlags(table, column, flags);
	column->UserID = user_id;
	flags = column->Flags;

	// Initialize defaults
	column->InitStretchWeightOrWidth = init_width_or_weight;
	if (table->IsInitializing)
	{
		// Init width or weight
		if (column->WidthRequest < 0.0f && column->StretchWeight < 0.0f)
		{
			if ((flags & ImGuiTableColumnFlags_WidthFixed) && init_width_or_weight > 0.0f)
				column->WidthRequest = init_width_or_weight;
			if (flags & ImGuiTableColumnFlags_WidthStretch)
				column->StretchWeight = (init_width_or_weight > 0.0f) ? init_width_or_weight : -1.0f;

			// Disable auto-fit if an explicit width/weight has been specified
			if (init_width_or_weight > 0.0f)
				column->AutoFitQueue = 0x00;
		}

		// Init default visibility/sort state
		if ((flags & ImGuiTableColumnFlags_DefaultHide) && (table->SettingsLoadedFlags & ImGuiTableFlags_Hideable) == 0)
			column->IsUserEnabled = column->IsUserEnabledNextFrame = false;
		if (flags & ImGuiTableColumnFlags_DefaultSort && (table->SettingsLoadedFlags & ImGuiTableFlags_Sortable) == 0)
		{
			column->SortOrder = 0; // Multiple columns using _DefaultSort will be reassigned unique SortOrder values when building the sort specs.
			column->SortDirection = (column->Flags & ImGuiTableColumnFlags_PreferSortDescending) ? (ImS8)ImGuiSortDirection_Descending : (ImU8)(ImGuiSortDirection_Ascending);
		}
	}