Callbacks GetDirectory()

Detailed Description

Callback functions on GetDirectory()

This functions becomes available during call of GetDirectory() from Kodi.

If GetDirectory() returns false becomes the parts from here used on next call of the function.

Example:

#include <kodi/addon-instance/VFS.h>
 
...
 
bool CMyVFS::GetDirectory(const kodi::addon::VFSUrl& url,
                          std::vector<kodi::vfs::CDirEntry>& items,
                          CVFSCallbacks callbacks)
{
  std::string neededString;
  callbacks.GetKeyboardInput("Test", neededString, true);
  if (neededString.empty())
    return false;
 
  // Do the work
  ...
  return true;
}

Function Documentation

GetKeyboardInput()

bool GetKeyboardInput ( const std::string & heading, std::string & input, bool hiddenInput = false )

inline

Require keyboard input.

Becomes called if GetDirectory() returns false and GetDirectory() becomes after entry called again.

Parameters

[in]	heading	The heading of the keyboard dialog
[out]	input	The resulting string. Returns string after second call!
[in]	hiddenInput	To show input only as "*" on dialog

Returns

True if input was received, false otherwise

SetErrorDialog()

void SetErrorDialog ( const std::string & heading, const std::string & line1, const std::string & line2 = "", const std::string & line3 = "" )

inline

Display an error dialog.

Parameters

[in]	heading	The heading of the error dialog
[in]	line1	The first line of the error dialog
[in]	line2	[opt] The second line of the error dialog
[in]	line3	[opt] The third line of the error dialog

RequireAuthentication()

void RequireAuthentication ( const std::string & url )

inline

Prompt the user for authentication of a URL.

Parameters

[in]

url

The URL