samp.directory
← Scripts et bibliothèques

Nickk888SAMP/Dialog-Pages

A library for SA-MP that allows you to create pages for dialogs

Bibliothèque★ 16mis à jour mars 2024Pas de licencePawnsampctl
Ouvrir sur GitHub

Ce dépôt n’a pas de fichier de licence. Il est public en lecture, mais cela ne donne pas à lui seul le droit de le réutiliser.

Installer avec sampctl

sampctl package install Nickk888SAMP/Dialog-Pages

Lance ceci dans le dossier de ton projet. sampctl télécharge le paquet et ce dont il dépend.

L’essayer dans le compilateur Pawn →

Ajoute ses fichiers include, avec les bibliothèques dont il dépend, au compilateur Pawn de ton navigateur, prêts à être inclus dans un script.

Dépend de 2 paquets

Utilisé par 1 paquet

README.md

Nickk's Dialog Pages

Nickk's Dialog Pages adds the possibility to create paged dialog lists.

It will basically calculate how many items will fit into one page and generate the Next button if there are too many. It will also add a Back button if you go to the second page etc. It will calculate the listitem in such way, like a normal list would work, so you don't need to make some calculation yourself, everything is automatic and it will return the correct listitem.

It is very easy to use, because everything is fully automatic.

Installation

Simply install to your project:

sampctl package install Nickk888SAMP/Dialog-Pages

Include in your code and begin using the library:

#include <ndialog-pages>

Functions

Adds an item to the dialog.

AddDialogListitem(playerid, const itemstring[]);

Adds an item to the dialog with arguments (requires y_va include to work), not necessary to format string.

AddDialogListitem(playerid, const itemstring[], va_args<>);

Resets the lister for the dialog.

ClearDialogListitems(playerid);

Shows the dialog

ShowPlayerDialogPages(playerid, const function[], style, const caption[], const button1[], const button2[], items_per_page, const nextbutton[] = "{FF0000}>>>", const backbutton[] = "{FF0000}<<<");

How to Use

To add items to a paged dialog, use the function "AddDialogListitem".

  • playerid - The player you want to add items to the dialog.
  • itemstring[] - The item as a string without \n

To show the paged dialog, use function "ShowPlayerDialogPages".

  • playerid - The player you want to show the dialog.
  • function[] - The name of the Dialog, must be the same as defined with "DialogPages:".
  • style - The style of the dialog.
  • caption[] - The caption of the dialog.
  • button1[] - The first button of the dialog.
  • button2[] - The second button of the dialog
  • items_per_page - The amount of items showed on a single page.
  • nextbutton[] - The "Next" button string. (Optional)
  • backbutton[] - The "Back" button string. (Optional)

If you want to clear the Items Cache, you can always use ClearDialogListitems(playerid), it's optional because it's always cleared when the first item has been added after a paged dialog has been showed to the player.

To get the response of the Dialog, create a new callback using "DialogPages:Name_Of_The_Dialog(playerid, response, listitem, inputtext[])".

  • playerid - The player who responded to the Dialog.
  • response - Did the player clicked Button1 or Button2.
  • listitem - The selected listitem of the dialog.
  • inputtext[] - The selected listitem's text as a string.

Example

CMD:ndptest(playerid) // Needs ZCMD
{
	new string[128];
	for(new i; i < 250; i++)
	{
		format(string, sizeof string, "{FFFFFF}List Item {FF00FF}%i", i);
		AddDialogListitem(playerid, string);
	}
	ShowPlayerDialogPages(playerid, "MyPagedDialog", DIALOG_STYLE_LIST, "{FFFFFF}Test Dialog Name {FF00FF}DialogName", "Button 1", "Button 2", 15);
	return 1;
}

DialogPages:MyPagedDialog(playerid, response, listitem, inputtext[])
{
	if(!response) return 1;
		
	new dstr[128];
	format(dstr, sizeof dstr, "[NDialog-Pages] You have selected listitem ID: {666666}%i{FFFFFF}, listitem's text: {666666}%s", listitem, inputtext);
	SendClientMessage(playerid, -1, dstr);
	return 1;
}

Example Script

Cette page est construite à partir de ce que GitHub publie sur le dépôt. samp.directory n’héberge pas le code. Signaler un problème avec cette fiche

Nickk888SAMP/Dialog-Pages : Bibliothèque SA-MP | samp.directory