Aspose.Slides برای Xamarin

مقدمه

Xamarin یک چارچوب برای توسعهٔ موبایل در ‎.NET C# است. Xamarin ابزارها و کتابخانه‌هایی دارد که قابلیت‌های پلتفرم ‎.NET را گسترش می‌دهند. این چارچوب به توسعه‌دهندگان امکان می‌دهد برنامه‌هایی برای سیستم‌عامل Android بسازند.

برای توسعه در Xamarin، برنامه‌نویسان می‌توانند از محیط‌های توسعهٔ معمول خود (C#، Visual Studio و کتابخانه‌های شخص ثالث) استفاده کنند.

API Aspose.Slides بر روی پلتفرم Xamarin کار می‌کند. برای این منظور، بستهٔ ‎.NET Aspose.Slides یک ‎DLL جداگانه برای Xamarin اضافه می‌کند. Aspose.Slides برای Xamarin بیشترین ویژگی‌های موجود در نسخهٔ ‎.NET را پشتیبانی می‌کند:

تبدیل و مشاهدهٔ ارائه‌ها.
ویرایش محتواهای ارائه: متن، اشکال، نمودارها، SmartArt، صدا/تصویر، قلم‌ها و غیره.
کار با انیمیشن، افکت‌های دو‑بعدی، WordArt و غیره.
کار با فراداده‌ها و خصوصیات سند.
چاپ، کلونینگ، ادغام، مقایسه، تقسیم و غیره.

ما در بخشی دیگر نزدیک به انتهای این صفحه، مقایسهٔ کامل ویژگی‌ها را ارائه داده‌ایم.

در API Aspose.Slides برای Xamarin، کلاس‌ها، فضای‌نام‌ها، منطق و رفتار تا حد امکان مشابه نسخهٔ ‎.NET هستند. می‌توانید برنامه‌های ‎.NET Aspose.Slides خود را با هزینهٔ کم به Xamarin منتقل کنید.

مثال سریع

می‌توانید از Aspose.Slides برای Xamarin استفاده کنید تا برنامهٔ C# خود را از طریق Slides for Android بسازید و به کار ببرید.

ما یک مثال از برنامهٔ Android با Xamarin که از Aspose.Slides برای نمایش اسلایدهای ارائه استفاده می‌کند و با لمس، یک شکل جدید به اسلاید اضافه می‌کند، ارائه می‌دهیم. می‌توانید کد کامل این مثال‌ها را در GitHub پیدا کنید.

بیایید با ایجاد یک برنامهٔ Xamarin Android شروع کنیم:

todo:image_alt_text

ابتدا یک طرح محتوا می‌سازیم که شامل یک ImageView، دکمه‌های Prev و Next می‌شود:

todo:image_alt_text

XML - content_main.xml - ایجاد طرح محتوا

 <LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:orientation=    "vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:showIn="@layout/activity_main">
    <LinearLayout
        android:orientation="horizontal"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_weight="1"
        android:id="@+id/linearLayout1">
        <ImageView
            android:src="@android:drawable/ic_menu_gallery"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:id="@+id/imageView"
            android:scaleType="fitCenter" />
    </LinearLayout>

    <LinearLayout
        android:orientation="horizontal"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_weight="10"
        android:id="@+id/linearLayout2">
        <Button
            android:text="Prev"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:id="@+id/buttonPrev" />
        <Button
            android:text="Next"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:id="@+id/buttonNext"/>
    </LinearLayout>
</LinearLayout>

در اینجا، کتابخانهٔ “Aspose.Slides.Droid.dll” که شامل یک ارائهٔ نمونه (“HelloWorld.pptx”) است را به دارایی‌های برنامهٔ Xamarin اضافه می‌کنیم و مقداردهی اولیه آن را به MainActivity می‌افزاییم:

C# - MainActivity.cs - مقداردهی اولیه

[Activity(Label = "@string/app_name", Theme = "@style/AppTheme.NoActionBar", MainLauncher = true)]
public class MainActivity : AppCompatActivity
{
    private Aspose.Slides.Presentation presentation;

    protected override void OnCreate(Bundle savedInstanceState)
    {
        base.OnCreate(savedInstanceState);
        SetContentView(Resource.Layout.activity_main);
    }

    protected override void OnResume()
    {
        if (presentation == null)
        {
            using (Stream input = Assets.Open("HelloWorld.pptx"))
            {
                presentation = new Aspose.Slides.Presentation(input);
            }
        }
    }

    protected override void OnPause()
    {
        if (presentation != null)
        {
            presentation.Dispose();
            presentation = null;
        }
    }
}

بیایید تابعی برای نمایش اسلایدهای Prev و Next هنگام لمس دکمه‌ها اضافه کنیم:

C# - MainActivity.cs - نمایش اسلایدها با کلیک دکمه‌های Prev و Next

[Activity(Label = "@string/app_name", Theme = "@style/AppTheme.NoActionBar", MainLauncher = true)]
public class MainActivity : AppCompatActivity
{
    private Button buttonNext;
    private Button buttonPrev;
    ImageView imageView;

    private Aspose.Slides.Presentation presentation;

    private int currentSlideNumber;

    protected override void OnCreate(Bundle savedInstanceState)
    {
        base.OnCreate(savedInstanceState);
        SetContentView(Resource.Layout.activity_main);
    }

    protected override void OnResume()
    {
        base.OnResume();
        LoadPresentation();
        currentSlideNumber = 0;
        if (buttonNext == null)
        {
            buttonNext = FindViewById<Button>(Resource.Id.buttonNext);
        }

        if (buttonPrev == null)
        {
            buttonPrev = FindViewById<Button>(Resource.Id.buttonPrev);
        }

        if(imageView == null)
        {
            imageView= FindViewById<ImageView>(Resource.Id.imageView);
        }

        buttonNext.Click += ButtonNext_Click;
        buttonPrev.Click += ButtonPrev_Click;
        RefreshButtonsStatus();
        ShowSlide(currentSlideNumber);
    }

    private void ButtonNext_Click(object sender, System.EventArgs e)
    {
        if (currentSlideNumber > (presentation.Slides.Count - 1))
        {
            return;
        }

        ShowSlide(++currentSlideNumber);
        RefreshButtonsStatus();
    }

    private void ButtonPrev_Click(object sender, System.EventArgs e)
    {
        if (currentSlideNumber == 0)
        {
            return;
        }

        ShowSlide(--currentSlideNumber);
        RefreshButtonsStatus();
    }

    protected override void OnPause()
    {
        base.OnPause();
        if (buttonNext != null)
        {
            buttonNext.Dispose();
            buttonNext = null;
        }

        if (buttonPrev != null)
        {
            buttonPrev.Dispose();
            buttonPrev = null;
        }

        if(imageView != null)
        {
            imageView.Dispose();
            imageView = null;
        }

        DisposePresentation();
    }

    private void RefreshButtonsStatus()
    {
        buttonNext.Enabled = currentSlideNumber < (presentation.Slides.Count - 1);
        buttonPrev.Enabled = currentSlideNumber > 0;
    }

    private void ShowSlide(int slideNumber)
    {
        Aspose.Slides.Drawing.Xamarin.Size size = presentation.SlideSize.Size.ToSize();
        Aspose.Slides.Drawing.Xamarin.Bitmap bitmap = presentation.Slides[slideNumber].GetThumbnail(size);
        imageView.SetImageBitmap(bitmap.ToNativeBitmap());
    }

    private void LoadPresentation()
    {
        if(presentation != null)
        {
            return;
        }

        using (Stream input = Assets.Open("HelloWorld.pptx"))
        {
            presentation = new Aspose.Slides.Presentation(input);
        }
    }

    private void DisposePresentation()
    {
        if(presentation == null)
        {
            return;
        }
        
        presentation.Dispose();
        presentation = null;
    }

}

در پایان، تابعی برای افزودن یک شکل بیضی به هنگام لمس اسلاید پیاده‌سازی می‌کنیم:

C# - MainActivity.cs - افزودن بیضی با کلیک اسلاید

 private void ImageView_Touch(object sender, Android.Views.View.TouchEventArgs e)
{
    int[] location = new int[2];
    imageView.GetLocationOnScreen(location);
    int x = (int)e.Event.GetX();
    int y = (int)e.Event.GetY();
    int posX = x - location[0];
    int posY = y - location[0];
    
    Aspose.Slides.Drawing.Xamarin.Size presSize = presentation.SlideSize.Size.ToSize();

    float coeffX = (float)presSize.Width / imageView.Width;
    float coeffY = (float)presSize.Height / imageView.Height;
    int presPosX = (int)(posX * coeffX);
    int presPosY = (int)(posY * coeffY);
    int width = presSize.Width / 50;

    int height = width;
    Aspose.Slides.IAutoShape ellipse = presentation.Slides[currentSlideNumber].Shapes.AddAutoShape(Aspose.Slides.ShapeType.Ellipse, presPosX, presPosY, width, height);
    ellipse.FillFormat.FillType = Aspose.Slides.FillType.Solid;

    Random random = new Random();
    Aspose.Slides.Drawing.Xamarin.Color slidesColor = Aspose.Slides.Drawing.Xamarin.Color.FromArgb(random.Next(256), random.Next(256), random.Next(256));
    ellipse.FillFormat.SolidFillColor.Color = slidesColor;
    ShowSlide(currentSlideNumber);
}

هر کلیک بر روی اسلاید ارائه، یک بیضی با رنگ تصادفی اضافه می‌کند:

todo:image_alt_text

ویژگی‌های پشتیبانی‌شده

ویژگی‌ها	Aspose.Slides برای ‎.NET	Aspose.Slides برای Xamarin
ویژگی‌های ارائه
ایجاد ارائه‌های جدید
قالب‌های PowerPoint 97 - 2003 باز/ذخیره
قالب‌های PowerPoint 2007 باز/ذخیره
پشتیبانی از افزونه‌های PowerPoint 2010
پشتیبانی از افزونه‌های PowerPoint 2013
پشتیبانی از ویژگی‌های PowerPoint 2016	محدود	محدود
پشتیبانی از ویژگی‌های PowerPoint 2019	محدود	محدود
تبدیل PPT به PPTX
تبدیل PPTX به PPT
PPTX در PPT	محدود	محدود
پردازش تم‌ها
پردازش ماکروها
پردازش خصوصیات سند
حفاظت با رمز عبور
استخراج سریع متن
جاسازی قلم‌ها
رندر کردن نظرات
وقفهٔ وظایف طولانی‌مدت
قالب‌های خروجی:
PDF
XPS
HTML
TIFF
ODP	محدود	محدود
SWF	محدود	محدود
SVG
قالب‌های ورودی:
HTML	محدود	محدود
ODP
THMX
ویژگی‌های اسلایدهای اصلی:
دسترسی به تمام اسلایدهای اصلی موجود
ایجاد/حذف اسلایدهای اصلی
کلونینگ اسلایدهای اصلی
ویژگی‌های اسلایدهای چیدمان:
دسترسی به تمام اسلایدهای چیدمان موجود
ایجاد/حذف اسلایدهای چیدمان
کلونینگ اسلایدهای چیدمان
ویژگی‌های اسلاید:
دسترسی به تمام اسلایدهای موجود
ایجاد/حذف اسلاید
کلونینگ اسلاید
خروجی اسلایدها به تصویر
ایجاد/ویرایش/حذف بخش‌های اسلاید
ویژگی‌های اسلایدهای یادداشت:
دسترسی به تمام اسلایدهای یادداشت موجود
ویژگی‌های شکل:
دسترسی به تمام اشکال اسلاید
اضافه کردن اشکال جدید
کلونینگ اشکال
خروجی اشکال جداگانه به تصویر
انواع شکل‌های پشتیبانی‌شده:
تمام انواع شکل‌های از پیش تعریف‌شده
قاب‌های تصویر
جداول
نمودارها
SmartArt
نقشه‌خوانی قدیمی
WordArt
OLE، اشیاء ActiveX	محدود	محدود
قاب‌های ویدئویی
قاب‌های صوتی
اتصال‌ها
ویژگی‌های گروه‌اشکال:
دسترسی به گروه‌اشکال
ایجاد گروه‌اشکال
لغو گروه‌سازی اشکال موجود
ویژگی‌های افکت‌های شکل:
افکت‌های 2D	محدود	محدود
افکت‌های 3D
ویژگی‌های متن:
قالب‌بندی پاراگراف‌ها
قالب‌بندی قسمت‌ها
ویژگی‌های انیمیشن:
خروجی انیمیشن به SWF
خروجی انیمیشن به HTML

چگونه Aspose.Slides را در Docker اجرا کنیم امنیت