fileview.hxx

Go to the documentation of this file.

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 */
#pragma once
 
#include <memory>
#include <com/sun/star/uno/Sequence.h>
#include <utility>
#include <vcl/weld.hxx>
#include <rtl/ustring.hxx>
 
namespace com :: sun :: star :: ucb { class XContent; }
 
// class SvtFileView -----------------------------------------------------
 
class SvtFileView_Impl;
struct SvtContentEntry;
 
enum FileViewResult
{
    eSuccess,
    eFailure,
    eTimeout,
    eStillRunning
};
 
enum FileViewMode
{
    eDetailedList,
    eIcon
};
 
struct FileViewAsyncAction
{
    sal_uInt32  nMinTimeout;    
    sal_uInt32  nMaxTimeout;    
    Link<void*,void>  aFinishHandler; 
 
    FileViewAsyncAction() : nMinTimeout(0), nMaxTimeout (0)
    {
    }
};
 
class SvtFileView
{
private:
    std::unique_ptr<SvtFileView_Impl> mpImpl;
    css::uno::Sequence<OUString> maDenyList;
 
    DECL_LINK(HeaderSelect_Impl, int, void);
 
public:
    SvtFileView(weld::Window* pTopLevel,
                std::unique_ptr<weld::TreeView> xTreeView,
                std::unique_ptr<weld::IconView> xIconView,
                bool bOnlyFolder, bool bMultiSelection, bool bShowType = true);
    ~SvtFileView();
 
    void                    SetViewMode( FileViewMode eMode );
 
    const OUString&         GetViewURL() const;
    OUString                GetURL(const weld::TreeIter& rEntry) const;
    OUString                GetCurrentURL() const;
 
    bool                    GetParentURL( OUString& _rParentURL ) const;
    void                    CreatedFolder( const OUString& rUrl, const OUString& rNewFolder );
 
    void                    set_help_id(const OUString& rHelpId);
    OUString                get_help_id() const;
 
    void                    grab_focus();
    bool                    has_focus() const;
 
    OUString                get_selected_text() const;
 
    weld::Widget*           identifier() const; // just to uniquely identify this widget
 
    FileViewResult          Initialize(
                                const OUString& rFolderURL,
                                const OUString& rFilter,
                                const FileViewAsyncAction* pAsyncDescriptor,
                                const css::uno::Sequence< OUString >& rDenyList
                            );
 
    FileViewResult          ExecuteFilter(
                                const OUString& rFilter,
                                const FileViewAsyncAction* pAsyncDescriptor
                            );
 
    void                    CancelRunningAsyncAction();
 
    FileViewResult          PreviousLevel(
                                const FileViewAsyncAction* pAsyncDescriptor
                            );
 
    void                    SetNoSelection();
 
    void                    SetSelectHdl( const Link<SvtFileView*,void>& rHdl );
    void                    SetDoubleClickHdl( const Link<SvtFileView*,bool>& rHdl );
    void                    SetOpenDoneHdl( const Link<SvtFileView*,void>& rHdl );
 
    sal_uInt32              GetSelectionCount() const;
    SvtContentEntry*        FirstSelected() const;
 
    void selected_foreach(const std::function<bool(weld::TreeIter&)>& func);
 
    void                    EnableDelete( bool bEnable );
 
                            // save and load column size and sort order
    OUString                GetConfigString() const;
    void                    SetConfigString( std::u16string_view rCfgStr );
 
    void                    EndInplaceEditing();
 
    ::std::vector< SvtContentEntry > GetContent();
};
 
// struct SvtContentEntry ------------------------------------------------
 
struct SvtContentEntry
{
    bool     mbIsFolder;
    OUString maURL;
 
    SvtContentEntry( OUString aURL, bool bIsFolder ) :
        mbIsFolder( bIsFolder ), maURL(std::move( aURL )) {}
};
 
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */