Eliminar el espacio vacío, si el encabezado de la sección está oculto en el UICollectionView

La documentación para collectionView:viewForSupplementaryElementOfKind:atIndexPath: establece:

Este método siempre debe devolver un objeto view válido. Si no desea una vista suplementaria en un caso particular, su objeto de presentación no debe crear los atributos para esa vista. Alternativamente, puede ocultar vistas estableciendo la propiedad oculta de los atributos correspondientes en SÍ o estableciendo la propiedad alfa de los atributos en 0. Para ocultar las vistas de encabezado y pie de página en un diseño de flujo, también puede establecer el ancho y la altura de esas vistas a 0.

Teniendo en cuenta que ya ha intentado establecer la altura a cero y configurar la vista para que se oculte, debe subclase UICollectionViewFlowLayout e implementar layoutAttributesForSupplementaryViewOfKind:atIndexPath:

Compruebe el indexPath (como ya lo hace) y devuelva nil si no desea ningún atributo de diseño para esa vista suplementaria específica.

- (UICollectionViewLayoutAttributes *)layoutAttributesForSupplementaryViewOfKind:(NSString *)kind atIndexPath:(NSIndexPath *)indexPath
{
    if([indexPath section] == 0)
    {
         return nil;
    }

    return [super layoutAttributesForSupplementaryViewOfKind:kind atIndexPath:indexPath];
}

La documentación dice claramente -

Valor devuelto

Un objeto de vista suplementario configurado. No debe devolver nil de este método.

Así que necesitas seguir -

Este método siempre debe devolver un objeto view válido. Si no desea una vista suplementaria en un caso particular, su objeto de presentación no debe crear los atributos para esa vista. Alternativamente, puede ocultar vistas configurando la propiedad oculta de la atributos correspondientes a SÍ o establecer la propiedad alfa de los atributos a 0. Para ocultar las vistas de encabezado y pie de página en un diseño de flujo, también puede establecer el ancho y el alto de esas vistas en 0.

Llegando a su código, el siguiente fragmento debería funcionar para usted:

- (UICollectionReusableView *)collectionView:(UICollectionView *)collectionView viewForSupplementaryElementOfKind:(NSString *)kind atIndexPath:(NSIndexPath *)indexPath
{
    UICollectionReusableView *sectionHeader = nil;
    if (kind == UICollectionElementKindSectionHeader) {
        sectionHeader = [collectionView dequeueReusableSupplementaryViewOfKind:kind withReuseIdentifier:@"EventSectionHeader" forIndexPath:indexPath];

        if(indexPath.section == 1)
          {
             sectionHeader.layer.borderWidth = .5f;
             sectionHeader.layer.borderColor = [UIColor colorWithRed:221.0 / 255.0 green:223.0 / 255.0 blue:220.0 / 255.0 alpha:1.0].CGColor;
          }
        else
        {
          sectionHeader.frame = CGRectZero;
          sectionHeader.hidden = YES;
        }
    }

    return sectionHeader;
}

Puede ocultar / mostrar su sección de encabezado reutilizable agregando UICollectionViewDelegateFlowLayout delegado y utilizando el código siguiente

- (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout referenceSizeForHeaderInSection:(NSInteger)section{
if (self.isForSearch) { //---> for hiding
    return CGSizeMake(0,0);
}
else{//---> for showing
    return ((UICollectionViewFlowLayout*)self.collectionChoosePlanView.collectionViewLayout).headerReferenceSize;
}
}

Para que puedas ocultarlo/mostrarlo